Merge branch 'merge/notifications-modules' into master

Trae notifications-realtime + modules + MCP tokens al master preservando files attachments (issue 0128). Migrations renumeradas: 014_card_files (master), 015_notifications, 016_modules, 017_mcp_tokens (notif renumerada). Bump version 0.2.0 -> 0.5.0.
2026-05-27 18:50:44 +02:00
parent 5b30fb1ded abb787facd
commit 084defe014
42 changed files with 6209 additions and 1420 deletions
@@ -2,8 +2,8 @@
 name: kanban
 lang: go
 domain: tools
-version: 0.2.0
-description: "Kanban board con persistencia SQLite, drag-and-drop entre columnas (dnd-kit), tracking del tiempo por columna y adjuntos de archivos por card (drag&drop en descripcion y chat). Frontend Vite + React + Mantine v9 embebido en el binario Go."
+version: 0.5.0
+description: "Kanban board con persistencia SQLite, drag-and-drop entre columnas (dnd-kit), tracking del tiempo por columna, adjuntos de archivos por card, notificaciones realtime (SSE) y modulos externos (Jira). Frontend Vite + React + Mantine v9 embebido en el binario Go. Endpoint MCP Streamable HTTP en /mcp."
 tags: [service, kanban, web, dnd-kit, mantine, sqlite, time-tracking]
 uses_functions:
  - random_hex_id_go_core
@@ -38,6 +38,7 @@ uses_functions:
  - fetch_json_ts_infra
  - claude_stream_go_core
  - mcp_server_stdio_go_infra
+  - mcp_server_http_go_infra
  - ws_upgrader_go_infra
 uses_types:
  - DurationStats_go_datascience
@@ -192,3 +193,6 @@ Una linea por bump SemVer. Bump-type segun `.claude/commands/version.md`:

 - v0.1.0 (2026-05-18) — baseline.
 - v0.2.0 (2026-05-27) — adjuntos de archivos por card (issue 0128): tabla `card_files` con soft-delete, endpoints REST (`POST/GET/DELETE /api/cards/{id}/files`, `GET/DELETE /api/files/{id}`), tres vias de upload (drag&drop en descripcion y chat, boton en tab Archivos), render inline de imagenes via `MessageBody`. Limite 10 MB.
+- v0.3.1 (2026-05-21) — patch: debounce board.invalidated (300ms trailing) + autoClose 4s en toasts de notification.created. Fix de blow-up de memoria en navegador por ráfagas de SSE.
+- v0.4.0 (2026-05-22) — minor: endpoint MCP Streamable HTTP `/mcp` con per-user bearer tokens (tabla `mcp_tokens`, migration 017). Modal "MCP tokens" en avatar menu para generar/listar/revocar. Vite proxy enruta `/mcp` a WSL. Usa nueva funcion `mcp_server_http_go_infra`. Doc en `docs/MCP.md`.
+- v0.5.0 (2026-05-27) — minor: merge ramas notifications-realtime + modules con master post-files. Trae notificaciones SSE (tabla `notifications`, migration 015), modulos externos para sincronizacion bidireccional (Jira, etc., tabla `modules`, migration 016), tokens MCP per-user (migration 017). Conserva files attachments del 0128. Renumeradas migrations notif 014/015/016 -> 015/016/017.
@@ -4,7 +4,7 @@
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Kanban</title>
-    <script type="module" crossorigin src="/assets/index-DT3pghXY.js"></script>
+    <script type="module" crossorigin src="/assets/index-DFLRkdHe.js"></script>
    <link rel="stylesheet" crossorigin href="/assets/index-b0xjFtx2.css">
  </head>
  <body>
@@ -0,0 +1,158 @@
+package main
+
+import (
+	"encoding/json"
+	"sync"
+	"sync/atomic"
+	"time"
+)
+
+// EventHub is an in-process pub/sub used to push board mutations and
+// notifications to connected clients (SSE for board-wide events, WS for
+// per-card chat). Drop policy on slow consumers: best-effort send; if a
+// subscriber's buffered channel is full the event is dropped and the
+// hub increments dropCount. Clients are expected to reconcile state via
+// a full reload when reconnecting.
+type EventHub struct {
+	mu        sync.RWMutex
+	userSubs  map[string]map[chan Event]struct{}
+	cardSubs  map[string]map[chan Event]struct{}
+	dropCount uint64
+}
+
+// Event is the envelope broadcast to subscribers.
+//
+//	Type    — discriminator (e.g. "card.updated", "message.created").
+//	CardID  — set when payload pertains to a specific card.
+//	UserID  — set for per-user private events (e.g. notifications). Empty
+//	          means broadcast to every user subscriber.
+//	Payload — arbitrary JSON describing the change.
+//	TS      — RFC3339 timestamp.
+type Event struct {
+	Type    string          `json:"type"`
+	CardID  string          `json:"card_id,omitempty"`
+	UserID  string          `json:"user_id,omitempty"`
+	Payload json.RawMessage `json:"payload,omitempty"`
+	TS      string          `json:"ts"`
+}
+
+const eventBufSize = 64
+
+func NewEventHub() *EventHub {
+	return &EventHub{
+		userSubs: map[string]map[chan Event]struct{}{},
+		cardSubs: map[string]map[chan Event]struct{}{},
+	}
+}
+
+// SubscribeUser returns a channel that receives every public event plus
+// private events targeted at userID. Caller MUST eventually call
+// UnsubscribeUser to release resources.
+func (h *EventHub) SubscribeUser(userID string) chan Event {
+	ch := make(chan Event, eventBufSize)
+	h.mu.Lock()
+	set, ok := h.userSubs[userID]
+	if !ok {
+		set = map[chan Event]struct{}{}
+		h.userSubs[userID] = set
+	}
+	set[ch] = struct{}{}
+	h.mu.Unlock()
+	return ch
+}
+
+func (h *EventHub) UnsubscribeUser(userID string, ch chan Event) {
+	h.mu.Lock()
+	if set, ok := h.userSubs[userID]; ok {
+		delete(set, ch)
+		if len(set) == 0 {
+			delete(h.userSubs, userID)
+		}
+	}
+	h.mu.Unlock()
+	close(ch)
+}
+
+// SubscribeCard returns a channel that receives events scoped to cardID
+// (chat messages + typing indicators).
+func (h *EventHub) SubscribeCard(cardID string) chan Event {
+	ch := make(chan Event, eventBufSize)
+	h.mu.Lock()
+	set, ok := h.cardSubs[cardID]
+	if !ok {
+		set = map[chan Event]struct{}{}
+		h.cardSubs[cardID] = set
+	}
+	set[ch] = struct{}{}
+	h.mu.Unlock()
+	return ch
+}
+
+func (h *EventHub) UnsubscribeCard(cardID string, ch chan Event) {
+	h.mu.Lock()
+	if set, ok := h.cardSubs[cardID]; ok {
+		delete(set, ch)
+		if len(set) == 0 {
+			delete(h.cardSubs, cardID)
+		}
+	}
+	h.mu.Unlock()
+	close(ch)
+}
+
+// Publish delivers ev to every matching subscriber. If ev.UserID is set
+// it is delivered ONLY to that user's subscribers; otherwise it fans out
+// to all user subscribers. Card subscribers ALWAYS receive events that
+// match ev.CardID. Best-effort: full channels are skipped.
+func (h *EventHub) Publish(ev Event) {
+	if ev.TS == "" {
+		ev.TS = time.Now().UTC().Format(time.RFC3339)
+	}
+	h.mu.RLock()
+	defer h.mu.RUnlock()
+
+	deliver := func(ch chan Event) {
+		select {
+		case ch <- ev:
+		default:
+			atomic.AddUint64(&h.dropCount, 1)
+		}
+	}
+
+	if ev.UserID != "" {
+		if set, ok := h.userSubs[ev.UserID]; ok {
+			for ch := range set {
+				deliver(ch)
+			}
+		}
+	} else {
+		for _, set := range h.userSubs {
+			for ch := range set {
+				deliver(ch)
+			}
+		}
+	}
+	if ev.CardID != "" {
+		if set, ok := h.cardSubs[ev.CardID]; ok {
+			for ch := range set {
+				deliver(ch)
+			}
+		}
+	}
+}
+
+func (h *EventHub) DropCount() uint64 {
+	return atomic.LoadUint64(&h.dropCount)
+}
+
+// PublishJSON marshals payload and publishes a single Event.
+func (h *EventHub) PublishJSON(typ, cardID, userID string, payload interface{}) {
+	var raw json.RawMessage
+	if payload != nil {
+		b, err := json.Marshal(payload)
+		if err == nil {
+			raw = b
+		}
+	}
+	h.Publish(Event{Type: typ, CardID: cardID, UserID: userID, Payload: raw})
+}
@@ -0,0 +1,146 @@
+package main
+
+import (
+	"sync"
+	"sync/atomic"
+	"testing"
+	"time"
+)
+
+func TestEventHub_BroadcastToAllUsers(t *testing.T) {
+	hub := NewEventHub()
+	chA := hub.SubscribeUser("alice")
+	chB := hub.SubscribeUser("bob")
+	defer hub.UnsubscribeUser("alice", chA)
+	defer hub.UnsubscribeUser("bob", chB)
+
+	hub.PublishJSON("card.updated", "c1", "", map[string]string{"id": "c1"})
+
+	for _, ch := range []chan Event{chA, chB} {
+		select {
+		case ev := <-ch:
+			if ev.Type != "card.updated" {
+				t.Fatalf("type = %q, want card.updated", ev.Type)
+			}
+		case <-time.After(time.Second):
+			t.Fatal("timeout waiting for event")
+		}
+	}
+}
+
+func TestEventHub_PrivateUserEvent(t *testing.T) {
+	hub := NewEventHub()
+	chA := hub.SubscribeUser("alice")
+	chB := hub.SubscribeUser("bob")
+	defer hub.UnsubscribeUser("alice", chA)
+	defer hub.UnsubscribeUser("bob", chB)
+
+	hub.PublishJSON("notification.created", "", "alice", map[string]string{"foo": "bar"})
+
+	select {
+	case ev := <-chA:
+		if ev.UserID != "alice" {
+			t.Fatalf("user_id = %q, want alice", ev.UserID)
+		}
+	case <-time.After(time.Second):
+		t.Fatal("alice did not get private event")
+	}
+
+	select {
+	case ev := <-chB:
+		t.Fatalf("bob received private event for alice: %+v", ev)
+	case <-time.After(100 * time.Millisecond):
+		// expected
+	}
+}
+
+func TestEventHub_CardSubscription(t *testing.T) {
+	hub := NewEventHub()
+	ch := hub.SubscribeCard("card-1")
+	defer hub.UnsubscribeCard("card-1", ch)
+
+	hub.PublishJSON("message.created", "card-1", "", map[string]string{"id": "m1"})
+	hub.PublishJSON("message.created", "card-2", "", map[string]string{"id": "m2"})
+
+	select {
+	case ev := <-ch:
+		if ev.CardID != "card-1" {
+			t.Fatalf("card_id = %q, want card-1", ev.CardID)
+		}
+	case <-time.After(time.Second):
+		t.Fatal("timeout")
+	}
+	select {
+	case ev := <-ch:
+		t.Fatalf("received unexpected event for other card: %+v", ev)
+	case <-time.After(100 * time.Millisecond):
+	}
+}
+
+func TestEventHub_DropPolicyOnSlowConsumer(t *testing.T) {
+	hub := NewEventHub()
+	ch := hub.SubscribeUser("slow")
+	defer hub.UnsubscribeUser("slow", ch)
+
+	// Fill the buffer + N extra to force drops.
+	const extra = 50
+	for i := 0; i < eventBufSize+extra; i++ {
+		hub.PublishJSON("noise", "", "slow", nil)
+	}
+	if got := hub.DropCount(); got < extra {
+		t.Fatalf("DropCount = %d, want >= %d", got, extra)
+	}
+}
+
+func TestEventHub_UnsubscribeRemoves(t *testing.T) {
+	hub := NewEventHub()
+	ch := hub.SubscribeUser("alice")
+	hub.UnsubscribeUser("alice", ch)
+	// channel must be closed
+	select {
+	case _, ok := <-ch:
+		if ok {
+			t.Fatal("expected closed channel")
+		}
+	default:
+		// channel could be drained-and-closed
+	}
+	// Publish should not panic and should not deliver anywhere.
+	hub.PublishJSON("noise", "", "alice", nil)
+}
+
+func TestEventHub_ConcurrentPublishers(t *testing.T) {
+	hub := NewEventHub()
+	ch := hub.SubscribeUser("u")
+	defer hub.UnsubscribeUser("u", ch)
+
+	var received atomic.Uint64
+	done := make(chan struct{})
+	go func() {
+		for range ch {
+			received.Add(1)
+		}
+		close(done)
+	}()
+
+	var wg sync.WaitGroup
+	const writers = 10
+	const each = 100
+	for i := 0; i < writers; i++ {
+		wg.Add(1)
+		go func() {
+			defer wg.Done()
+			for j := 0; j < each; j++ {
+				hub.PublishJSON("ping", "", "u", nil)
+			}
+		}()
+	}
+	wg.Wait()
+	// Give the consumer time to drain.
+	time.Sleep(200 * time.Millisecond)
+	got := received.Load()
+	dropped := hub.DropCount()
+	if got+dropped < writers*each {
+		t.Fatalf("received=%d drop=%d want sum >= %d", got, dropped, writers*each)
+	}
+}
@@ -2,20 +2,31 @@ module kanban

 go 1.25.0

-require fn-registry v0.0.0-00010101000000-000000000000
+require (
+	fn-registry v0.0.0-00010101000000-000000000000
+	github.com/mattn/go-sqlite3 v1.14.44
+	golang.org/x/crypto v0.51.0
+	nhooyr.io/websocket v1.8.17
+)

 require (
+	filippo.io/edwards25519 v1.2.0 // indirect
 	github.com/ClickHouse/ch-go v0.71.0 // indirect
 	github.com/ClickHouse/clickhouse-go/v2 v2.44.0 // indirect
 	github.com/andybalholm/brotli v1.2.0 // indirect
 	github.com/apache/arrow-go/v18 v18.1.0 // indirect
+	github.com/aymerick/douceur v0.2.0 // indirect
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
+	github.com/danieljoos/wincred v1.2.3 // indirect
+	github.com/fsnotify/fsnotify v1.7.0 // indirect
 	github.com/go-faster/city v1.0.1 // indirect
 	github.com/go-faster/errors v0.7.1 // indirect
 	github.com/go-viper/mapstructure/v2 v2.2.1 // indirect
 	github.com/goccy/go-json v0.10.5 // indirect
+	github.com/godbus/dbus/v5 v5.2.2 // indirect
 	github.com/google/flatbuffers v25.1.24+incompatible // indirect
 	github.com/google/uuid v1.6.0 // indirect
+	github.com/gorilla/css v1.0.1 // indirect
 	github.com/jackc/pgpassfile v1.0.0 // indirect
 	github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
 	github.com/jackc/pgx/v5 v5.9.1 // indirect
@@ -23,27 +34,38 @@ require (
 	github.com/klauspost/compress v1.18.3 // indirect
 	github.com/klauspost/cpuid/v2 v2.2.9 // indirect
 	github.com/marcboeker/go-duckdb v1.8.5 // indirect
-	github.com/mattn/go-sqlite3 v1.14.37 // indirect
+	github.com/mattn/go-colorable v0.1.14 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/microcosm-cc/bluemonday v1.0.27 // indirect
 	github.com/paulmach/orb v0.12.0 // indirect
+	github.com/petermattis/goid v0.0.0-20260330135022-df67b199bc81 // indirect
 	github.com/pierrec/lz4/v4 v4.1.25 // indirect
+	github.com/rs/zerolog v1.35.1 // indirect
 	github.com/segmentio/asm v1.2.1 // indirect
 	github.com/shopspring/decimal v1.4.0 // indirect
+	github.com/skip2/go-qrcode v0.0.0-20200617195104-da1b6568686e // indirect
+	github.com/tidwall/gjson v1.19.0 // indirect
+	github.com/tidwall/match v1.1.1 // indirect
+	github.com/tidwall/pretty v1.2.1 // indirect
+	github.com/tidwall/sjson v1.2.5 // indirect
+	github.com/yuin/goldmark v1.8.2 // indirect
+	github.com/zalando/go-keyring v0.2.8 // indirect
 	github.com/zeebo/xxh3 v1.0.2 // indirect
+	go.mau.fi/util v0.9.9 // indirect
 	go.opentelemetry.io/otel v1.41.0 // indirect
 	go.opentelemetry.io/otel/trace v1.41.0 // indirect
 	go.yaml.in/yaml/v3 v3.0.4 // indirect
-	golang.org/x/crypto v0.50.0 // indirect
-	golang.org/x/exp v0.0.0-20250128182459-e0ece0dbea4c // indirect
-	golang.org/x/mod v0.34.0 // indirect
-	golang.org/x/net v0.53.0 // indirect
+	golang.org/x/exp v0.0.0-20260508232706-74f9aab9d74a // indirect
+	golang.org/x/mod v0.36.0 // indirect
+	golang.org/x/net v0.54.0 // indirect
 	golang.org/x/sync v0.20.0 // indirect
-	golang.org/x/sys v0.43.0 // indirect
-	golang.org/x/telemetry v0.0.0-20260311193753-579e4da9a98c // indirect
-	golang.org/x/text v0.36.0 // indirect
-	golang.org/x/tools v0.43.0 // indirect
+	golang.org/x/sys v0.44.0 // indirect
+	golang.org/x/telemetry v0.0.0-20260508192327-42602be52be6 // indirect
+	golang.org/x/text v0.37.0 // indirect
+	golang.org/x/tools v0.45.0 // indirect
 	golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
-	nhooyr.io/websocket v1.8.17 // indirect
+	maunium.net/go/mautrix v0.28.0 // indirect
 )

 replace fn-registry => ../../..
@@ -1,18 +1,28 @@
+filippo.io/edwards25519 v1.2.0 h1:crnVqOiS4jqYleHd9vaKZ+HKtHfllngJIiOpNpoJsjo=
+filippo.io/edwards25519 v1.2.0/go.mod h1:xzAOLCNug/yB62zG1bQ8uziwrIqIuxhctzJT18Q77mc=
 github.com/ClickHouse/ch-go v0.71.0 h1:bUdZ/EZj/LcVHsMqaRUP2holqygrPWQKeMjc6nZoyRM=
 github.com/ClickHouse/ch-go v0.71.0/go.mod h1:NwbNc+7jaqfY58dmdDUbG4Jl22vThgx1cYjBw0vtgXw=
 github.com/ClickHouse/clickhouse-go/v2 v2.44.0 h1:9pxs5pRwIvhni5BDRPn/n5A8DeUod5TnBaeulFBX8EQ=
 github.com/ClickHouse/clickhouse-go/v2 v2.44.0/go.mod h1:giJfUVlMkcfUEPVfRpt51zZaGEx9i17gCos8gBl392c=
+github.com/DATA-DOG/go-sqlmock v1.5.2 h1:OcvFkGmslmlZibjAjaHm3L//6LiuBgolP7OputlJIzU=
+github.com/DATA-DOG/go-sqlmock v1.5.2/go.mod h1:88MAG/4G7SMwSE3CeA0ZKzrT5CiOU3OJ+JlNzwDqpNU=
 github.com/andybalholm/brotli v1.2.0 h1:ukwgCxwYrmACq68yiUqwIWnGY0cTPox/M94sVwToPjQ=
 github.com/andybalholm/brotli v1.2.0/go.mod h1:rzTDkvFWvIrjDXZHkuS16NPggd91W3kUSvPlQ1pLaKY=
 github.com/apache/arrow-go/v18 v18.1.0 h1:agLwJUiVuwXZdwPYVrlITfx7bndULJ/dggbnLFgDp/Y=
 github.com/apache/arrow-go/v18 v18.1.0/go.mod h1:tigU/sIgKNXaesf5d7Y95jBBKS5KsxTqYBKXFsvKzo0=
 github.com/apache/thrift v0.21.0 h1:tdPmh/ptjE1IJnhbhrcl2++TauVjy242rkV/UzJChnE=
 github.com/apache/thrift v0.21.0/go.mod h1:W1H8aR/QRtYNvrPeFXBtobyRkd0/YVhTc6i07XIAgDw=
+github.com/aymerick/douceur v0.2.0 h1:Mv+mAeH1Q+n9Fr+oyamOlAkUNPWPlA8PPGR0QAaYuPk=
+github.com/aymerick/douceur v0.2.0/go.mod h1:wlT5vV2O3h55X9m7iVYN0TBM0NH/MmbLnd30/FjWUq4=
 github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=
 github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
+github.com/danieljoos/wincred v1.2.3 h1:v7dZC2x32Ut3nEfRH+vhoZGvN72+dQ/snVXo/vMFLdQ=
+github.com/danieljoos/wincred v1.2.3/go.mod h1:6qqX0WNrS4RzPZ1tnroDzq9kY3fu1KwE7MRLQK4X0bs=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA=
+github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM=
 github.com/go-faster/city v1.0.1 h1:4WAxSZ3V2Ws4QRDrscLEDcibJY8uf41H6AhXDrNDcGw=
 github.com/go-faster/city v1.0.1/go.mod h1:jKcUJId49qdW3L1qKHH/3wPeUstCVpVSXTM6vO3VcTw=
 github.com/go-faster/errors v0.7.1 h1:MkJTnDoEdi9pDabt1dpWf7AA8/BaSYZqibYyhZ20AYg=
@@ -21,6 +31,8 @@ github.com/go-viper/mapstructure/v2 v2.2.1 h1:ZAaOCxANMuZx5RCeg0mBdEZk7DZasvvZIx
 github.com/go-viper/mapstructure/v2 v2.2.1/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM=
 github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4=
 github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M=
+github.com/godbus/dbus/v5 v5.2.2 h1:TUR3TgtSVDmjiXOgAAyaZbYmIeP3DPkld3jgKGV8mXQ=
+github.com/godbus/dbus/v5 v5.2.2/go.mod h1:3AAv2+hPq5rdnr5txxxRwiGjPXamgoIHgz9FPBfOp3c=
 github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q=
 github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk=
 github.com/golang/snappy v0.0.1/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q=
@@ -34,6 +46,8 @@ github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
 github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
 github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/gorilla/css v1.0.1 h1:ntNaBIghp6JmvWnxbZKANoLyuXTPZ4cAMlo6RyhlbO8=
+github.com/gorilla/css v1.0.1/go.mod h1:BvnYkspnSzMmwRK+b8/xgNPLiIuNZr6vbZBTPQ2A3b0=
 github.com/jackc/pgpassfile v1.0.0 h1:/6Hmqy13Ss2zCq62VdNG8tM1wchn8zjSGOBJ6icpsIM=
 github.com/jackc/pgpassfile v1.0.0/go.mod h1:CEx0iS5ambNFdcRtxPj5JhEz+xB6uRky5eyVu/W2HEg=
 github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 h1:iCEnooe7UlwOQYpKFhBabPMi4aNAfoODPEFNiAnClxo=
@@ -60,8 +74,14 @@ github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
 github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
 github.com/marcboeker/go-duckdb v1.8.5 h1:tkYp+TANippy0DaIOP5OEfBEwbUINqiFqgwMQ44jME0=
 github.com/marcboeker/go-duckdb v1.8.5/go.mod h1:6mK7+WQE4P4u5AFLvVBmhFxY5fvhymFptghgJX6B+/8=
-github.com/mattn/go-sqlite3 v1.14.37 h1:3DOZp4cXis1cUIpCfXLtmlGolNLp2VEqhiB/PARNBIg=
-github.com/mattn/go-sqlite3 v1.14.37/go.mod h1:Uh1q+B4BYcTPb+yiD3kU8Ct7aC0hY9fxUwlHK0RXw+Y=
+github.com/mattn/go-colorable v0.1.14 h1:9A9LHSqF/7dyVVX6g0U9cwm9pG3kP9gSzcuIPHPsaIE=
+github.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-sqlite3 v1.14.44 h1:3VSe+xafpbzsLbdr2AWlAZk9yRHiBhTBakioXaCKTF8=
+github.com/mattn/go-sqlite3 v1.14.44/go.mod h1:pjEuOr8IwzLJP2MfGeTb0A35jauH+C2kbHKBr7yXKVQ=
+github.com/microcosm-cc/bluemonday v1.0.27 h1:MpEUotklkwCSLeH+Qdx1VJgNqLlpY2KXwXFM08ygZfk=
+github.com/microcosm-cc/bluemonday v1.0.27/go.mod h1:jFi9vgW+H7c3V0lb6nR74Ib/DIB5OBs92Dimizgw2cA=
 github.com/minio/asm2plan9s v0.0.0-20200509001527-cdd76441f9d8 h1:AMFGa4R4MiIpspGNG7Z948v4n35fFGB3RR3G/ry4FWs=
 github.com/minio/asm2plan9s v0.0.0-20200509001527-cdd76441f9d8/go.mod h1:mC1jAcsrzbxHt8iiaC+zU4b1ylILSosueou12R++wfY=
 github.com/minio/c2goasm v0.0.0-20190812172519-36a3d3bbc4f3 h1:+n/aFZefKZp7spd8DFdX7uMikMLXX4oubIzJF4kv/wI=
@@ -70,6 +90,8 @@ github.com/montanaflynn/stats v0.0.0-20171201202039-1bf9dbcd8cbe/go.mod h1:wL8QJ
 github.com/paulmach/orb v0.12.0 h1:z+zOwjmG3MyEEqzv92UN49Lg1JFYx0L9GpGKNVDKk1s=
 github.com/paulmach/orb v0.12.0/go.mod h1:5mULz1xQfs3bmQm63QEJA6lNGujuRafwA5S/EnuLaLU=
 github.com/paulmach/protoscan v0.2.1/go.mod h1:SpcSwydNLrxUGSDvXvO0P7g7AuhJ7lcKfDlhJCDw2gY=
+github.com/petermattis/goid v0.0.0-20260330135022-df67b199bc81 h1:WDsQxOJDy0N1VRAjXLpi8sCEZRSGarLWQevDxpTBRrM=
+github.com/petermattis/goid v0.0.0-20260330135022-df67b199bc81/go.mod h1:pxMtw7cyUw6B2bRH0ZBANSPg+AoSud1I1iyJHI69jH4=
 github.com/pierrec/lz4/v4 v4.1.25 h1:kocOqRffaIbU5djlIBr7Wh+cx82C0vtFb0fOurZHqD0=
 github.com/pierrec/lz4/v4 v4.1.25/go.mod h1:EoQMVJgeeEOMsCqCzqFm2O0cJvljX2nGZjcRIPL34O4=
 github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
@@ -77,17 +99,33 @@ github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZb
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ=
 github.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=
+github.com/rs/zerolog v1.35.1 h1:m7xQeoiLIiV0BCEY4Hs+j2NG4Gp2o2KPKmhnnLiazKI=
+github.com/rs/zerolog v1.35.1/go.mod h1:EjML9kdfa/RMA7h/6z6pYmq1ykOuA8/mjWaEvGI+jcw=
 github.com/segmentio/asm v1.2.1 h1:DTNbBqs57ioxAD4PrArqftgypG4/qNpXoJx8TVXxPR0=
 github.com/segmentio/asm v1.2.1/go.mod h1:BqMnlJP91P8d+4ibuonYZw9mfnzI9HfxselHZr5aAcs=
 github.com/shopspring/decimal v1.4.0 h1:bxl37RwXBklmTi0C79JfXCEBD1cqqHt0bbgBAGFp81k=
 github.com/shopspring/decimal v1.4.0/go.mod h1:gawqmDU56v4yIKSwfBSFip1HdCCXN8/+DMd9qYNcwME=
+github.com/skip2/go-qrcode v0.0.0-20200617195104-da1b6568686e h1:MRM5ITcdelLK2j1vwZ3Je0FKVCfqOLp5zO6trqMLYs0=
+github.com/skip2/go-qrcode v0.0.0-20200617195104-da1b6568686e/go.mod h1:XV66xRDqSt+GTGFMVlhk3ULuV0y9ZmzeVGR4mloJI3M=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=
+github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
 github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
+github.com/tidwall/gjson v1.14.2/go.mod h1:/wbyibRr2FHMks5tjHJ5F8dMZh3AcwJEMf5vlfC0lxk=
+github.com/tidwall/gjson v1.19.0 h1:xwxm7n691Uf3u5OFjzngavjGTh55KX5q/9w9xHW88JU=
+github.com/tidwall/gjson v1.19.0/go.mod h1:V37/opeE/JbLUOfH0QTXiNez2l0RUjYUhpT4szFQAfc=
+github.com/tidwall/match v1.1.1 h1:+Ho715JplO36QYgwN9PGYNhgZvoUSc9X2c80KVTi+GA=
+github.com/tidwall/match v1.1.1/go.mod h1:eRSPERbgtNPcGhD8UCthc6PmLEQXEWd3PRB5JTxsfmM=
 github.com/tidwall/pretty v1.0.0/go.mod h1:XNkn88O1ChpSDQmQeStsy+sBenx6DDtFZJxhVysOjyk=
+github.com/tidwall/pretty v1.2.0/go.mod h1:ITEVvHYasfjBbM0u2Pg8T2nJnzm8xPwvNhhsoaGGjNU=
+github.com/tidwall/pretty v1.2.1 h1:qjsOFOWWQl+N3RsoF5/ssm1pHmJJwhjlSbZ51I6wMl4=
+github.com/tidwall/pretty v1.2.1/go.mod h1:ITEVvHYasfjBbM0u2Pg8T2nJnzm8xPwvNhhsoaGGjNU=
+github.com/tidwall/sjson v1.2.5 h1:kLy8mja+1c9jlljvWTlSazM7cKDRfJuR/bOJhcY5NcY=
+github.com/tidwall/sjson v1.2.5/go.mod h1:Fvgq9kS/6ociJEDnK0Fk1cpYF4FIW6ZF7LAe+6jwd28=
 github.com/xdg-go/pbkdf2 v1.0.0/go.mod h1:jrpuAogTd400dnrH08LKmI/xc1MbPOebTwRqcT5RDeI=
 github.com/xdg-go/scram v1.1.1/go.mod h1:RaEWvsqvNKKvBPvcKeFjrG2cJqOkHTiyTpzz23ni57g=
 github.com/xdg-go/stringprep v1.0.3/go.mod h1:W3f5j4i+9rC0kuIEJL0ky1VpHXQU3ocBgklLGvcBnW8=
@@ -96,10 +134,16 @@ github.com/xyproto/randomstring v1.0.5/go.mod h1:rgmS5DeNXLivK7YprL0pY+lTuhNQW3i
 github.com/youmark/pkcs8 v0.0.0-20181117223130-1be2e3e5546d/go.mod h1:rHwXgn7JulP+udvsHwJoVG1YGAP6VLg4y9I5dyZdqmA=
 github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
 github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=
+github.com/yuin/goldmark v1.8.2 h1:kEGpgqJXdgbkhcOgBxkC0X0PmoPG1ZyoZ117rDVp4zE=
+github.com/yuin/goldmark v1.8.2/go.mod h1:ip/1k0VRfGynBgxOz0yCqHrbZXhcjxyuS66Brc7iBKg=
+github.com/zalando/go-keyring v0.2.8 h1:6sD/Ucpl7jNq10rM2pgqTs0sZ9V3qMrqfIIy5YPccHs=
+github.com/zalando/go-keyring v0.2.8/go.mod h1:tsMo+VpRq5NGyKfxoBVjCuMrG47yj8cmakZDO5QGii0=
 github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
 github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
 github.com/zeebo/xxh3 v1.0.2 h1:xZmwmqxHZA8AI603jOQ0tMqmBr9lPeFwGg6d+xy9DC0=
 github.com/zeebo/xxh3 v1.0.2/go.mod h1:5NWz9Sef7zIDm2JHfFlcQvNekmcEl9ekUZQQKCYaDcA=
+go.mau.fi/util v0.9.9 h1:ujDeXCo07HBor5oQLyO1tHklupmqVmPgasc53d7q/NE=
+go.mau.fi/util v0.9.9/go.mod h1:pqt4Vcrt+5gcH/CgrHZg11qSx+b34o6mknGzOEA6waY=
 go.mongodb.org/mongo-driver v1.11.4/go.mod h1:PTSz5yu21bkT/wXpkS7WR5f0ddqw5quethTUn9WM+2g=
 go.opentelemetry.io/otel v1.41.0 h1:YlEwVsGAlCvczDILpUXpIpPSL/VPugt7zHThEMLce1c=
 go.opentelemetry.io/otel v1.41.0/go.mod h1:Yt4UwgEKeT05QbLwbyHXEwhnjxNO6D8L5PQP51/46dE=
@@ -111,21 +155,21 @@ golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACk
 golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
 golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
 golang.org/x/crypto v0.0.0-20220622213112-05595931fe9d/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4=
-golang.org/x/crypto v0.50.0 h1:zO47/JPrL6vsNkINmLoo/PH1gcxpls50DNogFvB5ZGI=
-golang.org/x/crypto v0.50.0/go.mod h1:3muZ7vA7PBCE6xgPX7nkzzjiUq87kRItoJQM1Yo8S+Q=
-golang.org/x/exp v0.0.0-20250128182459-e0ece0dbea4c h1:KL/ZBHXgKGVmuZBZ01Lt57yE5ws8ZPSkkihmEyq7FXc=
-golang.org/x/exp v0.0.0-20250128182459-e0ece0dbea4c/go.mod h1:tujkw807nyEEAamNbDrEGzRav+ilXA7PCRAd6xsmwiU=
+golang.org/x/crypto v0.51.0 h1:IBPXwPfKxY7cWQZ38ZCIRPI50YLeevDLlLnyC5wRGTI=
+golang.org/x/crypto v0.51.0/go.mod h1:8AdwkbraGNABw2kOX6YFPs3WM22XqI4EXEd8g+x7Oc8=
+golang.org/x/exp v0.0.0-20260508232706-74f9aab9d74a h1:+3jdDGGB8NGb1Zktc737jlt3/A5f6UlwSzmvqUuufxw=
+golang.org/x/exp v0.0.0-20260508232706-74f9aab9d74a/go.mod h1:d2fgXJLVs4dYDHUk5lwMIfzRzSrWCfGZb0ZqeLa/Vcw=
 golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
 golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA=
-golang.org/x/mod v0.34.0 h1:xIHgNUUnW6sYkcM5Jleh05DvLOtwc6RitGHbDk4akRI=
-golang.org/x/mod v0.34.0/go.mod h1:ykgH52iCZe79kzLLMhyCUzhMci+nQj+0XkbXpNYtVjY=
+golang.org/x/mod v0.36.0 h1:JJjpVx6myfUsUdAzZuOSTTmRE0PfZeNWzzvKrP7amb4=
+golang.org/x/mod v0.36.0/go.mod h1:moc6ELqsWcOw5Ef3xVprK5ul/MvtVvkIXLziUOICjUQ=
 golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
 golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
 golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
 golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU=
 golang.org/x/net v0.0.0-20211112202133-69e39bad7dc2/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y=
-golang.org/x/net v0.53.0 h1:d+qAbo5L0orcWAr0a9JweQpjXF19LMXJE8Ey7hwOdUA=
-golang.org/x/net v0.53.0/go.mod h1:JvMuJH7rrdiCfbeHoo3fCQU24Lf5JJwT9W3sJFulfgs=
+golang.org/x/net v0.54.0 h1:2zJIZAxAHV/OHCDTCOHAYehQzLfSXuf/5SoL/Dv6w/w=
+golang.org/x/net v0.54.0/go.mod h1:Sj4oj8jK6XmHpBZU/zWHw3BV3abl4Kvi+Ut7cQcY+cQ=
 golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
@@ -138,23 +182,24 @@ golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7w
 golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.43.0 h1:Rlag2XtaFTxp19wS8MXlJwTvoh8ArU6ezoyFsMyCTNI=
-golang.org/x/sys v0.43.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
-golang.org/x/telemetry v0.0.0-20260311193753-579e4da9a98c h1:6a8FdnNk6bTXBjR4AGKFgUKuo+7GnR3FX5L7CbveeZc=
-golang.org/x/telemetry v0.0.0-20260311193753-579e4da9a98c/go.mod h1:TpUTTEp9frx7rTdLpC9gFG9kdI7zVLFTFFlqaH2Cncw=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.44.0 h1:ildZl3J4uzeKP07r2F++Op7E9B29JRUy+a27EibtBTQ=
+golang.org/x/sys v0.44.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/telemetry v0.0.0-20260508192327-42602be52be6 h1:HjU6IWBiAgRIdAJ9/y1rwCn+UELEmwV+VsTLzj/W4sE=
+golang.org/x/telemetry v0.0.0-20260508192327-42602be52be6/go.mod h1:Eqhaxk/wZsWEH8CRxLwj6xzEJbz7k1EFGqx7nyCoabE=
 golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
 golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
-golang.org/x/text v0.36.0 h1:JfKh3XmcRPqZPKevfXVpI1wXPTqbkE5f7JA92a55Yxg=
-golang.org/x/text v0.36.0/go.mod h1:NIdBknypM8iqVmPiuco0Dh6P5Jcdk8lJL0CUebqK164=
+golang.org/x/text v0.37.0 h1:Cqjiwd9eSg8e0QAkyCaQTNHFIIzWtidPahFWR83rTrc=
+golang.org/x/text v0.37.0/go.mod h1:a5sjxXGs9hsn/AJVwuElvCAo9v8QYLzvavO5z2PiM38=
 golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
 golang.org/x/tools v0.0.0-20200619180055-7c47624df98f/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE=
 golang.org/x/tools v0.0.0-20210106214847-113979e3529a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA=
-golang.org/x/tools v0.43.0 h1:12BdW9CeB3Z+J/I/wj34VMl8X+fEXBxVR90JeMX5E7s=
-golang.org/x/tools v0.43.0/go.mod h1:uHkMso649BX2cZK6+RpuIPXS3ho2hZo4FVwfoy1vIk0=
+golang.org/x/tools v0.45.0 h1:18qN3FAooORvApf5XjCXgsuayZOEtXf6JK18I3+ONa8=
+golang.org/x/tools v0.45.0/go.mod h1:LuUGqqaXcXMEFEruIVJVm5mgDD8vww/z/SR1gQ4uE/0=
 golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
 golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
 golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
@@ -172,5 +217,7 @@ gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EV
 gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
+maunium.net/go/mautrix v0.28.0 h1:vBakLzf8MAdfED3NzAKiMeKQbc3AQ4EAS03NC+TVMXQ=
+maunium.net/go/mautrix v0.28.0/go.mod h1:/a9A7LGaqb9B3nho4tLd28n0EPcCdwpm2dxkxkLLgh0=
 nhooyr.io/websocket v1.8.17 h1:KEVeLJkUywCKVsnLIDlD/5gtayKp8VoCkksHCGGfT9Y=
 nhooyr.io/websocket v1.8.17/go.mod h1:rN9OFWIUwuxg4fR5tELlYC04bXYowCP9GX47ivo2l+c=
@@ -74,8 +74,21 @@ func handleGetBoard(db *DB) http.HandlerFunc {
 	}
 }

+// publishInvalidated emits a board.invalidated event so connected clients
+// refetch /api/board. Best-effort: dropped events recover on next mutation
+// or via the periodic safety reload kept in the SPA.
+func publishInvalidated(hub *EventHub, cardID, columnID string) {
+	if hub == nil {
+		return
+	}
+	hub.PublishJSON("board.invalidated", cardID, "", map[string]string{
+		"card_id":   cardID,
+		"column_id": columnID,
+	})
+}
+
 // POST /api/columns { name }
-func handleCreateColumn(db *DB) http.HandlerFunc {
+func handleCreateColumn(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		var body struct{ Name string `json:"name"` }
 		if err := infra.HTTPParseBody(r, &body, maxBodyBytes); err != nil {
@@ -91,12 +104,13 @@ func handleCreateColumn(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, "", c.ID)
 		infra.HTTPJSONResponse(w, http.StatusCreated, c)
 	}
 }

 // PATCH /api/columns/{id} { name?, position?, location?, width? }
-func handleUpdateColumn(db *DB) http.HandlerFunc {
+func handleUpdateColumn(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		var body struct {
@@ -116,24 +130,26 @@ func handleUpdateColumn(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, "", id)
 		w.WriteHeader(http.StatusNoContent)
 	}
 }

 // DELETE /api/columns/{id}
-func handleDeleteColumn(db *DB) http.HandlerFunc {
+func handleDeleteColumn(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		if err := db.DeleteColumn(id); err != nil {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, "", id)
 		w.WriteHeader(http.StatusNoContent)
 	}
 }

 // POST /api/columns/reorder { ids: [...] }
-func handleReorderColumns(db *DB) http.HandlerFunc {
+func handleReorderColumns(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		var body struct{ IDs []string `json:"ids"` }
 		if err := infra.HTTPParseBody(r, &body, maxBodyBytes); err != nil {
@@ -144,12 +160,13 @@ func handleReorderColumns(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, "", "")
 		w.WriteHeader(http.StatusNoContent)
 	}
 }

 // POST /api/cards { column_id, requester?, title, description? }
-func handleCreateCard(db *DB) http.HandlerFunc {
+func handleCreateCard(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		var body struct {
 			ColumnID    string   `json:"column_id"`
@@ -186,12 +203,13 @@ func handleCreateCard(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, c.ID, body.ColumnID)
 		infra.HTTPJSONResponse(w, http.StatusCreated, c)
 	}
 }

 // PATCH /api/cards/{id} { requester?, title?, description?, color? }
-func handleUpdateCard(db *DB) http.HandlerFunc {
+func handleUpdateCard(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		var raw map[string]any
@@ -249,12 +267,13 @@ func handleUpdateCard(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, id, "")
 		w.WriteHeader(http.StatusNoContent)
 	}
 }

 // PUT /api/cards/{id}/stickers { stickers: [{emoji,x,y}, ...] }
-func handleUpdateCardStickers(db *DB) http.HandlerFunc {
+func handleUpdateCardStickers(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		var body struct {
@@ -268,12 +287,13 @@ func handleUpdateCardStickers(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, id, "")
 		w.WriteHeader(http.StatusNoContent)
 	}
 }

 // DELETE /api/cards/{id}
-func handleDeleteCard(db *DB) http.HandlerFunc {
+func handleDeleteCard(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		actor, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
@@ -281,12 +301,13 @@ func handleDeleteCard(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, id, "")
 		w.WriteHeader(http.StatusNoContent)
 	}
 }

 // POST /api/cards/{id}/move { column_id, ordered_ids }
-func handleMoveCard(db *DB) http.HandlerFunc {
+func handleMoveCard(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		var body struct {
@@ -310,6 +331,7 @@ func handleMoveCard(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, id, body.ColumnID)
 		w.WriteHeader(http.StatusNoContent)
 	}
 }
@@ -328,7 +350,10 @@ func handleListCardMessages(db *DB) http.HandlerFunc {
 }

 // POST /api/cards/{id}/messages { body }
-func handleCreateCardMessage(db *DB) http.HandlerFunc {
+//
+// Parses @mentions, fans out notifications and publishes message.created via
+// the hub so SSE/WS subscribers see the message immediately.
+func handleCreateCardMessage(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		var body struct {
@@ -347,7 +372,7 @@ func handleCreateCardMessage(db *DB) http.HandlerFunc {
 			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "session required"})
 			return
 		}
-		m, err := db.CreateCardMessage(id, actor, body.Body)
+		m, _, _, err := db.CreateCardMessageAndNotify(id, actor, body.Body, hub)
 		if err != nil {
 			if strings.Contains(err.Error(), "not found") {
 				notFound(w, err.Error())
@@ -361,8 +386,9 @@ func handleCreateCardMessage(db *DB) http.HandlerFunc {
 }

 // DELETE /api/cards/{cid}/messages/{mid}
-func handleDeleteCardMessage(db *DB) http.HandlerFunc {
+func handleDeleteCardMessage(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
+		cid := r.PathValue("id")
 		mid := r.PathValue("mid")
 		actor, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
 		if actor == "" {
@@ -377,12 +403,15 @@ func handleDeleteCardMessage(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		if hub != nil {
+			hub.PublishJSON("message.deleted", cid, "", map[string]string{"id": mid})
+		}
 		w.WriteHeader(http.StatusNoContent)
 	}
 }

 // POST /api/cards/{id}/duplicate
-func handleDuplicateCard(db *DB) http.HandlerFunc {
+func handleDuplicateCard(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		actor, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
@@ -395,6 +424,7 @@ func handleDuplicateCard(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, c.ID, c.ColumnID)
 		infra.HTTPJSONResponse(w, http.StatusCreated, c)
 	}
 }
@@ -425,7 +455,7 @@ func handleListTrash(db *DB) http.HandlerFunc {
 }

 // POST /api/cards/{id}/restore
-func handleRestoreCard(db *DB) http.HandlerFunc {
+func handleRestoreCard(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		actor, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
@@ -433,6 +463,7 @@ func handleRestoreCard(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, id, "")
 		w.WriteHeader(http.StatusNoContent)
 	}
 }
@@ -553,44 +584,48 @@ func handleListArchive(db *DB) http.HandlerFunc {
 }

 // POST /api/cards/{id}/archive
-func handleArchiveCard(db *DB) http.HandlerFunc {
+func handleArchiveCard(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		if err := db.ArchiveCard(id); err != nil {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, id, "")
 		w.WriteHeader(http.StatusNoContent)
 	}
 }

 // POST /api/cards/{id}/unarchive
-func handleUnarchiveCard(db *DB) http.HandlerFunc {
+func handleUnarchiveCard(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		if err := db.UnarchiveCard(id); err != nil {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, id, "")
 		w.WriteHeader(http.StatusNoContent)
 	}
 }

 // DELETE /api/cards/{id}/purge
-func handlePurgeCard(db *DB) http.HandlerFunc {
+func handlePurgeCard(db *DB, hub *EventHub) http.HandlerFunc {
 	return func(w http.ResponseWriter, r *http.Request) {
 		id := r.PathValue("id")
 		if err := db.PurgeCard(id); err != nil {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, id, "")
 		w.WriteHeader(http.StatusNoContent)
 	}
 }

-func apiRoutes(db *DB, chatWorkdir string, logger *ChatLogger, internalToken string, flags *FeatureFlags) []infra.Route {
+func apiRoutes(db *DB, chatWorkdir string, logger *ChatLogger, internalToken string, flags *FeatureFlags, hub *EventHub, dispatcher *Dispatcher) []infra.Route {
 	return []infra.Route{
 		{Method: "GET", Path: "/api/flags", Handler: handleListFlags(flags)},
+		{Method: "GET", Path: "/api/version", Handler: handleVersion()},
 		{Method: "POST", Path: "/api/auth/register", Handler: handleRegister(db, flags)},
 		{Method: "POST", Path: "/api/auth/login", Handler: handleLogin(db)},
 		{Method: "POST", Path: "/api/auth/logout", Handler: handleLogout(db)},
@@ -598,31 +633,31 @@ func apiRoutes(db *DB, chatWorkdir string, logger *ChatLogger, internalToken str
 		{Method: "PATCH", Path: "/api/me", Handler: handlePatchMe(db)},
 		{Method: "GET", Path: "/api/users", Handler: handleListUsers(db)},
 		{Method: "GET", Path: "/api/board", Handler: handleGetBoard(db)},
-		{Method: "POST", Path: "/api/columns", Handler: handleCreateColumn(db)},
-		{Method: "POST", Path: "/api/columns/reorder", Handler: handleReorderColumns(db)},
-		{Method: "PATCH", Path: "/api/columns/{id}", Handler: handleUpdateColumn(db)},
-		{Method: "DELETE", Path: "/api/columns/{id}", Handler: handleDeleteColumn(db)},
-		{Method: "POST", Path: "/api/cards", Handler: handleCreateCard(db)},
-		{Method: "PATCH", Path: "/api/cards/{id}", Handler: handleUpdateCard(db)},
-		{Method: "PUT", Path: "/api/cards/{id}/stickers", Handler: handleUpdateCardStickers(db)},
-		{Method: "DELETE", Path: "/api/cards/{id}", Handler: handleDeleteCard(db)},
-		{Method: "POST", Path: "/api/cards/{id}/move", Handler: handleMoveCard(db)},
-		{Method: "POST", Path: "/api/cards/{id}/duplicate", Handler: handleDuplicateCard(db)},
+		{Method: "POST", Path: "/api/columns", Handler: handleCreateColumn(db, hub)},
+		{Method: "POST", Path: "/api/columns/reorder", Handler: handleReorderColumns(db, hub)},
+		{Method: "PATCH", Path: "/api/columns/{id}", Handler: handleUpdateColumn(db, hub)},
+		{Method: "DELETE", Path: "/api/columns/{id}", Handler: handleDeleteColumn(db, hub)},
+		{Method: "POST", Path: "/api/cards", Handler: handleCreateCard(db, hub)},
+		{Method: "PATCH", Path: "/api/cards/{id}", Handler: handleUpdateCard(db, hub)},
+		{Method: "PUT", Path: "/api/cards/{id}/stickers", Handler: handleUpdateCardStickers(db, hub)},
+		{Method: "DELETE", Path: "/api/cards/{id}", Handler: handleDeleteCard(db, hub)},
+		{Method: "POST", Path: "/api/cards/{id}/move", Handler: handleMoveCard(db, hub)},
+		{Method: "POST", Path: "/api/cards/{id}/duplicate", Handler: handleDuplicateCard(db, hub)},
 		{Method: "GET", Path: "/api/cards/{id}/messages", Handler: handleListCardMessages(db)},
-		{Method: "POST", Path: "/api/cards/{id}/messages", Handler: handleCreateCardMessage(db)},
-		{Method: "DELETE", Path: "/api/cards/{id}/messages/{mid}", Handler: handleDeleteCardMessage(db)},
+		{Method: "POST", Path: "/api/cards/{id}/messages", Handler: handleCreateCardMessage(db, hub)},
+		{Method: "DELETE", Path: "/api/cards/{id}/messages/{mid}", Handler: handleDeleteCardMessage(db, hub)},
 		{Method: "GET", Path: "/api/cards/{id}/history", Handler: handleCardHistory(db)},
 		{Method: "GET", Path: "/api/trash", Handler: handleListTrash(db)},
-		{Method: "POST", Path: "/api/cards/{id}/restore", Handler: handleRestoreCard(db)},
+		{Method: "POST", Path: "/api/cards/{id}/restore", Handler: handleRestoreCard(db, hub)},
 		{Method: "GET", Path: "/api/reports/daily", Handler: handleDailyReport(db)},
 		{Method: "GET", Path: "/api/reports/daily/summary", Handler: handleGetDailySummary(db)},
 		{Method: "POST", Path: "/api/reports/daily/summary", Handler: handleGenerateDailySummary(db)},
 		{Method: "GET", Path: "/api/settings/{key}", Handler: handleGetSetting(db)},
 		{Method: "PUT", Path: "/api/settings/{key}", Handler: handlePutSetting(db)},
 		{Method: "GET", Path: "/api/archive", Handler: handleListArchive(db)},
-		{Method: "POST", Path: "/api/cards/{id}/archive", Handler: handleArchiveCard(db)},
-		{Method: "POST", Path: "/api/cards/{id}/unarchive", Handler: handleUnarchiveCard(db)},
-		{Method: "DELETE", Path: "/api/cards/{id}/purge", Handler: handlePurgeCard(db)},
+		{Method: "POST", Path: "/api/cards/{id}/archive", Handler: handleArchiveCard(db, hub)},
+		{Method: "POST", Path: "/api/cards/{id}/unarchive", Handler: handleUnarchiveCard(db, hub)},
+		{Method: "DELETE", Path: "/api/cards/{id}/purge", Handler: handlePurgeCard(db, hub)},
 		{Method: "POST", Path: "/api/chat", Handler: handleChat(db, chatWorkdir, logger)},
 		{Method: "GET", Path: "/api/chat/ws", Handler: handleChatWS(db, chatWorkdir, logger, internalToken)},
 		{Method: "POST", Path: "/api/tool/{name}", Handler: handleInternalTool(db, internalToken, logger)},
@@ -634,6 +669,34 @@ func apiRoutes(db *DB, chatWorkdir string, logger *ChatLogger, internalToken str
 		{Method: "GET", Path: "/api/cards/{id}/files", Handler: handleListCardFiles(db)},
 		{Method: "GET", Path: "/api/files/{id}", Handler: handleServeFile(db)},
 		{Method: "DELETE", Path: "/api/files/{id}", Handler: handleDeleteCardFile(db)},
+		// Notifications + realtime (issue notifications-realtime).
+		{Method: "GET", Path: "/api/events", Handler: handleEventStream(hub)},
+		{Method: "GET", Path: "/api/cards/{id}/chat/ws", Handler: handleCardChatWS(db, hub)},
+		{Method: "GET", Path: "/api/notifications", Handler: handleListNotifications(db)},
+		{Method: "GET", Path: "/api/notifications/unread-count", Handler: handleUnreadCount(db)},
+		{Method: "POST", Path: "/api/notifications/{id}/read", Handler: handleMarkNotificationRead(db, hub)},
+		{Method: "POST", Path: "/api/notifications/read-all", Handler: handleMarkAllNotificationsRead(db, hub)},
+		// MCP per-user tokens.
+		{Method: "POST", Path: "/api/mcp-tokens", Handler: handleCreateMCPToken(db)},
+		{Method: "GET", Path: "/api/mcp-tokens", Handler: handleListMCPTokens(db)},
+		{Method: "DELETE", Path: "/api/mcp-tokens/{id}", Handler: handleRevokeMCPToken(db)},
+		// Modules: external integrations (Jira, ...).
+		{Method: "GET", Path: "/api/modules", Handler: handleListModules(db)},
+		{Method: "POST", Path: "/api/modules", Handler: handleCreateModule(db)},
+		{Method: "PATCH", Path: "/api/modules/{id}", Handler: handleUpdateModule(db)},
+		{Method: "DELETE", Path: "/api/modules/{id}", Handler: handleDeleteModule(db)},
+		{Method: "GET", Path: "/api/modules/{id}/logs", Handler: handleModuleLogs(db)},
+		{Method: "POST", Path: "/api/modules/{id}/test", Handler: handleTestModule(db, dispatcher)},
+	}
+}
+
+// GET /api/version → {"version": "<semver>"}
+//
+// Public, no auth. Skipped from session middleware via skip list updated in
+// main.go to keep the SPA pre-login able to display the running build.
+func handleVersion() http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		infra.HTTPJSONResponse(w, http.StatusOK, map[string]string{"version": Version})
 	}
 }

@@ -21,6 +21,11 @@ import (
 //go:embed all:dist
 var frontendDist embed.FS

+// Version is the build-time identifier of the kanban app. It is injected
+// from app.md's `version:` field via -ldflags "-X main.Version=..." by run.sh
+// (and by docker/CI). Defaults to "dev" for hand-built binaries.
+var Version = "dev"
+
 func main() {
 	// Subcommand `kanban mcp` runs as MCP server over stdio (spawned by claude -p).
 	if len(os.Args) > 1 && os.Args[1] == "mcp" {
@@ -63,7 +68,13 @@ func main() {
 	wd := chatWorkdir(*dbPath)
 	logger := newChatLogger(filepath.Join(wd, "chat.log"))
 	log.Printf("chat tool log: %s", logger.path)
-	mux := infra.HTTPRouter(apiRoutes(db, wd, logger, internalToken, &featureFlags))
+	hub := NewEventHub()
+	dispatcher := NewDispatcher(db, hub)
+	dispatcher.Start()
+	defer dispatcher.Stop()
+	mux := infra.HTTPRouter(apiRoutes(db, wd, logger, internalToken, &featureFlags, hub, dispatcher))
+
+	mux.Handle("/mcp", mcpHTTPHandler(db))

 	feHandler := frontendHandler()
 	if feHandler != nil {
@@ -76,7 +87,7 @@ func main() {
 	authMW := infra.HTTPSessionCookieMiddleware(infra.SessionCookieConfig{
 		DB:         db.conn,
 		CookieName: cookieName,
-		SkipPaths:  []string{"/api/auth/", "/api/tool/", "/api/flags", "/health", "/assets/", "/index.html"},
+		SkipPaths:  []string{"/api/auth/", "/api/tool/", "/api/flags", "/api/version", "/health", "/assets/", "/index.html"},
 		UserCtxKey: userCtxKey,
 	})

@@ -163,5 +174,28 @@ func frontendHandler() http.Handler {
 	if len(entries) == 0 {
 		return nil
 	}
-	return infra.SPAHandler(sub, "index.html")
+	return cacheHeadersMiddleware(infra.SPAHandler(sub, "index.html"))
+}
+
+// cacheHeadersMiddleware ensures the SPA shell is never cached while the
+// hashed assets (which are content-addressed by Vite) are cached for a long
+// time. Without this, browsers happily reuse an old index.html — pinned to a
+// stale /assets/index-<hash>.js URL — and never pick up new releases.
+//
+// Policy:
+//
+//	/assets/*  →  public, max-age=1y, immutable  (filename changes per build)
+//	everything else  →  no-store, must-revalidate (forces revalidation on every
+//	                    navigation so the latest hash is always discovered)
+func cacheHeadersMiddleware(next http.Handler) http.Handler {
+	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if strings.HasPrefix(r.URL.Path, "/assets/") {
+			w.Header().Set("Cache-Control", "public, max-age=31536000, immutable")
+		} else {
+			w.Header().Set("Cache-Control", "no-store, no-cache, must-revalidate")
+			w.Header().Set("Pragma", "no-cache")
+			w.Header().Set("Expires", "0")
+		}
+		next.ServeHTTP(w, r)
+	})
 }
@@ -254,6 +254,31 @@ func mcpToolDefs() []infra.MCPToolDef {
 				"required": []string{"id"},
 			}),
 		},
+		{
+			Name:        "add_comment",
+			Description: "Anade un comentario (card_message) a una tarjeta. Requiere card_id, body y autor (author_id o author_username). Devuelve el CardMessage creado.",
+			InputSchema: rawSchema(map[string]any{
+				"type": "object",
+				"properties": map[string]any{
+					"card_id":         map[string]any{"type": "string"},
+					"body":            map[string]any{"type": "string"},
+					"author_id":       map[string]any{"type": "string"},
+					"author_username": map[string]any{"type": "string"},
+				},
+				"required": []string{"card_id", "body"},
+			}),
+		},
+		{
+			Name:        "list_comments",
+			Description: "Lista los comentarios (card_messages) de una tarjeta en orden cronologico.",
+			InputSchema: rawSchema(map[string]any{
+				"type": "object",
+				"properties": map[string]any{
+					"card_id": map[string]any{"type": "string"},
+				},
+				"required": []string{"card_id"},
+			}),
+		},
 	}
 }

@@ -0,0 +1,55 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+	"net/http"
+	"os"
+	"strings"
+
+	"fn-registry/functions/infra"
+)
+
+// mcpHTTPHandler builds the http.Handler that serves the MCP Streamable HTTP
+// transport for remote Claude clients. Bearer-auth backed by the mcp_tokens
+// table; tool dispatch reuses executeTool() — the same set of operations the
+// chat assistant uses internally.
+func mcpHTTPHandler(db *DB) http.Handler {
+	auth := func(r *http.Request) (context.Context, error) {
+		header := r.Header.Get("Authorization")
+		token := strings.TrimSpace(strings.TrimPrefix(header, "Bearer "))
+		if token == "" || token == header {
+			return nil, errors.New("missing bearer token")
+		}
+		userID, err := db.LookupMCPToken(token)
+		if err != nil {
+			return nil, err
+		}
+		if userID == "" {
+			return nil, errors.New("invalid or revoked token")
+		}
+		return context.WithValue(r.Context(), userCtxKey, userID), nil
+	}
+
+	handler := func(ctx context.Context, name string, input json.RawMessage) (any, bool, error) {
+		body := input
+		if len(body) == 0 {
+			body = json.RawMessage(`{}`)
+		}
+		res := executeTool(db, name, body)
+		if !res.OK {
+			return res.Error, true, nil
+		}
+		return res.Result, false, nil
+	}
+
+	return infra.MCPHTTPHandler(infra.MCPHTTPOpts{
+		Name:    "kanban",
+		Version: Version,
+		Tools:   mcpToolDefs(),
+		Handler: handler,
+		Auth:    auth,
+		Logger:  os.Stderr,
+	})
+}
@@ -0,0 +1,132 @@
+package main
+
+import (
+	"crypto/rand"
+	"crypto/sha256"
+	"database/sql"
+	"encoding/hex"
+	"errors"
+	"fmt"
+)
+
+// MCPToken is a per-user access token used by remote Claude clients to talk to
+// the kanban MCP HTTP endpoint. The plaintext value is shown ONCE at creation
+// time; we only persist the SHA-256 hash.
+type MCPToken struct {
+	ID         string  `json:"id"`
+	Name       string  `json:"name"`
+	CreatedAt  string  `json:"created_at"`
+	LastUsedAt *string `json:"last_used_at,omitempty"`
+}
+
+const mcpTokenPrefix = "kmcp_"
+
+var errMCPTokenNotFound = errors.New("mcp token not found")
+
+// MintMCPToken creates a new active token for userID and returns the plaintext
+// value (caller must surface it to the user immediately; it cannot be
+// recovered later) along with the row metadata.
+func (db *DB) MintMCPToken(userID, name string) (string, *MCPToken, error) {
+	if userID == "" {
+		return "", nil, fmt.Errorf("user_id required")
+	}
+	plaintext, err := generateMCPTokenPlaintext()
+	if err != nil {
+		return "", nil, fmt.Errorf("generate token: %w", err)
+	}
+	tok := &MCPToken{
+		ID:        newID(),
+		Name:      name,
+		CreatedAt: nowRFC3339(),
+	}
+	_, err = db.conn.Exec(
+		`INSERT INTO mcp_tokens (id, user_id, token_hash, name, created_at) VALUES (?, ?, ?, ?, ?)`,
+		tok.ID, userID, hashMCPToken(plaintext), tok.Name, tok.CreatedAt,
+	)
+	if err != nil {
+		return "", nil, err
+	}
+	return plaintext, tok, nil
+}
+
+func (db *DB) ListMCPTokens(userID string) ([]MCPToken, error) {
+	rows, err := db.conn.Query(
+		`SELECT id, name, created_at, last_used_at FROM mcp_tokens
+		 WHERE user_id=? AND revoked_at IS NULL
+		 ORDER BY created_at DESC`, userID,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	out := []MCPToken{}
+	for rows.Next() {
+		var t MCPToken
+		var lastUsed sql.NullString
+		if err := rows.Scan(&t.ID, &t.Name, &t.CreatedAt, &lastUsed); err != nil {
+			return nil, err
+		}
+		if lastUsed.Valid {
+			t.LastUsedAt = &lastUsed.String
+		}
+		out = append(out, t)
+	}
+	return out, rows.Err()
+}
+
+// RevokeMCPToken sets revoked_at on the token belonging to userID. Returns
+// errMCPTokenNotFound if no active row matches.
+func (db *DB) RevokeMCPToken(userID, tokenID string) error {
+	res, err := db.conn.Exec(
+		`UPDATE mcp_tokens SET revoked_at=? WHERE id=? AND user_id=? AND revoked_at IS NULL`,
+		nowRFC3339(), tokenID, userID,
+	)
+	if err != nil {
+		return err
+	}
+	n, err := res.RowsAffected()
+	if err != nil {
+		return err
+	}
+	if n == 0 {
+		return errMCPTokenNotFound
+	}
+	return nil
+}
+
+// LookupMCPToken hashes plaintext and returns the owning user_id if the token
+// is active. Updates last_used_at as a side effect. Returns "" + nil when the
+// token does not match an active row.
+func (db *DB) LookupMCPToken(plaintext string) (string, error) {
+	if plaintext == "" {
+		return "", nil
+	}
+	hash := hashMCPToken(plaintext)
+	var userID, id string
+	err := db.conn.QueryRow(
+		`SELECT id, user_id FROM mcp_tokens WHERE token_hash=? AND revoked_at IS NULL`, hash,
+	).Scan(&id, &userID)
+	if errors.Is(err, sql.ErrNoRows) {
+		return "", nil
+	}
+	if err != nil {
+		return "", err
+	}
+	if _, err := db.conn.Exec(`UPDATE mcp_tokens SET last_used_at=? WHERE id=?`, nowRFC3339(), id); err != nil {
+		return userID, fmt.Errorf("touch last_used_at: %w", err)
+	}
+	return userID, nil
+}
+
+func hashMCPToken(plaintext string) string {
+	sum := sha256.Sum256([]byte(plaintext))
+	return hex.EncodeToString(sum[:])
+}
+
+func generateMCPTokenPlaintext() (string, error) {
+	b := make([]byte, 32)
+	if _, err := rand.Read(b); err != nil {
+		return "", err
+	}
+	return mcpTokenPrefix + hex.EncodeToString(b), nil
+}
@@ -0,0 +1,83 @@
+package main
+
+import (
+	"errors"
+	"net/http"
+	"strings"
+
+	"fn-registry/functions/infra"
+)
+
+// POST /api/mcp-tokens {name}
+//
+// Mints a new MCP token for the current user. The plaintext token is returned
+// ONLY in this response — there is no way to retrieve it again.
+func handleCreateMCPToken(db *DB) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		userID, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		if userID == "" {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "login required"})
+			return
+		}
+		var body struct {
+			Name string `json:"name"`
+		}
+		if err := infra.HTTPParseBody(r, &body, maxBodyBytes); err != nil {
+			badRequest(w, err.Error())
+			return
+		}
+		name := strings.TrimSpace(body.Name)
+		if name == "" {
+			name = "default"
+		}
+		plaintext, tok, err := db.MintMCPToken(userID, name)
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		infra.HTTPJSONResponse(w, http.StatusCreated, map[string]any{
+			"id":         tok.ID,
+			"name":       tok.Name,
+			"created_at": tok.CreatedAt,
+			"token":      plaintext,
+		})
+	}
+}
+
+// GET /api/mcp-tokens
+func handleListMCPTokens(db *DB) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		userID, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		if userID == "" {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "login required"})
+			return
+		}
+		tokens, err := db.ListMCPTokens(userID)
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, tokens)
+	}
+}
+
+// DELETE /api/mcp-tokens/{id}
+func handleRevokeMCPToken(db *DB) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		userID, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		if userID == "" {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "login required"})
+			return
+		}
+		id := r.PathValue("id")
+		if err := db.RevokeMCPToken(userID, id); err != nil {
+			if errors.Is(err, errMCPTokenNotFound) {
+				notFound(w, "token not found")
+				return
+			}
+			serverError(w, err)
+			return
+		}
+		w.WriteHeader(http.StatusNoContent)
+	}
+}
@@ -0,0 +1,42 @@
+-- Per-user notifications + persisted @mentions.
+-- Created by card chat messages (card_messages).
+--
+-- Kinds:
+--   mention       — user mentioned via @username in body
+--   assigned_chat — user is the card's assignee and someone else commented
+--   reply         — user previously commented on this card (or is requester)
+-- A row is created per (recipient_user, message). The kind chosen is the
+-- highest priority among those that apply: mention > assigned_chat > reply.
+
+CREATE TABLE IF NOT EXISTS notifications (
+    id          TEXT PRIMARY KEY,
+    user_id     TEXT NOT NULL,
+    card_id     TEXT NOT NULL,
+    message_id  TEXT NOT NULL,
+    kind        TEXT NOT NULL,
+    actor_id    TEXT NOT NULL,
+    created_at  TEXT NOT NULL,
+    read_at     TEXT,
+    FOREIGN KEY (card_id)    REFERENCES cards(id)         ON DELETE CASCADE,
+    FOREIGN KEY (message_id) REFERENCES card_messages(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_notifications_user_unread
+    ON notifications(user_id, read_at, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_notifications_user_created
+    ON notifications(user_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS card_mentions (
+    id          TEXT PRIMARY KEY,
+    card_id     TEXT NOT NULL,
+    message_id  TEXT NOT NULL,
+    user_id     TEXT NOT NULL,
+    created_at  TEXT NOT NULL,
+    FOREIGN KEY (card_id)    REFERENCES cards(id)         ON DELETE CASCADE,
+    FOREIGN KEY (message_id) REFERENCES card_messages(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_card_mentions_user    ON card_mentions(user_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_card_mentions_card    ON card_mentions(card_id);
+CREATE INDEX IF NOT EXISTS idx_card_mentions_message ON card_mentions(message_id);
@@ -0,0 +1,45 @@
+-- Outbound modules (integrations): kanban events → external systems.
+--
+-- A module is a configured subscription. The dispatcher (modules.go)
+-- subscribes to the EventHub and, for each event whose type matches the
+-- module's event_filter, calls the kind-specific handler with the
+-- decrypted config.
+--
+-- Tokens / secrets are encrypted with AES-GCM at rest. The key is derived
+-- from the KANBAN_MODULE_KEY environment variable (sha256 of the value).
+
+CREATE TABLE IF NOT EXISTS modules (
+    id            TEXT PRIMARY KEY,
+    name          TEXT NOT NULL,
+    kind          TEXT NOT NULL,           -- 'jira' | 'webhook' | …
+    enabled       INTEGER NOT NULL DEFAULT 1,
+    event_filter  TEXT NOT NULL,           -- comma-separated event types
+    config_cipher BLOB NOT NULL,           -- AES-GCM ciphertext of JSON
+    config_nonce  BLOB NOT NULL,
+    created_at    TEXT NOT NULL,
+    updated_at    TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS module_logs (
+    id          TEXT PRIMARY KEY,
+    module_id   TEXT NOT NULL,
+    event_type  TEXT NOT NULL,
+    card_id     TEXT,
+    status      INTEGER,                   -- HTTP status or 0 if pre-flight
+    duration_ms INTEGER,
+    error       TEXT,
+    created_at  TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_module_logs_module_created
+    ON module_logs(module_id, created_at DESC);
+
+-- jira_key: 1:1 link between a kanban card and its Jira issue. Empty
+-- string when the card has not yet been synced to Jira.
+ALTER TABLE cards ADD COLUMN jira_key TEXT NOT NULL DEFAULT '';
+
+-- is_admin: gates /api/modules access and the Modulos menu item.
+-- Bootstrap: egutierrez (the initial admin) is marked admin so the
+-- feature is reachable on first deploy. Other users start as non-admin.
+ALTER TABLE users ADD COLUMN is_admin INTEGER NOT NULL DEFAULT 0;
+UPDATE users SET is_admin = 1 WHERE username = 'egutierrez';
@@ -0,0 +1,26 @@
+-- Per-user MCP access tokens. Users mint tokens from the settings UI and
+-- paste them into their local Claude (`claude mcp add --transport http ...`).
+-- The plaintext token is shown ONCE at creation time; we only store the hash.
+--
+-- token_hash is a SHA-256 hex digest of the plaintext token. Lookup on
+-- incoming requests: hash the bearer, look up the row, accept if not revoked.
+--
+-- revoked_at is NULL for active tokens. Tokens are never deleted (audit
+-- trail); revocation is a soft delete.
+CREATE TABLE IF NOT EXISTS mcp_tokens (
+    id            TEXT PRIMARY KEY,
+    user_id       TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+    token_hash    TEXT NOT NULL UNIQUE,
+    name          TEXT NOT NULL DEFAULT '',
+    created_at    TEXT NOT NULL,
+    last_used_at  TEXT,
+    revoked_at    TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_mcp_tokens_user_active
+    ON mcp_tokens(user_id)
+    WHERE revoked_at IS NULL;
+
+CREATE INDEX IF NOT EXISTS idx_mcp_tokens_hash_active
+    ON mcp_tokens(token_hash)
+    WHERE revoked_at IS NULL;
@@ -0,0 +1,725 @@
+package main
+
+import (
+	"bytes"
+	"context"
+	"database/sql"
+	"encoding/base64"
+	"encoding/json"
+	"fmt"
+	"io"
+	"log"
+	"net/http"
+	"strings"
+	"time"
+)
+
+// =============================================================================
+// Module model
+// =============================================================================
+
+type Module struct {
+	ID          string    `json:"id"`
+	Name        string    `json:"name"`
+	Kind        string    `json:"kind"`
+	Enabled     bool      `json:"enabled"`
+	EventFilter []string  `json:"event_filter"`
+	Config      JSONValue `json:"config"`
+	CreatedAt   string    `json:"created_at"`
+	UpdatedAt   string    `json:"updated_at"`
+}
+
+// JSONValue is an arbitrary JSON object decoded into a generic map. We do not
+// model per-kind config in Go types because the set of kinds grows over time
+// and the dispatcher only inspects fields it knows.
+type JSONValue map[string]interface{}
+
+type ModuleLog struct {
+	ID         string `json:"id"`
+	ModuleID   string `json:"module_id"`
+	EventType  string `json:"event_type"`
+	CardID     string `json:"card_id"`
+	Status     int    `json:"status"`
+	DurationMs int    `json:"duration_ms"`
+	Error      string `json:"error"`
+	CreatedAt  string `json:"created_at"`
+}
+
+// =============================================================================
+// DB helpers (modules + logs)
+// =============================================================================
+
+// listModulesEnabled returns all enabled modules with their config decrypted.
+// Disabled modules are silently skipped — callers iterate the result without
+// further filtering.
+func (db *DB) listModulesEnabled() ([]Module, error) {
+	return db.listModulesWhere("WHERE enabled = 1")
+}
+
+func (db *DB) listModulesAll() ([]Module, error) {
+	return db.listModulesWhere("")
+}
+
+func (db *DB) listModulesWhere(filter string) ([]Module, error) {
+	q := `SELECT id, name, kind, enabled, event_filter, config_cipher, config_nonce, created_at, updated_at FROM modules ` + filter + ` ORDER BY created_at`
+	rows, err := db.conn.Query(q)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	out := []Module{}
+	for rows.Next() {
+		var m Module
+		var enabled int
+		var filter, createdAt, updatedAt string
+		var cipherBlob, nonce []byte
+		if err := rows.Scan(&m.ID, &m.Name, &m.Kind, &enabled, &filter, &cipherBlob, &nonce, &createdAt, &updatedAt); err != nil {
+			return nil, err
+		}
+		m.Enabled = enabled == 1
+		m.EventFilter = splitCSV(filter)
+		m.CreatedAt = createdAt
+		m.UpdatedAt = updatedAt
+		cfg, err := decryptConfig(cipherBlob, nonce)
+		if err != nil {
+			// Surface the decrypt failure so the operator notices but
+			// avoid dropping the module from the list entirely.
+			log.Printf("module %s: decrypt config: %v", m.ID, err)
+			m.Config = JSONValue{"_decrypt_error": err.Error()}
+		} else {
+			_ = json.Unmarshal(cfg, &m.Config)
+		}
+		out = append(out, m)
+	}
+	return out, rows.Err()
+}
+
+func (db *DB) getModule(id string) (*Module, error) {
+	mods, err := db.listModulesWhere(`WHERE id = '` + escapeSQL(id) + `'`)
+	if err != nil || len(mods) == 0 {
+		if err == nil {
+			err = sql.ErrNoRows
+		}
+		return nil, err
+	}
+	return &mods[0], nil
+}
+
+func escapeSQL(s string) string {
+	return strings.ReplaceAll(s, "'", "''")
+}
+
+func (db *DB) saveModule(m *Module) error {
+	cfgJSON, err := json.Marshal(m.Config)
+	if err != nil {
+		return err
+	}
+	cipherBlob, nonce, err := encryptConfig(cfgJSON)
+	if err != nil {
+		return err
+	}
+	now := nowRFC3339()
+	if m.ID == "" {
+		m.ID = newID()
+		m.CreatedAt = now
+		m.UpdatedAt = now
+		_, err = db.conn.Exec(
+			`INSERT INTO modules (id, name, kind, enabled, event_filter, config_cipher, config_nonce, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+			m.ID, m.Name, m.Kind, boolInt(m.Enabled), strings.Join(m.EventFilter, ","),
+			cipherBlob, nonce, m.CreatedAt, m.UpdatedAt,
+		)
+		return err
+	}
+	m.UpdatedAt = now
+	_, err = db.conn.Exec(
+		`UPDATE modules SET name=?, kind=?, enabled=?, event_filter=?, config_cipher=?, config_nonce=?, updated_at=? WHERE id=?`,
+		m.Name, m.Kind, boolInt(m.Enabled), strings.Join(m.EventFilter, ","),
+		cipherBlob, nonce, m.UpdatedAt, m.ID,
+	)
+	return err
+}
+
+func (db *DB) deleteModule(id string) error {
+	_, err := db.conn.Exec(`DELETE FROM modules WHERE id=?`, id)
+	return err
+}
+
+func (db *DB) appendModuleLog(l ModuleLog) error {
+	if l.ID == "" {
+		l.ID = newID()
+	}
+	if l.CreatedAt == "" {
+		l.CreatedAt = nowRFC3339()
+	}
+	_, err := db.conn.Exec(
+		`INSERT INTO module_logs (id, module_id, event_type, card_id, status, duration_ms, error, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+		l.ID, l.ModuleID, l.EventType, l.CardID, l.Status, l.DurationMs, l.Error, l.CreatedAt,
+	)
+	return err
+}
+
+func (db *DB) listModuleLogs(moduleID string, limit int) ([]ModuleLog, error) {
+	if limit <= 0 {
+		limit = 100
+	}
+	rows, err := db.conn.Query(
+		`SELECT id, module_id, event_type, card_id, status, duration_ms, error, created_at
+		 FROM module_logs WHERE module_id = ? ORDER BY created_at DESC LIMIT ?`,
+		moduleID, limit,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	out := []ModuleLog{}
+	for rows.Next() {
+		var l ModuleLog
+		var cardID sql.NullString
+		if err := rows.Scan(&l.ID, &l.ModuleID, &l.EventType, &cardID, &l.Status, &l.DurationMs, &l.Error, &l.CreatedAt); err != nil {
+			return nil, err
+		}
+		if cardID.Valid {
+			l.CardID = cardID.String
+		}
+		out = append(out, l)
+	}
+	return out, rows.Err()
+}
+
+// setCardJiraKey stores the Jira issue key for a card after a successful
+// create call. We skip the regular UpdateCard path to avoid emitting a
+// `card.updated` event (which would loop us back through the dispatcher).
+func (db *DB) setCardJiraKey(cardID, jiraKey string) error {
+	_, err := db.conn.Exec(`UPDATE cards SET jira_key=? WHERE id=?`, jiraKey, cardID)
+	return err
+}
+
+func (db *DB) getCardForJira(cardID string) (*cardForJira, error) {
+	var c cardForJira
+	var assignee, deadline, jiraKey sql.NullString
+	var tagsJSON string
+	err := db.conn.QueryRow(
+		`SELECT c.id, c.title, c.description, c.requester, c.column_id, c.assignee_id,
+		        c.deadline, c.tags, c.jira_key, c.created_at, col.name
+		 FROM cards c JOIN columns col ON col.id = c.column_id WHERE c.id = ?`,
+		cardID,
+	).Scan(&c.ID, &c.Title, &c.Description, &c.Requester, &c.ColumnID, &assignee,
+		&deadline, &tagsJSON, &jiraKey, &c.CreatedAt, &c.ColumnName)
+	if err != nil {
+		return nil, err
+	}
+	if assignee.Valid {
+		c.AssigneeID = assignee.String
+	}
+	if deadline.Valid {
+		c.Deadline = deadline.String
+	}
+	if jiraKey.Valid {
+		c.JiraKey = jiraKey.String
+	}
+	_ = json.Unmarshal([]byte(tagsJSON), &c.Tags)
+	return &c, nil
+}
+
+type cardForJira struct {
+	ID          string
+	Title       string
+	Description string
+	Requester   string
+	ColumnID    string
+	ColumnName  string
+	AssigneeID  string
+	Deadline    string
+	Tags        []string
+	JiraKey     string
+	CreatedAt   string
+}
+
+func (c *cardForJira) hasTag(name string) bool {
+	name = strings.ToLower(name)
+	for _, t := range c.Tags {
+		if strings.ToLower(t) == name {
+			return true
+		}
+	}
+	return false
+}
+
+func splitCSV(s string) []string {
+	if s == "" {
+		return nil
+	}
+	parts := strings.Split(s, ",")
+	out := make([]string, 0, len(parts))
+	for _, p := range parts {
+		p = strings.TrimSpace(p)
+		if p != "" {
+			out = append(out, p)
+		}
+	}
+	return out
+}
+
+func boolInt(b bool) int {
+	if b {
+		return 1
+	}
+	return 0
+}
+
+// =============================================================================
+// Dispatcher
+// =============================================================================
+
+const (
+	moduleRetries       = 3
+	moduleRetryDelay1   = 1 * time.Second
+	moduleRetryDelay2   = 5 * time.Second
+	moduleRetryDelay3   = 30 * time.Second
+	moduleHTTPTimeout   = 15 * time.Second
+	moduleOptOutTag     = "nojira"
+	moduleDispatchQueue = 256
+)
+
+// Dispatcher fans events from the EventHub into per-module handlers.
+//
+// Lifecycle:
+//   - Start() spawns a single subscriber goroutine on the hub plus a
+//     bounded worker pool.
+//   - Stop() cancels the context and waits for in-flight requests to drain.
+//
+// Handlers receive a decrypted Module copy + the Event; they own the HTTP
+// call to the target system. The dispatcher logs every attempt.
+type Dispatcher struct {
+	db       *DB
+	hub      *EventHub
+	handlers map[string]Handler
+	queue    chan dispatchTask
+	ctx      context.Context
+	cancel   context.CancelFunc
+	enabled  bool
+}
+
+type dispatchTask struct {
+	module Module
+	event  Event
+}
+
+type Handler interface {
+	Handle(ctx context.Context, db *DB, m Module, ev Event) (status int, err error)
+	TestConnection(ctx context.Context, m Module) (status int, err error)
+}
+
+func NewDispatcher(db *DB, hub *EventHub) *Dispatcher {
+	_, hasKey := moduleKey()
+	return &Dispatcher{
+		db:       db,
+		hub:      hub,
+		handlers: map[string]Handler{"jira": &jiraHandler{}},
+		queue:    make(chan dispatchTask, moduleDispatchQueue),
+		enabled:  hasKey,
+	}
+}
+
+func (d *Dispatcher) Start() {
+	if !d.enabled {
+		log.Printf("module dispatcher disabled (%s not set)", moduleKeyEnv)
+		return
+	}
+	d.ctx, d.cancel = context.WithCancel(context.Background())
+	// Subscribe under a synthetic user so the hub treats us as a normal
+	// recipient of broadcast events. Private user-targeted events are
+	// uninteresting for outbound sync.
+	go d.run()
+	for i := 0; i < 4; i++ {
+		go d.worker(i)
+	}
+	log.Printf("module dispatcher started")
+}
+
+func (d *Dispatcher) Stop() {
+	if d.cancel != nil {
+		d.cancel()
+	}
+}
+
+func (d *Dispatcher) run() {
+	ch := d.hub.SubscribeUser("__module_dispatcher__")
+	defer d.hub.UnsubscribeUser("__module_dispatcher__", ch)
+	for {
+		select {
+		case <-d.ctx.Done():
+			return
+		case ev, ok := <-ch:
+			if !ok {
+				return
+			}
+			d.fanout(ev)
+		}
+	}
+}
+
+func (d *Dispatcher) fanout(ev Event) {
+	mods, err := d.db.listModulesEnabled()
+	if err != nil {
+		log.Printf("dispatcher: listModulesEnabled: %v", err)
+		return
+	}
+	for _, m := range mods {
+		if !filterMatches(m.EventFilter, ev.Type) {
+			continue
+		}
+		if !cutoffOK(d.db, m, ev) {
+			continue
+		}
+		if ev.CardID != "" {
+			c, err := d.db.getCardForJira(ev.CardID)
+			if err == nil && c.hasTag(moduleOptOutTag) {
+				continue
+			}
+		}
+		select {
+		case d.queue <- dispatchTask{module: m, event: ev}:
+		default:
+			log.Printf("dispatcher: queue full, dropping event %s for module %s", ev.Type, m.ID)
+		}
+	}
+}
+
+func (d *Dispatcher) worker(id int) {
+	for {
+		select {
+		case <-d.ctx.Done():
+			return
+		case task, ok := <-d.queue:
+			if !ok {
+				return
+			}
+			d.dispatch(task)
+		}
+	}
+}
+
+// dispatch runs the handler with up to moduleRetries attempts using a
+// fixed back-off schedule (1s, 5s, 30s). Each attempt creates a log row;
+// the final outcome is the one returned to the caller.
+func (d *Dispatcher) dispatch(t dispatchTask) {
+	h, ok := d.handlers[t.module.Kind]
+	if !ok {
+		_ = d.db.appendModuleLog(ModuleLog{
+			ModuleID: t.module.ID, EventType: t.event.Type, CardID: t.event.CardID,
+			Error: "unknown module kind: " + t.module.Kind,
+		})
+		return
+	}
+	delays := []time.Duration{0, moduleRetryDelay1, moduleRetryDelay2, moduleRetryDelay3}
+	for attempt := 0; attempt < moduleRetries; attempt++ {
+		if delays[attempt] > 0 {
+			select {
+			case <-d.ctx.Done():
+				return
+			case <-time.After(delays[attempt]):
+			}
+		}
+		ctx, cancel := context.WithTimeout(d.ctx, moduleHTTPTimeout)
+		start := time.Now()
+		status, err := h.Handle(ctx, d.db, t.module, t.event)
+		cancel()
+		ml := ModuleLog{
+			ModuleID: t.module.ID, EventType: t.event.Type, CardID: t.event.CardID,
+			Status: status, DurationMs: int(time.Since(start).Milliseconds()),
+		}
+		if err != nil {
+			ml.Error = err.Error()
+		}
+		_ = d.db.appendModuleLog(ml)
+		if err == nil {
+			return
+		}
+		// 4xx client errors are not worth retrying.
+		if status >= 400 && status < 500 {
+			return
+		}
+	}
+}
+
+// =============================================================================
+// Helpers
+// =============================================================================
+
+func filterMatches(filter []string, eventType string) bool {
+	for _, f := range filter {
+		if f == eventType || f == "*" {
+			return true
+		}
+	}
+	return false
+}
+
+// cutoffOK applies the "module only sees events posterior to its creation"
+// rule. Cards that were already linked to Jira (jira_key != "") are always
+// eligible regardless of timestamps.
+func cutoffOK(db *DB, m Module, ev Event) bool {
+	if ev.CardID == "" {
+		return true
+	}
+	c, err := db.getCardForJira(ev.CardID)
+	if err != nil {
+		return false
+	}
+	if c.JiraKey != "" {
+		return true
+	}
+	return c.CreatedAt >= m.CreatedAt
+}
+
+// =============================================================================
+// Jira handler
+// =============================================================================
+
+type jiraHandler struct{}
+
+type jiraConfig struct {
+	BaseURL    string            `json:"base_url"`
+	Email      string            `json:"email"`
+	APIToken   string            `json:"api_token"`
+	ProjectKey string            `json:"project_key"`
+	StatusMap  map[string]string `json:"status_map"`
+}
+
+func parseJiraConfig(m Module) (jiraConfig, error) {
+	b, err := json.Marshal(m.Config)
+	if err != nil {
+		return jiraConfig{}, err
+	}
+	var c jiraConfig
+	if err := json.Unmarshal(b, &c); err != nil {
+		return jiraConfig{}, err
+	}
+	c.BaseURL = strings.TrimRight(c.BaseURL, "/")
+	if c.BaseURL == "" {
+		return c, fmt.Errorf("base_url required")
+	}
+	return c, nil
+}
+
+func (h *jiraHandler) jiraRequest(ctx context.Context, c jiraConfig, method, path string, body interface{}) (int, []byte, error) {
+	var rdr io.Reader
+	if body != nil {
+		b, err := json.Marshal(body)
+		if err != nil {
+			return 0, nil, err
+		}
+		rdr = bytes.NewReader(b)
+	}
+	req, err := http.NewRequestWithContext(ctx, method, c.BaseURL+path, rdr)
+	if err != nil {
+		return 0, nil, err
+	}
+	req.Header.Set("Accept", "application/json")
+	if body != nil {
+		req.Header.Set("Content-Type", "application/json")
+	}
+	if c.Email != "" && c.APIToken != "" {
+		basic := base64.StdEncoding.EncodeToString([]byte(c.Email + ":" + c.APIToken))
+		req.Header.Set("Authorization", "Basic "+basic)
+	}
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		return 0, nil, err
+	}
+	defer resp.Body.Close()
+	respBody, _ := io.ReadAll(io.LimitReader(resp.Body, 1<<20))
+	if resp.StatusCode >= 400 {
+		return resp.StatusCode, respBody, fmt.Errorf("jira %s %s: %d %s", method, path, resp.StatusCode, truncate(respBody, 240))
+	}
+	return resp.StatusCode, respBody, nil
+}
+
+func truncate(b []byte, n int) string {
+	if len(b) <= n {
+		return string(b)
+	}
+	return string(b[:n]) + "…"
+}
+
+func (h *jiraHandler) TestConnection(ctx context.Context, m Module) (int, error) {
+	c, err := parseJiraConfig(m)
+	if err != nil {
+		return 0, err
+	}
+	status, _, err := h.jiraRequest(ctx, c, http.MethodGet, "/rest/api/3/myself", nil)
+	return status, err
+}
+
+func (h *jiraHandler) Handle(ctx context.Context, db *DB, m Module, ev Event) (int, error) {
+	c, err := parseJiraConfig(m)
+	if err != nil {
+		return 0, err
+	}
+	switch ev.Type {
+	case "card.created":
+		return h.create(ctx, db, c, ev)
+	case "card.updated", "board.invalidated":
+		return h.update(ctx, db, c, ev)
+	case "card.moved":
+		return h.transition(ctx, db, c, ev)
+	case "message.created":
+		return h.comment(ctx, db, c, ev)
+	default:
+		// Silently ignore unhandled event types so the dispatcher does not
+		// retry on irrelevant traffic.
+		return 200, nil
+	}
+}
+
+func (h *jiraHandler) create(ctx context.Context, db *DB, c jiraConfig, ev Event) (int, error) {
+	if ev.CardID == "" {
+		return 0, nil
+	}
+	card, err := db.getCardForJira(ev.CardID)
+	if err != nil {
+		return 0, err
+	}
+	if card.JiraKey != "" {
+		// Idempotent: card already linked to Jira; treat as update.
+		return h.update(ctx, db, c, ev)
+	}
+	if c.ProjectKey == "" {
+		return 0, fmt.Errorf("project_key required for create")
+	}
+	body := map[string]interface{}{
+		"fields": map[string]interface{}{
+			"project":     map[string]string{"key": c.ProjectKey},
+			"summary":     card.Title,
+			"description": adfText(card.Description),
+			"issuetype":   map[string]string{"name": "Task"},
+		},
+	}
+	status, resp, err := h.jiraRequest(ctx, c, http.MethodPost, "/rest/api/3/issue", body)
+	if err != nil {
+		return status, err
+	}
+	var parsed struct {
+		Key string `json:"key"`
+	}
+	_ = json.Unmarshal(resp, &parsed)
+	if parsed.Key != "" {
+		if err := db.setCardJiraKey(card.ID, parsed.Key); err != nil {
+			return status, fmt.Errorf("link jira key: %w", err)
+		}
+	}
+	return status, nil
+}
+
+func (h *jiraHandler) update(ctx context.Context, db *DB, c jiraConfig, ev Event) (int, error) {
+	if ev.CardID == "" {
+		return 0, nil
+	}
+	card, err := db.getCardForJira(ev.CardID)
+	if err != nil {
+		return 0, err
+	}
+	if card.JiraKey == "" {
+		// Card not yet linked — bootstrap by creating it.
+		return h.create(ctx, db, c, ev)
+	}
+	body := map[string]interface{}{
+		"fields": map[string]interface{}{
+			"summary":     card.Title,
+			"description": adfText(card.Description),
+		},
+	}
+	status, _, err := h.jiraRequest(ctx, c, http.MethodPut, "/rest/api/3/issue/"+card.JiraKey, body)
+	return status, err
+}
+
+// transition uses the configured status_map to translate the kanban column
+// to a Jira transition name. We list available transitions, find the one
+// whose target status name matches, and POST it. Kanban remains the source
+// of truth even if Jira's current state differs.
+func (h *jiraHandler) transition(ctx context.Context, db *DB, c jiraConfig, ev Event) (int, error) {
+	if ev.CardID == "" {
+		return 0, nil
+	}
+	card, err := db.getCardForJira(ev.CardID)
+	if err != nil {
+		return 0, err
+	}
+	if card.JiraKey == "" {
+		return h.create(ctx, db, c, ev)
+	}
+	target, ok := c.StatusMap[card.ColumnName]
+	if !ok || target == "" {
+		return 0, fmt.Errorf("no status_map entry for column %q", card.ColumnName)
+	}
+	status, body, err := h.jiraRequest(ctx, c, http.MethodGet, "/rest/api/3/issue/"+card.JiraKey+"/transitions", nil)
+	if err != nil {
+		return status, err
+	}
+	var available struct {
+		Transitions []struct {
+			ID   string `json:"id"`
+			Name string `json:"name"`
+			To   struct {
+				Name string `json:"name"`
+			} `json:"to"`
+		} `json:"transitions"`
+	}
+	if err := json.Unmarshal(body, &available); err != nil {
+		return status, fmt.Errorf("decode transitions: %w", err)
+	}
+	var tID string
+	for _, t := range available.Transitions {
+		if strings.EqualFold(t.To.Name, target) || strings.EqualFold(t.Name, target) {
+			tID = t.ID
+			break
+		}
+	}
+	if tID == "" {
+		return 0, fmt.Errorf("transition %q not available for %s", target, card.JiraKey)
+	}
+	req := map[string]interface{}{"transition": map[string]string{"id": tID}}
+	status, _, err = h.jiraRequest(ctx, c, http.MethodPost, "/rest/api/3/issue/"+card.JiraKey+"/transitions", req)
+	return status, err
+}
+
+func (h *jiraHandler) comment(ctx context.Context, db *DB, c jiraConfig, ev Event) (int, error) {
+	if ev.CardID == "" {
+		return 0, nil
+	}
+	card, err := db.getCardForJira(ev.CardID)
+	if err != nil {
+		return 0, err
+	}
+	if card.JiraKey == "" {
+		// Cannot comment on a card not yet synced; skip.
+		return 0, nil
+	}
+	var payload struct {
+		Body string `json:"body"`
+	}
+	_ = json.Unmarshal(ev.Payload, &payload)
+	if payload.Body == "" {
+		return 0, nil
+	}
+	body := map[string]interface{}{"body": adfText(payload.Body)}
+	status, _, err := h.jiraRequest(ctx, c, http.MethodPost, "/rest/api/3/issue/"+card.JiraKey+"/comment", body)
+	return status, err
+}
+
+// adfText wraps a plain string into the minimal Atlassian Document Format
+// fragment Jira Cloud requires for description / comment bodies.
+func adfText(s string) map[string]interface{} {
+	return map[string]interface{}{
+		"type":    "doc",
+		"version": 1,
+		"content": []map[string]interface{}{{
+			"type": "paragraph",
+			"content": []map[string]interface{}{{
+				"type": "text",
+				"text": s,
+			}},
+		}},
+	}
+}
@@ -0,0 +1,68 @@
+package main
+
+import (
+	"crypto/aes"
+	"crypto/cipher"
+	"crypto/rand"
+	"crypto/sha256"
+	"errors"
+	"fmt"
+	"io"
+	"os"
+)
+
+const moduleKeyEnv = "KANBAN_MODULE_KEY"
+
+// moduleKey derives a 32-byte AES key from the KANBAN_MODULE_KEY env var.
+// Returns (key, true) when present; (zero, false) when missing — callers
+// must treat that as "module dispatcher disabled".
+func moduleKey() ([32]byte, bool) {
+	v := os.Getenv(moduleKeyEnv)
+	if v == "" {
+		return [32]byte{}, false
+	}
+	return sha256.Sum256([]byte(v)), true
+}
+
+// encryptConfig encrypts a JSON config blob with AES-GCM. Returns the
+// ciphertext and the 12-byte nonce. Caller persists both columns.
+func encryptConfig(plain []byte) (cipherOut, nonce []byte, err error) {
+	key, ok := moduleKey()
+	if !ok {
+		return nil, nil, fmt.Errorf("%s not set; cannot encrypt module config", moduleKeyEnv)
+	}
+	block, err := aes.NewCipher(key[:])
+	if err != nil {
+		return nil, nil, err
+	}
+	gcm, err := cipher.NewGCM(block)
+	if err != nil {
+		return nil, nil, err
+	}
+	nonce = make([]byte, gcm.NonceSize())
+	if _, err := io.ReadFull(rand.Reader, nonce); err != nil {
+		return nil, nil, err
+	}
+	cipherOut = gcm.Seal(nil, nonce, plain, nil)
+	return cipherOut, nonce, nil
+}
+
+// decryptConfig is the inverse of encryptConfig.
+func decryptConfig(cipherIn, nonce []byte) ([]byte, error) {
+	key, ok := moduleKey()
+	if !ok {
+		return nil, fmt.Errorf("%s not set; cannot decrypt module config", moduleKeyEnv)
+	}
+	if len(nonce) == 0 {
+		return nil, errors.New("nonce empty")
+	}
+	block, err := aes.NewCipher(key[:])
+	if err != nil {
+		return nil, err
+	}
+	gcm, err := cipher.NewGCM(block)
+	if err != nil {
+		return nil, err
+	}
+	return gcm.Open(nil, nonce, cipherIn, nil)
+}
@@ -0,0 +1,226 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"net/http"
+	"strconv"
+	"strings"
+	"time"
+
+	"fn-registry/functions/infra"
+)
+
+// requireAdmin gates a handler so only users with users.is_admin = 1 can
+// reach it. Non-admins get a 403. Anonymous callers get a 401.
+func requireAdmin(db *DB, next http.HandlerFunc) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		uid, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		if uid == "" {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "session required"})
+			return
+		}
+		ok, err := db.IsAdmin(uid)
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		if !ok {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusForbidden, Code: "forbidden", Message: "admin required"})
+			return
+		}
+		next(w, r)
+	}
+}
+
+// publicModule strips secrets out of the config before responding. The
+// API token is never returned to the client after it has been stored.
+func publicModule(m Module) Module {
+	clone := m
+	if clone.Config != nil {
+		cleaned := JSONValue{}
+		for k, v := range clone.Config {
+			if strings.Contains(strings.ToLower(k), "token") || strings.Contains(strings.ToLower(k), "password") || strings.Contains(strings.ToLower(k), "secret") {
+				cleaned[k] = "***"
+			} else {
+				cleaned[k] = v
+			}
+		}
+		clone.Config = cleaned
+	}
+	return clone
+}
+
+func handleListModules(db *DB) http.HandlerFunc {
+	return requireAdmin(db, func(w http.ResponseWriter, r *http.Request) {
+		mods, err := db.listModulesAll()
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		out := make([]Module, 0, len(mods))
+		for _, m := range mods {
+			out = append(out, publicModule(m))
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, out)
+	})
+}
+
+type modulePayload struct {
+	Name        string    `json:"name"`
+	Kind        string    `json:"kind"`
+	Enabled     bool      `json:"enabled"`
+	EventFilter []string  `json:"event_filter"`
+	Config      JSONValue `json:"config"`
+}
+
+func handleCreateModule(db *DB) http.HandlerFunc {
+	return requireAdmin(db, func(w http.ResponseWriter, r *http.Request) {
+		var body modulePayload
+		if err := infra.HTTPParseBody(r, &body, maxBodyBytes); err != nil {
+			badRequest(w, err.Error())
+			return
+		}
+		if body.Name == "" || body.Kind == "" {
+			badRequest(w, "name and kind required")
+			return
+		}
+		m := &Module{
+			Name: body.Name, Kind: body.Kind, Enabled: body.Enabled,
+			EventFilter: body.EventFilter, Config: body.Config,
+		}
+		if err := db.saveModule(m); err != nil {
+			serverError(w, err)
+			return
+		}
+		infra.HTTPJSONResponse(w, http.StatusCreated, publicModule(*m))
+	})
+}
+
+func handleUpdateModule(db *DB) http.HandlerFunc {
+	return requireAdmin(db, func(w http.ResponseWriter, r *http.Request) {
+		id := r.PathValue("id")
+		existing, err := db.getModule(id)
+		if err != nil {
+			notFound(w, "module not found")
+			return
+		}
+		// Partial body: preserve fields the client did not include. We rely
+		// on a generic map to detect omitted vs explicit-null because PATCH
+		// callers do not always send the full record.
+		var raw map[string]json.RawMessage
+		if err := infra.HTTPParseBody(r, &raw, maxBodyBytes); err != nil {
+			badRequest(w, err.Error())
+			return
+		}
+		decode := func(key string, into interface{}) {
+			if v, ok := raw[key]; ok {
+				_ = json.Unmarshal(v, into)
+			}
+		}
+		decode("name", &existing.Name)
+		decode("kind", &existing.Kind)
+		decode("enabled", &existing.Enabled)
+		if v, ok := raw["event_filter"]; ok {
+			_ = json.Unmarshal(v, &existing.EventFilter)
+		}
+		if v, ok := raw["config"]; ok {
+			var cfg JSONValue
+			_ = json.Unmarshal(v, &cfg)
+			// Re-inject masked fields the UI left as "***" so a partial
+			// edit does not nuke stored secrets.
+			merged := JSONValue{}
+			for k, val := range existing.Config {
+				merged[k] = val
+			}
+			for k, val := range cfg {
+				if s, isStr := val.(string); isStr && s == "***" {
+					continue
+				}
+				merged[k] = val
+			}
+			existing.Config = merged
+		}
+		if err := db.saveModule(existing); err != nil {
+			serverError(w, err)
+			return
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, publicModule(*existing))
+	})
+}
+
+func handleDeleteModule(db *DB) http.HandlerFunc {
+	return requireAdmin(db, func(w http.ResponseWriter, r *http.Request) {
+		id := r.PathValue("id")
+		if err := db.deleteModule(id); err != nil {
+			serverError(w, err)
+			return
+		}
+		w.WriteHeader(http.StatusNoContent)
+	})
+}
+
+func handleModuleLogs(db *DB) http.HandlerFunc {
+	return requireAdmin(db, func(w http.ResponseWriter, r *http.Request) {
+		id := r.PathValue("id")
+		limit := 100
+		if v := r.URL.Query().Get("limit"); v != "" {
+			if n, err := strconv.Atoi(v); err == nil && n > 0 && n <= 1000 {
+				limit = n
+			}
+		}
+		out, err := db.listModuleLogs(id, limit)
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, out)
+	})
+}
+
+// handleTestModule executes the kind-specific test_connection probe with
+// the *current stored config* (or with an incoming config payload, for
+// pre-save validation). Returns {ok, status, error} regardless of outcome
+// so the UI can show a useful message.
+func handleTestModule(db *DB, dispatcher *Dispatcher) http.HandlerFunc {
+	return requireAdmin(db, func(w http.ResponseWriter, r *http.Request) {
+		id := r.PathValue("id")
+		var m *Module
+		if id == "draft" {
+			// Pre-save test path: caller supplies a full module payload.
+			var body modulePayload
+			if err := infra.HTTPParseBody(r, &body, maxBodyBytes); err != nil {
+				badRequest(w, err.Error())
+				return
+			}
+			m = &Module{Kind: body.Kind, Config: body.Config}
+		} else {
+			got, err := db.getModule(id)
+			if err != nil {
+				notFound(w, "module not found")
+				return
+			}
+			m = got
+		}
+		h, ok := dispatcher.handlers[m.Kind]
+		if !ok {
+			infra.HTTPJSONResponse(w, http.StatusOK, map[string]interface{}{
+				"ok": false, "status": 0, "error": "unknown kind: " + m.Kind,
+			})
+			return
+		}
+		ctx, cancel := context.WithTimeout(r.Context(), moduleHTTPTimeout)
+		defer cancel()
+		start := time.Now()
+		status, err := h.TestConnection(ctx, *m)
+		resp := map[string]interface{}{
+			"ok":          err == nil,
+			"status":      status,
+			"duration_ms": int(time.Since(start).Milliseconds()),
+		}
+		if err != nil {
+			resp["error"] = err.Error()
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, resp)
+	})
+}
@@ -0,0 +1,227 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"io"
+	"net/http"
+	"net/http/httptest"
+	"os"
+	"strings"
+	"testing"
+	"time"
+)
+
+// withModuleKey sets KANBAN_MODULE_KEY for the duration of a test and
+// restores the previous value afterwards.
+func withModuleKey(t *testing.T, value string) {
+	t.Helper()
+	prev := os.Getenv(moduleKeyEnv)
+	t.Setenv(moduleKeyEnv, value)
+	t.Cleanup(func() { _ = os.Setenv(moduleKeyEnv, prev) })
+}
+
+func TestCryptoRoundTrip(t *testing.T) {
+	withModuleKey(t, "test-passphrase")
+	plain := []byte(`{"hello":"world"}`)
+	cipherBlob, nonce, err := encryptConfig(plain)
+	if err != nil {
+		t.Fatalf("encrypt: %v", err)
+	}
+	got, err := decryptConfig(cipherBlob, nonce)
+	if err != nil {
+		t.Fatalf("decrypt: %v", err)
+	}
+	if string(got) != string(plain) {
+		t.Fatalf("roundtrip mismatch: got %q want %q", got, plain)
+	}
+}
+
+func TestCryptoMissingKey(t *testing.T) {
+	t.Setenv(moduleKeyEnv, "")
+	if _, _, err := encryptConfig([]byte("x")); err == nil {
+		t.Fatal("expected error when KANBAN_MODULE_KEY unset")
+	}
+}
+
+func TestSaveAndLoadModule(t *testing.T) {
+	withModuleKey(t, "test-passphrase")
+	db := setupTestDB(t)
+	m := &Module{
+		Name: "jira-test", Kind: "jira", Enabled: true,
+		EventFilter: []string{"card.created", "card.moved"},
+		Config: JSONValue{
+			"base_url": "https://example.atlassian.net",
+			"email":    "x@y.z",
+			"api_token": "secret-123",
+		},
+	}
+	if err := db.saveModule(m); err != nil {
+		t.Fatalf("save: %v", err)
+	}
+	if m.ID == "" {
+		t.Fatal("ID not assigned on insert")
+	}
+	got, err := db.getModule(m.ID)
+	if err != nil {
+		t.Fatalf("get: %v", err)
+	}
+	if got.Config["api_token"] != "secret-123" {
+		t.Fatalf("token roundtrip failed: %v", got.Config["api_token"])
+	}
+}
+
+func TestFilterMatches(t *testing.T) {
+	if !filterMatches([]string{"card.created"}, "card.created") {
+		t.Fatal("exact match")
+	}
+	if !filterMatches([]string{"*"}, "anything") {
+		t.Fatal("wildcard")
+	}
+	if filterMatches([]string{"card.created"}, "card.moved") {
+		t.Fatal("non-match should be false")
+	}
+}
+
+func TestCardOptOutTag(t *testing.T) {
+	c := cardForJira{Tags: []string{"foo", "NoJira", "bar"}}
+	if !c.hasTag("nojira") {
+		t.Fatal("nojira (case-insensitive) not detected")
+	}
+	if c.hasTag("missing") {
+		t.Fatal("missing tag returned true")
+	}
+}
+
+func TestJiraHandler_TransitionMappingMissing(t *testing.T) {
+	withModuleKey(t, "k")
+	db := setupTestDB(t)
+	col, _ := db.CreateColumn("Backlog")
+	card, _ := db.CreateCard(col.ID, "req", "t", "d", "")
+	// Link the card so the create-fallback path is skipped.
+	_ = db.setCardJiraKey(card.ID, "KAN-1")
+	h := &jiraHandler{}
+	_, err := h.transition(context.Background(), db, jiraConfig{BaseURL: "http://x"}, Event{Type: "card.moved", CardID: card.ID})
+	if err == nil || !strings.Contains(err.Error(), "status_map") {
+		t.Fatalf("expected status_map error, got %v", err)
+	}
+}
+
+func TestJiraHandler_TestConnectionHitsMyself(t *testing.T) {
+	var path string
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		path = r.URL.Path
+		w.WriteHeader(http.StatusOK)
+		_, _ = io.WriteString(w, `{"accountId":"abc"}`)
+	}))
+	defer srv.Close()
+	h := &jiraHandler{}
+	m := Module{Kind: "jira", Config: JSONValue{
+		"base_url":  srv.URL,
+		"email":     "x@y.z",
+		"api_token": "tok",
+	}}
+	status, err := h.TestConnection(context.Background(), m)
+	if err != nil {
+		t.Fatalf("TestConnection: %v", err)
+	}
+	if status != 200 {
+		t.Fatalf("status = %d, want 200", status)
+	}
+	if path != "/rest/api/3/myself" {
+		t.Fatalf("path = %q, want /rest/api/3/myself", path)
+	}
+}
+
+func TestJiraHandler_CreateLinksCardKey(t *testing.T) {
+	withModuleKey(t, "test-passphrase")
+	db := setupTestDB(t)
+	user, _ := db.CreateUser("alice", "passw", "Alice")
+	col, _ := db.CreateColumn("Todo")
+	card, _ := db.CreateCard(col.ID, "req", "Buy bread", "desc", user.ID)
+
+	srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if r.Method == http.MethodPost && r.URL.Path == "/rest/api/3/issue" {
+			b, _ := io.ReadAll(r.Body)
+			var p struct {
+				Fields struct {
+					Summary string `json:"summary"`
+				} `json:"fields"`
+			}
+			_ = json.Unmarshal(b, &p)
+			if p.Fields.Summary != "Buy bread" {
+				t.Errorf("summary = %q", p.Fields.Summary)
+			}
+			w.WriteHeader(http.StatusCreated)
+			_, _ = io.WriteString(w, `{"id":"10000","key":"KAN-1"}`)
+			return
+		}
+		w.WriteHeader(http.StatusNotFound)
+	}))
+	defer srv.Close()
+
+	h := &jiraHandler{}
+	mod := Module{Kind: "jira", Config: JSONValue{
+		"base_url":    srv.URL,
+		"email":       "x@y.z",
+		"api_token":   "tok",
+		"project_key": "KAN",
+		"status_map":  map[string]interface{}{"Todo": "To Do"},
+	}}
+	status, err := h.Handle(context.Background(), db, mod, Event{Type: "card.created", CardID: card.ID})
+	if err != nil {
+		t.Fatalf("Handle: %v", err)
+	}
+	if status != http.StatusCreated {
+		t.Fatalf("status = %d, want 201", status)
+	}
+	again, err := db.getCardForJira(card.ID)
+	if err != nil {
+		t.Fatalf("get card: %v", err)
+	}
+	if again.JiraKey != "KAN-1" {
+		t.Fatalf("jira_key = %q, want KAN-1", again.JiraKey)
+	}
+}
+
+func TestDispatcher_Cutoff(t *testing.T) {
+	withModuleKey(t, "k")
+	db := setupTestDB(t)
+	col, _ := db.CreateColumn("Todo")
+	// Create card BEFORE the module so cutoffOK rejects it.
+	card, _ := db.CreateCard(col.ID, "req", "t", "d", "")
+	time.Sleep(20 * time.Millisecond)
+	mod := Module{ID: "m", CreatedAt: nowRFC3339()}
+	if cutoffOK(db, mod, Event{CardID: card.ID}) {
+		t.Fatal("card pre-dating module should be filtered out")
+	}
+	// Once linked, cutoff should allow it.
+	_ = db.setCardJiraKey(card.ID, "KAN-9")
+	if !cutoffOK(db, mod, Event{CardID: card.ID}) {
+		t.Fatal("linked card must pass cutoff even if older")
+	}
+}
+
+func TestIsAdmin(t *testing.T) {
+	db := setupTestDB(t)
+	u, _ := db.CreateUser("egutierrez", "passw", "Egu")
+	// Migration 015 marks egutierrez admin via UPDATE WHERE username, but
+	// that only takes effect when the row already exists. In production
+	// the migration runs against an existing user list; in tests we create
+	// users after migration, so simulate the same outcome explicitly.
+	if _, err := db.conn.Exec(`UPDATE users SET is_admin = 1 WHERE username = ?`, "egutierrez"); err != nil {
+		t.Fatalf("seed admin: %v", err)
+	}
+	ok, err := db.IsAdmin(u.ID)
+	if err != nil {
+		t.Fatalf("IsAdmin: %v", err)
+	}
+	if !ok {
+		t.Fatal("egutierrez must be admin after seed")
+	}
+	other, _ := db.CreateUser("alice", "passw", "Alice")
+	ok, _ = db.IsAdmin(other.ID)
+	if ok {
+		t.Fatal("alice must not be admin by default")
+	}
+}
@@ -0,0 +1,328 @@
+package main
+
+import (
+	"database/sql"
+	"fmt"
+	"regexp"
+	"strings"
+	"time"
+)
+
+// Notification kinds, ordered by priority (highest first). When a single
+// message triggers multiple kinds for one user, the highest-priority kind
+// is the one persisted.
+const (
+	NotifKindMention      = "mention"
+	NotifKindAssignedChat = "assigned_chat"
+	NotifKindReply        = "reply"
+)
+
+func notifKindPriority(k string) int {
+	switch k {
+	case NotifKindMention:
+		return 3
+	case NotifKindAssignedChat:
+		return 2
+	case NotifKindReply:
+		return 1
+	}
+	return 0
+}
+
+type Notification struct {
+	ID         string  `json:"id"`
+	UserID     string  `json:"user_id"`
+	CardID     string  `json:"card_id"`
+	MessageID  string  `json:"message_id"`
+	Kind       string  `json:"kind"`
+	ActorID    string  `json:"actor_id"`
+	CreatedAt  string  `json:"created_at"`
+	ReadAt     *string `json:"read_at"`
+	CardTitle  string  `json:"card_title"`
+	CardSeqNum int     `json:"card_seq_num"`
+	ActorName  string  `json:"actor_name"`
+	Snippet    string  `json:"snippet"`
+}
+
+type CardMention struct {
+	ID        string `json:"id"`
+	CardID    string `json:"card_id"`
+	MessageID string `json:"message_id"`
+	UserID    string `json:"user_id"`
+	CreatedAt string `json:"created_at"`
+}
+
+var mentionRe = regexp.MustCompile(`(?i)@([a-z0-9][a-z0-9_.-]{0,63})`)
+
+// extractMentions returns the set of @usernames referenced in body, lowercased.
+// The leading '@' is not included. Each username is returned at most once.
+func extractMentions(body string) []string {
+	matches := mentionRe.FindAllStringSubmatch(body, -1)
+	if len(matches) == 0 {
+		return nil
+	}
+	seen := map[string]struct{}{}
+	out := make([]string, 0, len(matches))
+	for _, m := range matches {
+		u := strings.ToLower(m[1])
+		if _, ok := seen[u]; ok {
+			continue
+		}
+		seen[u] = struct{}{}
+		out = append(out, u)
+	}
+	return out
+}
+
+// CreateCardMessageAndNotify wraps CreateCardMessage with mention parsing,
+// notification fan-out and pub/sub publication. The returned slice contains
+// the user_ids that received a notification (useful for tests).
+func (db *DB) CreateCardMessageAndNotify(cardID, authorID, body string, hub *EventHub) (*CardMessage, []Notification, []CardMention, error) {
+	msg, err := db.CreateCardMessage(cardID, authorID, body)
+	if err != nil {
+		return nil, nil, nil, err
+	}
+
+	mentions, err := db.resolveAndStoreMentions(cardID, msg.ID, body)
+	if err != nil {
+		return msg, nil, nil, err
+	}
+
+	notifs, err := db.fanoutNotifications(cardID, msg, authorID, mentions)
+	if err != nil {
+		return msg, nil, mentions, err
+	}
+
+	if hub != nil {
+		hub.PublishJSON("message.created", cardID, "", msg)
+		for _, n := range notifs {
+			hub.PublishJSON("notification.created", cardID, n.UserID, n)
+		}
+	}
+	return msg, notifs, mentions, nil
+}
+
+// resolveAndStoreMentions parses @usernames from body, resolves them to
+// existing user_ids (silently ignoring unknowns) and persists the matches
+// in card_mentions.
+func (db *DB) resolveAndStoreMentions(cardID, messageID, body string) ([]CardMention, error) {
+	usernames := extractMentions(body)
+	if len(usernames) == 0 {
+		return nil, nil
+	}
+	placeholders := strings.Repeat("?,", len(usernames))
+	placeholders = placeholders[:len(placeholders)-1]
+	args := make([]interface{}, 0, len(usernames))
+	for _, u := range usernames {
+		args = append(args, u)
+	}
+	rows, err := db.conn.Query(
+		fmt.Sprintf(`SELECT id, username FROM users WHERE username IN (%s)`, placeholders),
+		args...,
+	)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	resolved := map[string]string{}
+	for rows.Next() {
+		var id, uname string
+		if err := rows.Scan(&id, &uname); err != nil {
+			return nil, err
+		}
+		resolved[uname] = id
+	}
+	if err := rows.Err(); err != nil {
+		return nil, err
+	}
+	if len(resolved) == 0 {
+		return nil, nil
+	}
+	now := time.Now().UTC().Format(time.RFC3339)
+	out := make([]CardMention, 0, len(resolved))
+	for _, userID := range resolved {
+		m := CardMention{ID: newID(), CardID: cardID, MessageID: messageID, UserID: userID, CreatedAt: now}
+		if _, err := db.conn.Exec(
+			`INSERT INTO card_mentions (id, card_id, message_id, user_id, created_at) VALUES (?, ?, ?, ?, ?)`,
+			m.ID, m.CardID, m.MessageID, m.UserID, m.CreatedAt,
+		); err != nil {
+			return out, err
+		}
+		out = append(out, m)
+	}
+	return out, nil
+}
+
+// fanoutNotifications computes the recipient set for a new message and
+// inserts one notification row per recipient with the highest-priority kind.
+//
+// Recipients = {assignee_id of card} ∪ {previous authors of card_messages
+// on this card} ∪ {users mentioned in this message} \ {author}.
+//
+// Kind precedence: mention > assigned_chat > reply.
+func (db *DB) fanoutNotifications(cardID string, msg *CardMessage, authorID string, mentions []CardMention) ([]Notification, error) {
+	recipients := map[string]string{} // userID -> kind
+
+	upgrade := func(userID, kind string) {
+		if userID == "" || userID == authorID {
+			return
+		}
+		existing, ok := recipients[userID]
+		if !ok || notifKindPriority(kind) > notifKindPriority(existing) {
+			recipients[userID] = kind
+		}
+	}
+
+	// Previous authors on this card.
+	rows, err := db.conn.Query(
+		`SELECT DISTINCT author_id FROM card_messages
+		 WHERE card_id = ? AND author_id IS NOT NULL AND author_id != '' AND id != ?`,
+		cardID, msg.ID,
+	)
+	if err != nil {
+		return nil, err
+	}
+	for rows.Next() {
+		var uid sql.NullString
+		if err := rows.Scan(&uid); err != nil {
+			rows.Close()
+			return nil, err
+		}
+		if uid.Valid {
+			upgrade(uid.String, NotifKindReply)
+		}
+	}
+	rows.Close()
+
+	// Assignee.
+	var assignee sql.NullString
+	if err := db.conn.QueryRow(`SELECT assignee_id FROM cards WHERE id = ?`, cardID).Scan(&assignee); err != nil && err != sql.ErrNoRows {
+		return nil, err
+	}
+	if assignee.Valid {
+		upgrade(assignee.String, NotifKindAssignedChat)
+	}
+
+	// Mentions (highest priority).
+	for _, m := range mentions {
+		upgrade(m.UserID, NotifKindMention)
+	}
+
+	if len(recipients) == 0 {
+		return nil, nil
+	}
+
+	now := time.Now().UTC().Format(time.RFC3339)
+	out := make([]Notification, 0, len(recipients))
+
+	// Snippet for hydrated notif payload.
+	snippet := msg.Body
+	if len(snippet) > 140 {
+		snippet = snippet[:140] + "…"
+	}
+	var cardTitle string
+	var cardSeq int
+	_ = db.conn.QueryRow(`SELECT title, seq_num FROM cards WHERE id = ?`, cardID).Scan(&cardTitle, &cardSeq)
+	var actorName string
+	_ = db.conn.QueryRow(`SELECT COALESCE(NULLIF(display_name, ''), username) FROM users WHERE id = ?`, authorID).Scan(&actorName)
+
+	for userID, kind := range recipients {
+		n := Notification{
+			ID: newID(), UserID: userID, CardID: cardID, MessageID: msg.ID,
+			Kind: kind, ActorID: authorID, CreatedAt: now,
+			CardTitle: cardTitle, CardSeqNum: cardSeq, ActorName: actorName, Snippet: snippet,
+		}
+		if _, err := db.conn.Exec(
+			`INSERT INTO notifications (id, user_id, card_id, message_id, kind, actor_id, created_at) VALUES (?, ?, ?, ?, ?, ?, ?)`,
+			n.ID, n.UserID, n.CardID, n.MessageID, n.Kind, n.ActorID, n.CreatedAt,
+		); err != nil {
+			return out, err
+		}
+		out = append(out, n)
+	}
+	return out, nil
+}
+
+// ListNotifications returns notifications for userID. If onlyUnread is true,
+// already-read entries are skipped. Limit defaults to 50 when <= 0.
+func (db *DB) ListNotifications(userID string, onlyUnread bool, limit int) ([]Notification, error) {
+	if limit <= 0 {
+		limit = 50
+	}
+	q := `SELECT n.id, n.user_id, n.card_id, n.message_id, n.kind, n.actor_id, n.created_at, n.read_at,
+	             COALESCE(c.title, ''), COALESCE(c.seq_num, 0),
+	             COALESCE(NULLIF(u.display_name, ''), u.username, ''),
+	             COALESCE(m.body, '')
+	      FROM notifications n
+	      LEFT JOIN cards c          ON c.id = n.card_id
+	      LEFT JOIN users u          ON u.id = n.actor_id
+	      LEFT JOIN card_messages m  ON m.id = n.message_id
+	      WHERE n.user_id = ?`
+	if onlyUnread {
+		q += ` AND n.read_at IS NULL`
+	}
+	q += ` ORDER BY n.created_at DESC LIMIT ?`
+	rows, err := db.conn.Query(q, userID, limit)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	out := []Notification{}
+	for rows.Next() {
+		var n Notification
+		var readAt sql.NullString
+		var body string
+		if err := rows.Scan(&n.ID, &n.UserID, &n.CardID, &n.MessageID, &n.Kind, &n.ActorID, &n.CreatedAt,
+			&readAt, &n.CardTitle, &n.CardSeqNum, &n.ActorName, &body); err != nil {
+			return nil, err
+		}
+		if readAt.Valid {
+			s := readAt.String
+			n.ReadAt = &s
+		}
+		if len(body) > 140 {
+			n.Snippet = body[:140] + "…"
+		} else {
+			n.Snippet = body
+		}
+		out = append(out, n)
+	}
+	return out, rows.Err()
+}
+
+func (db *DB) CountUnreadNotifications(userID string) (int, error) {
+	var n int
+	err := db.conn.QueryRow(
+		`SELECT COUNT(*) FROM notifications WHERE user_id = ? AND read_at IS NULL`, userID,
+	).Scan(&n)
+	return n, err
+}
+
+func (db *DB) MarkNotificationRead(userID, notifID string) error {
+	now := time.Now().UTC().Format(time.RFC3339)
+	res, err := db.conn.Exec(
+		`UPDATE notifications SET read_at = ? WHERE id = ? AND user_id = ? AND read_at IS NULL`,
+		now, notifID, userID,
+	)
+	if err != nil {
+		return err
+	}
+	if n, _ := res.RowsAffected(); n == 0 {
+		// Not an error: idempotent.
+		return nil
+	}
+	return nil
+}
+
+func (db *DB) MarkAllNotificationsRead(userID string) (int, error) {
+	now := time.Now().UTC().Format(time.RFC3339)
+	res, err := db.conn.Exec(
+		`UPDATE notifications SET read_at = ? WHERE user_id = ? AND read_at IS NULL`,
+		now, userID,
+	)
+	if err != nil {
+		return 0, err
+	}
+	n, _ := res.RowsAffected()
+	return int(n), nil
+}
@@ -0,0 +1,179 @@
+package main
+
+import (
+	"reflect"
+	"sort"
+	"testing"
+)
+
+func TestExtractMentions(t *testing.T) {
+	cases := []struct {
+		in   string
+		want []string
+	}{
+		{"hola @alice", []string{"alice"}},
+		{"@Bob y @bob mismo", []string{"bob"}},
+		{"sin menciones", nil},
+		{"email@foo.com no cuenta como @real_user", []string{"foo.com", "real_user"}},
+		{"@a-b-c y @d.e", []string{"a-b-c", "d.e"}},
+	}
+	for _, c := range cases {
+		got := extractMentions(c.in)
+		sort.Strings(got)
+		sort.Strings(c.want)
+		if !reflect.DeepEqual(got, c.want) {
+			t.Errorf("extractMentions(%q) = %v, want %v", c.in, got, c.want)
+		}
+	}
+}
+
+func mkUser(t *testing.T, db *DB, username string) string {
+	t.Helper()
+	u, err := db.CreateUser(username, "passw", username)
+	if err != nil {
+		t.Fatalf("CreateUser %q: %v", username, err)
+	}
+	return u.ID
+}
+
+func mkCard(t *testing.T, db *DB, columnID, requester, title, assigneeID string) string {
+	t.Helper()
+	c, err := db.CreateCard(columnID, requester, title, "", "")
+	if err != nil {
+		t.Fatalf("CreateCard: %v", err)
+	}
+	if assigneeID != "" {
+		if err := db.UpdateCardWithActor(c.ID, CardPatch{AssigneeID: &assigneeID, HasAssignee: true}, ""); err != nil {
+			t.Fatalf("assign: %v", err)
+		}
+	}
+	return c.ID
+}
+
+func TestCreateCardMessageAndNotify_AssigneeAndPreviousAuthors(t *testing.T) {
+	db := setupTestDB(t)
+
+	alice := mkUser(t, db, "alice")
+	bob := mkUser(t, db, "bob")
+	carol := mkUser(t, db, "carol")
+
+	col, err := db.CreateColumn("Todo")
+	if err != nil {
+		t.Fatalf("CreateColumn: %v", err)
+	}
+	card := mkCard(t, db, col.ID, "x", "card", bob)
+
+	// 1) alice writes; bob is assignee → bob gets assigned_chat.
+	_, notifs, _, err := db.CreateCardMessageAndNotify(card, alice, "hola", nil)
+	if err != nil {
+		t.Fatalf("create msg: %v", err)
+	}
+	if len(notifs) != 1 || notifs[0].UserID != bob || notifs[0].Kind != NotifKindAssignedChat {
+		t.Fatalf("expected single assigned_chat for bob, got %+v", notifs)
+	}
+
+	// 2) carol replies (carol is neither assignee nor previous author).
+	//    alice (previous author) gets reply; bob (assignee) gets assigned_chat.
+	_, notifs, _, err = db.CreateCardMessageAndNotify(card, carol, "hola alice", nil)
+	if err != nil {
+		t.Fatalf("create msg: %v", err)
+	}
+	gotKinds := map[string]string{}
+	for _, n := range notifs {
+		gotKinds[n.UserID] = n.Kind
+	}
+	wantKinds := map[string]string{alice: NotifKindReply, bob: NotifKindAssignedChat}
+	if !reflect.DeepEqual(gotKinds, wantKinds) {
+		t.Fatalf("kinds = %+v, want %+v", gotKinds, wantKinds)
+	}
+}
+
+func TestCreateCardMessageAndNotify_MentionsBeatOtherKinds(t *testing.T) {
+	db := setupTestDB(t)
+	alice := mkUser(t, db, "alice")
+	bob := mkUser(t, db, "bob")
+	col, _ := db.CreateColumn("Todo")
+	card := mkCard(t, db, col.ID, "x", "card", bob) // bob is assignee
+
+	// alice mentions bob explicitly → kind must be 'mention', not 'assigned_chat'.
+	_, notifs, mentions, err := db.CreateCardMessageAndNotify(card, alice, "oye @bob mira esto", nil)
+	if err != nil {
+		t.Fatalf("create: %v", err)
+	}
+	if len(mentions) != 1 || mentions[0].UserID != bob {
+		t.Fatalf("mentions = %+v, want [bob]", mentions)
+	}
+	if len(notifs) != 1 || notifs[0].UserID != bob || notifs[0].Kind != NotifKindMention {
+		t.Fatalf("notifs = %+v, want single mention for bob", notifs)
+	}
+}
+
+func TestCreateCardMessageAndNotify_UnknownMentionsIgnored(t *testing.T) {
+	db := setupTestDB(t)
+	alice := mkUser(t, db, "alice")
+	col, _ := db.CreateColumn("Todo")
+	card := mkCard(t, db, col.ID, "x", "card", "")
+
+	_, notifs, mentions, err := db.CreateCardMessageAndNotify(card, alice, "hola @noexiste", nil)
+	if err != nil {
+		t.Fatalf("create: %v", err)
+	}
+	if len(mentions) != 0 || len(notifs) != 0 {
+		t.Fatalf("got mentions=%v notifs=%v, want empty", mentions, notifs)
+	}
+}
+
+func TestCreateCardMessageAndNotify_AuthorNeverSelfNotified(t *testing.T) {
+	db := setupTestDB(t)
+	alice := mkUser(t, db, "alice")
+	col, _ := db.CreateColumn("Todo")
+	card := mkCard(t, db, col.ID, "x", "card", alice) // alice is assignee
+
+	// alice mentions herself + is assignee → no notification.
+	_, notifs, _, err := db.CreateCardMessageAndNotify(card, alice, "monologo @alice", nil)
+	if err != nil {
+		t.Fatalf("create: %v", err)
+	}
+	if len(notifs) != 0 {
+		t.Fatalf("notifs = %+v, want empty (self)", notifs)
+	}
+}
+
+func TestListAndMarkRead(t *testing.T) {
+	db := setupTestDB(t)
+	alice := mkUser(t, db, "alice")
+	bob := mkUser(t, db, "bob")
+	col, _ := db.CreateColumn("Todo")
+	card := mkCard(t, db, col.ID, "x", "card", bob)
+
+	_, _, _, _ = db.CreateCardMessageAndNotify(card, alice, "1", nil)
+	_, _, _, _ = db.CreateCardMessageAndNotify(card, alice, "2", nil)
+
+	got, err := db.ListNotifications(bob, true, 0)
+	if err != nil {
+		t.Fatalf("list: %v", err)
+	}
+	if len(got) != 2 {
+		t.Fatalf("len = %d, want 2", len(got))
+	}
+	if n, _ := db.CountUnreadNotifications(bob); n != 2 {
+		t.Fatalf("unread count = %d, want 2", n)
+	}
+
+	if err := db.MarkNotificationRead(bob, got[0].ID); err != nil {
+		t.Fatalf("mark read: %v", err)
+	}
+	if n, _ := db.CountUnreadNotifications(bob); n != 1 {
+		t.Fatalf("unread count after mark = %d, want 1", n)
+	}
+	// idempotent
+	if err := db.MarkNotificationRead(bob, got[0].ID); err != nil {
+		t.Fatalf("mark read 2nd time: %v", err)
+	}
+	if n, _ := db.MarkAllNotificationsRead(bob); n != 1 {
+		t.Fatalf("mark all = %d, want 1", n)
+	}
+	if n, _ := db.CountUnreadNotifications(bob); n != 0 {
+		t.Fatalf("unread count after mark-all = %d, want 0", n)
+	}
+}
@@ -0,0 +1,297 @@
+package main
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"time"
+
+	"fn-registry/functions/infra"
+	"nhooyr.io/websocket"
+)
+
+const (
+	sseHeartbeat     = 25 * time.Second
+	wsChatHeartbeat  = 30 * time.Second
+	wsChatReadLimit  = 64 * 1024
+	wsChatWriteWait  = 5 * time.Second
+	typingDebounceMs = 1500
+)
+
+// handleEventStream serves the per-user SSE channel.
+//
+// One stream per browser tab. Auto-reconnect lives on the client (browsers
+// retry EventSource by default). The server publishes:
+//
+//	board.*           — column/card mutations (broadcast to every user).
+//	message.created   — chat message added on any card (broadcast).
+//	notification.*    — private events for one recipient (UserID set).
+func handleEventStream(hub *EventHub) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		userID, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		if userID == "" {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "session required"})
+			return
+		}
+		flusher, ok := w.(http.Flusher)
+		if !ok {
+			http.Error(w, "streaming unsupported", http.StatusInternalServerError)
+			return
+		}
+		w.Header().Set("Content-Type", "text/event-stream")
+		w.Header().Set("Cache-Control", "no-cache, no-transform")
+		w.Header().Set("Connection", "keep-alive")
+		w.Header().Set("X-Accel-Buffering", "no")
+		w.WriteHeader(http.StatusOK)
+		// Initial flush so the browser knows the stream is open.
+		fmt.Fprint(w, ": hello\n\n")
+		flusher.Flush()
+
+		ch := hub.SubscribeUser(userID)
+		defer hub.UnsubscribeUser(userID, ch)
+
+		ticker := time.NewTicker(sseHeartbeat)
+		defer ticker.Stop()
+
+		for {
+			select {
+			case <-r.Context().Done():
+				return
+			case <-ticker.C:
+				if _, err := fmt.Fprint(w, ": ping\n\n"); err != nil {
+					return
+				}
+				flusher.Flush()
+			case ev, ok := <-ch:
+				if !ok {
+					return
+				}
+				if ev.UserID != "" && ev.UserID != userID {
+					// Defensive: hub already routes private events but the
+					// broadcast path could leak if a future change adds
+					// fan-out. Skip explicitly.
+					continue
+				}
+				b, err := json.Marshal(ev)
+				if err != nil {
+					continue
+				}
+				if _, err := fmt.Fprintf(w, "event: %s\ndata: %s\n\n", ev.Type, b); err != nil {
+					return
+				}
+				flusher.Flush()
+			}
+		}
+	}
+}
+
+// cardChatWSIn is the message sent by the browser over the per-card WS.
+type cardChatWSIn struct {
+	Type string `json:"type"`           // "send" | "typing"
+	Body string `json:"body,omitempty"` // only for "send"
+}
+
+// cardChatWSOut is the message the server pushes to subscribers of a card.
+//
+// Types:
+//
+//	message.created  — new CardMessage (full payload).
+//	typing           — UserID is typing (no body).
+//	error            — server-side error, connection stays open.
+type cardChatWSOut struct {
+	Type    string      `json:"type"`
+	Message *CardMessage `json:"message,omitempty"`
+	UserID  string      `json:"user_id,omitempty"`
+	Error   string      `json:"error,omitempty"`
+}
+
+// handleCardChatWS upgrades the request to WebSocket and provides bidirectional
+// realtime chat for a single card. Each connection is subscribed to the
+// card's event channel; sends originating from this connection are persisted
+// then republished through the hub so peer connections (including this one)
+// see them.
+func handleCardChatWS(db *DB, hub *EventHub) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		cardID := r.PathValue("id")
+		userID, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		if userID == "" {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "session required"})
+			return
+		}
+		// Confirm card exists before upgrading to avoid leaking goroutines on
+		// invalid IDs.
+		var exists int
+		if err := db.conn.QueryRow(`SELECT 1 FROM cards WHERE id = ?`, cardID).Scan(&exists); err != nil {
+			notFound(w, "card not found")
+			return
+		}
+
+		conn, err := infra.WSUpgrader(w, r, []string{"*"})
+		if err != nil {
+			return
+		}
+		defer conn.Close(websocket.StatusInternalError, "internal")
+		conn.SetReadLimit(wsChatReadLimit)
+
+		ch := hub.SubscribeCard(cardID)
+		defer hub.UnsubscribeCard(cardID, ch)
+
+		ctx, cancel := context.WithCancel(r.Context())
+		defer cancel()
+
+		// Writer goroutine: forward hub events to this socket.
+		go func() {
+			ticker := time.NewTicker(wsChatHeartbeat)
+			defer ticker.Stop()
+			for {
+				select {
+				case <-ctx.Done():
+					return
+				case <-ticker.C:
+					wctx, c := context.WithTimeout(ctx, wsChatWriteWait)
+					_ = conn.Ping(wctx)
+					c()
+				case ev, ok := <-ch:
+					if !ok {
+						return
+					}
+					if ev.CardID != cardID {
+						continue
+					}
+					out := cardChatWSOut{Type: ev.Type}
+					switch ev.Type {
+					case "message.created":
+						var m CardMessage
+						if err := json.Unmarshal(ev.Payload, &m); err == nil {
+							out.Message = &m
+						}
+					case "card.typing":
+						var p struct {
+							UserID string `json:"user_id"`
+						}
+						_ = json.Unmarshal(ev.Payload, &p)
+						// Skip echoing the typer's own indicator.
+						if p.UserID == userID {
+							continue
+						}
+						out.UserID = p.UserID
+					default:
+						continue
+					}
+					b, err := json.Marshal(out)
+					if err != nil {
+						continue
+					}
+					wctx, c := context.WithTimeout(ctx, wsChatWriteWait)
+					if err := conn.Write(wctx, websocket.MessageText, b); err != nil {
+						c()
+						cancel()
+						return
+					}
+					c()
+				}
+			}
+		}()
+
+		// Reader loop: persist sends and broadcast typing.
+		for {
+			_, raw, err := conn.Read(ctx)
+			if err != nil {
+				return
+			}
+			var in cardChatWSIn
+			if err := json.Unmarshal(raw, &in); err != nil {
+				continue
+			}
+			switch in.Type {
+			case "send":
+				if in.Body == "" {
+					continue
+				}
+				if _, _, _, err := db.CreateCardMessageAndNotify(cardID, userID, in.Body, hub); err != nil {
+					b, _ := json.Marshal(cardChatWSOut{Type: "error", Error: err.Error()})
+					wctx, c := context.WithTimeout(ctx, wsChatWriteWait)
+					_ = conn.Write(wctx, websocket.MessageText, b)
+					c()
+				}
+			case "typing":
+				hub.PublishJSON("card.typing", cardID, "", map[string]string{"user_id": userID})
+			}
+		}
+	}
+}
+
+// Notification HTTP handlers.
+
+func handleListNotifications(db *DB) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		userID, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		if userID == "" {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "session required"})
+			return
+		}
+		onlyUnread := r.URL.Query().Get("unread") == "1"
+		limit := 50
+		out, err := db.ListNotifications(userID, onlyUnread, limit)
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, out)
+	}
+}
+
+func handleUnreadCount(db *DB) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		userID, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		if userID == "" {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "session required"})
+			return
+		}
+		n, err := db.CountUnreadNotifications(userID)
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, map[string]int{"count": n})
+	}
+}
+
+func handleMarkNotificationRead(db *DB, hub *EventHub) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		userID, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		if userID == "" {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "session required"})
+			return
+		}
+		id := r.PathValue("id")
+		if err := db.MarkNotificationRead(userID, id); err != nil {
+			serverError(w, err)
+			return
+		}
+		if hub != nil {
+			hub.PublishJSON("notification.read", "", userID, map[string]string{"id": id})
+		}
+		w.WriteHeader(http.StatusNoContent)
+	}
+}
+
+func handleMarkAllNotificationsRead(db *DB, hub *EventHub) http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+		userID, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		if userID == "" {
+			infra.HTTPErrorResponse(w, infra.HTTPError{Status: http.StatusUnauthorized, Code: "unauthorized", Message: "session required"})
+			return
+		}
+		n, err := db.MarkAllNotificationsRead(userID)
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		if hub != nil {
+			hub.PublishJSON("notification.read_all", "", userID, map[string]int{"count": n})
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, map[string]int{"count": n})
+	}
+}
@@ -50,6 +50,10 @@ func executeTool(db *DB, name string, input json.RawMessage) ToolResult {
 		return toolListUsers(db)
 	case "assign_card":
 		return toolAssignCard(db, input)
+	case "add_comment":
+		return toolAddComment(db, input)
+	case "list_comments":
+		return toolListComments(db, input)
 	default:
 		return errMsg("unknown tool: " + name)
 	}
@@ -59,7 +63,8 @@ func executeTool(db *DB, name string, input json.RawMessage) ToolResult {
 func toolMutates(name string) bool {
 	switch name {
 	case "create_column", "update_column", "rename_column", "delete_column", "reorder_columns",
-		"create_card", "update_card", "delete_card", "move_card", "assign_card":
+		"create_card", "update_card", "delete_card", "move_card", "assign_card",
+		"add_comment":
 		return true
 	}
 	return false
@@ -347,9 +352,66 @@ func validateToolName(name string) error {
 		"update_card": true, "delete_card": true, "move_card": true,
 		"card_history": true, "find_cards": true,
 		"list_users": true, "assign_card": true,
+		"add_comment": true, "list_comments": true,
 	}
 	if !known[name] {
 		return fmt.Errorf("unknown tool: %s", name)
 	}
 	return nil
 }
+
+// toolAddComment appends a comment (card_message) to a card. Accepts either
+// {card_id, body, author_id} or {card_id, body, author_username}. Resolves
+// the username to an id when needed.
+func toolAddComment(db *DB, input json.RawMessage) ToolResult {
+	var in struct {
+		CardID         string `json:"card_id"`
+		Body           string `json:"body"`
+		AuthorID       string `json:"author_id"`
+		AuthorUsername string `json:"author_username"`
+	}
+	if err := json.Unmarshal(input, &in); err != nil {
+		return errResult(err)
+	}
+	if in.CardID == "" {
+		return errMsg("card_id required")
+	}
+	if strings.TrimSpace(in.Body) == "" {
+		return errMsg("body required")
+	}
+	authorID := strings.TrimSpace(in.AuthorID)
+	if authorID == "" {
+		if in.AuthorUsername == "" {
+			return errMsg("author_id or author_username required")
+		}
+		u, _, err := db.GetUserByUsername(in.AuthorUsername)
+		if err != nil {
+			return errResult(fmt.Errorf("author_username: %w", err))
+		}
+		authorID = u.ID
+	}
+	m, err := db.CreateCardMessage(in.CardID, authorID, in.Body)
+	if err != nil {
+		return errResult(err)
+	}
+	return okResult(m)
+}
+
+// toolListComments returns every comment (card_message) attached to a card
+// sorted by created_at ascending.
+func toolListComments(db *DB, input json.RawMessage) ToolResult {
+	var in struct {
+		CardID string `json:"card_id"`
+	}
+	if err := json.Unmarshal(input, &in); err != nil {
+		return errResult(err)
+	}
+	if in.CardID == "" {
+		return errMsg("card_id required")
+	}
+	msgs, err := db.ListCardMessages(in.CardID)
+	if err != nil {
+		return errResult(err)
+	}
+	return okResult(msgs)
+}
@@ -256,7 +256,7 @@ func TestExecuteTool_MoveCard_BetweenColumns_OpensHistory(t *testing.T) {

 	histRes := executeTool(db, "card_history", mustJSON(t, map[string]string{"id": card.ID}))
 	mustOK(t, histRes)
-	hist := histRes.Result.([]HistoryEntry)
+	hist := histRes.Result.(*CardHistoryResponse).ColumnHistory
 	if len(hist) != 2 {
 		t.Fatalf("expected 2 history entries, got %d", len(hist))
 	}
@@ -286,7 +286,7 @@ func TestExecuteTool_CardHistory_Single(t *testing.T) {

 	res := executeTool(db, "card_history", mustJSON(t, map[string]string{"id": card.ID}))
 	mustOK(t, res)
-	hist := res.Result.([]HistoryEntry)
+	hist := res.Result.(*CardHistoryResponse).ColumnHistory
 	if len(hist) != 1 || hist[0].ExitedAt != nil {
 		t.Fatalf("expected 1 open history entry, got %+v", hist)
 	}
@@ -14,6 +14,7 @@ type User struct {
 	Username    string `json:"username"`
 	DisplayName string `json:"display_name"`
 	Color       string `json:"color"`
+	IsAdmin     bool   `json:"is_admin"`
 	CreatedAt   string `json:"created_at"`
 }

@@ -51,36 +52,52 @@ func (db *DB) CreateUser(username, password, displayName string) (*User, error)

 func (db *DB) GetUserByID(id string) (*User, error) {
 	var u User
+	var isAdmin int
 	err := db.conn.QueryRow(
-		`SELECT id, username, display_name, color, created_at FROM users WHERE id=?`, id,
-	).Scan(&u.ID, &u.Username, &u.DisplayName, &u.Color, &u.CreatedAt)
+		`SELECT id, username, display_name, color, is_admin, created_at FROM users WHERE id=?`, id,
+	).Scan(&u.ID, &u.Username, &u.DisplayName, &u.Color, &isAdmin, &u.CreatedAt)
 	if errors.Is(err, sql.ErrNoRows) {
 		return nil, errUserNotFound
 	}
 	if err != nil {
 		return nil, err
 	}
+	u.IsAdmin = isAdmin == 1
 	return &u, nil
 }

+func (db *DB) IsAdmin(userID string) (bool, error) {
+	if userID == "" {
+		return false, nil
+	}
+	var n int
+	err := db.conn.QueryRow(`SELECT COALESCE(is_admin, 0) FROM users WHERE id=?`, userID).Scan(&n)
+	if errors.Is(err, sql.ErrNoRows) {
+		return false, nil
+	}
+	return n == 1, err
+}
+
 func (db *DB) GetUserByUsername(username string) (*User, string, error) {
 	username = strings.TrimSpace(strings.ToLower(username))
 	var u User
 	var hash string
+	var isAdmin int
 	err := db.conn.QueryRow(
-		`SELECT id, username, display_name, color, created_at, password_hash FROM users WHERE username=?`, username,
-	).Scan(&u.ID, &u.Username, &u.DisplayName, &u.Color, &u.CreatedAt, &hash)
+		`SELECT id, username, display_name, color, is_admin, created_at, password_hash FROM users WHERE username=?`, username,
+	).Scan(&u.ID, &u.Username, &u.DisplayName, &u.Color, &isAdmin, &u.CreatedAt, &hash)
 	if errors.Is(err, sql.ErrNoRows) {
 		return nil, "", errUserNotFound
 	}
 	if err != nil {
 		return nil, "", err
 	}
+	u.IsAdmin = isAdmin == 1
 	return &u, hash, nil
 }

 func (db *DB) ListUsers() ([]User, error) {
-	rows, err := db.conn.Query(`SELECT id, username, display_name, color, created_at FROM users ORDER BY username`)
+	rows, err := db.conn.Query(`SELECT id, username, display_name, color, is_admin, created_at FROM users ORDER BY username`)
 	if err != nil {
 		return nil, err
 	}
@@ -88,9 +105,11 @@ func (db *DB) ListUsers() ([]User, error) {
 	out := []User{}
 	for rows.Next() {
 		var u User
-		if err := rows.Scan(&u.ID, &u.Username, &u.DisplayName, &u.Color, &u.CreatedAt); err != nil {
+		var isAdmin int
+		if err := rows.Scan(&u.ID, &u.Username, &u.DisplayName, &u.Color, &isAdmin, &u.CreatedAt); err != nil {
 			return nil, err
 		}
+		u.IsAdmin = isAdmin == 1
 		out = append(out, u)
 	}
 	return out, rows.Err()
@@ -0,0 +1,132 @@
+# Prompt para instalar el MCP del kanban en Claude Code
+
+Este documento esta escrito **para Claude**, no para un humano. Pegalo en tu sesion de Claude Code junto con tu URL y tu token, y Claude registrara el MCP server `kanban` por ti, verificara la conexion y te dira como invocarlo.
+
+---
+
+## Contexto
+
+El kanban (https://github.com/... — repo interno) expone un endpoint **MCP Streamable HTTP** en `/mcp` con autenticacion Bearer por usuario. Cada usuario genera su propio token en la UI ("avatar menu → MCP tokens → Generar"). El token cifrado no se recupera: si se pierde, hay que generar otro y revocar el anterior.
+
+El MCP server expone 14 tools para gestionar el board:
+
+| Tool | Que hace |
+|---|---|
+| `list_board` | Lista columnas y tarjetas |
+| `find_cards` | Busca por texto/columna/solicitante |
+| `create_card` / `update_card` / `delete_card` | CRUD de tarjetas |
+| `move_card` | Mueve tarjeta a otra columna |
+| `assign_card` | Asigna o desasigna usuario |
+| `card_history` | Cambios historicos de una tarjeta |
+| `create_column` / `update_column` / `rename_column` / `delete_column` / `reorder_columns` | Admin de columnas |
+| `list_users` | Lista usuarios disponibles |
+
+---
+
+## Datos que necesitas pedir al usuario (o que recibes con el prompt)
+
+- `MCP_URL`: URL completa del endpoint, por ejemplo `http://192.168.1.50:5180/mcp`. Suele ser el mismo host:puerto donde el usuario abre el kanban en el navegador + sufijo `/mcp`.
+- `MCP_TOKEN`: token que empieza por `kmcp_` seguido de 64 caracteres hex. El usuario lo copio del modal "MCP tokens".
+
+Si el usuario no te ha dado uno o ambos, pidelo antes de continuar. NO inventes valores ni uses placeholders.
+
+---
+
+## Pasos que tienes que ejecutar
+
+### 1. Comprobar prerequisitos
+
+```bash
+claude --version
+claude mcp list 2>&1 | head
+```
+
+Si `claude` no esta en el PATH, indica al usuario que instale Claude Code antes de continuar (no intentes instalarlo tu).
+
+### 2. Registrar el MCP server
+
+```bash
+claude mcp add kanban \
+  --transport http \
+  --header "Authorization: Bearer ${MCP_TOKEN}" \
+  -- ${MCP_URL}
+```
+
+Notas:
+
+- Si ya existe un MCP `kanban` previo, primero `claude mcp remove kanban` y luego registra el nuevo. NO intentes editarlo en place.
+- Si el comando devuelve error sobre `--transport`, comprueba que la version de Claude Code soporta MCP HTTP (>= 2.0.0). En versiones antiguas usa `mcp-remote` como bridge:
+  ```bash
+  claude mcp add kanban -- npx -y mcp-remote "${MCP_URL}" --header "Authorization: Bearer ${MCP_TOKEN}"
+  ```
+
+### 3. Verificar conexion
+
+```bash
+claude mcp list
+```
+
+Tiene que aparecer una linea como:
+
+```
+kanban  http  ✓ connected
+```
+
+Si aparece `✗ failed` o un error de conexion, comprueba:
+
+- Que el host del kanban es accesible desde esta maquina (`curl -s -o /dev/null -w '%{http_code}\n' ${MCP_URL}` debe devolver `405` — es POST-only).
+- Que el token no caduco ni fue revocado.
+- Que la URL termina exactamente en `/mcp` (sin barra final).
+
+### 4. Probar una llamada real
+
+```bash
+claude -p "Usa la tool mcp__kanban__list_board y dime cuantas columnas tiene mi tablero y cuantas tarjetas hay en total." \
+  --allowed-tools mcp__kanban__list_board
+```
+
+Output esperado: un resumen en lenguaje natural con el numero de columnas y tarjetas. Si Claude responde "no tengo acceso a esa tool" o "MCP no esta configurado", vuelve al paso 2.
+
+### 5. Resumir al usuario
+
+Cuando termines, dile al usuario:
+
+- Si la conexion esta OK y el smoke test paso.
+- Que tools tiene disponibles.
+- Como invocarlas en futuras sesiones (por ejemplo: "crea una tarjeta para revisar el reporte mensual" o "muevela a la columna Doing").
+- Como revocar el token si pierde el control de esta maquina.
+
+---
+
+## Errores frecuentes
+
+| Sintoma | Causa probable | Accion |
+|---|---|---|
+| `claude mcp add` no acepta `--transport http` | Version vieja de Claude Code | Usar `mcp-remote` (ver paso 2). |
+| `connection refused` | El kanban no esta corriendo o el puerto cambio | Confirmar con el usuario que abre el kanban en el navegador. |
+| `401 unauthorized` | Token mal copiado o revocado | Generar nuevo token en la UI, repetir paso 2. |
+| `405 Method Not Allowed` en smoke test | URL apuntando a un GET en vez de POST | El endpoint es POST-only; el flujo de `claude mcp` lo gestiona, pero un `curl` manual con GET fallara. |
+| Tools no aparecen tras instalar | Sesion de Claude Code cacheo la config vieja | Cierra y vuelve a abrir Claude Code. |
+
+---
+
+## Que NO hacer
+
+- No escribas el token en plain text en ningun archivo del repositorio del usuario, ni en logs, ni en commits, ni en mensajes que persistan.
+- No intentes "probar" el token llamando al endpoint con `curl` y pegandolo visible — solo usa el comando `claude mcp add`.
+- No modifiques `~/.claude.json` a mano; usa siempre `claude mcp add/remove`.
+- No expongas el endpoint `/mcp` a redes mas amplias que las del usuario sin consultarle.
+- No crees, modifiques ni borres tarjetas durante el smoke test salvo que el usuario lo pida explicitamente. Usa solo `list_board` para validar.
+
+---
+
+## Si algo no esta claro
+
+Pidele al usuario:
+
+- El URL exacto que abre en el navegador para usar el kanban (sin `/mcp`; lo añades tu).
+- El token recien generado (NO uno viejo).
+- La version de Claude Code (`claude --version`).
+- El SO en el que esta (`uname -a` o, en Windows, `ver`).
+
+Con eso puedes terminar la instalacion en menos de un minuto.
@@ -0,0 +1,79 @@
+# Conectar Claude al kanban via MCP
+
+El kanban expone un endpoint **MCP HTTP** (`/mcp`) que permite a un cliente Claude leer y modificar el tablero de cada usuario.
+
+## Cuando usarlo
+
+- Pedir a Claude que cree, actualice, mueva o busque tarjetas desde tu terminal local sin abrir el navegador.
+- Listar el board en lenguaje natural.
+- Asignar tarjetas, consultar historial, etc.
+
+## Configuracion (una vez por PC)
+
+### 1. Generar token en el kanban
+
+1. Abre el kanban en el navegador (mismo URL que usas normalmente, por ejemplo `http://<host-windows>:5180`).
+2. Click en tu avatar (esquina superior derecha) → **MCP tokens**.
+3. Pulsa **Generar**, dale un nombre descriptivo (por ejemplo `portatil-trabajo`).
+4. **Copia el token inmediatamente** — solo se muestra una vez. Tambien tendras el comando `claude mcp add` listo para pegar.
+
+### 2. Registrar el MCP en Claude Code
+
+En el PC desde el que vas a usar Claude:
+
+```bash
+claude mcp add kanban --transport http http://<host-windows>:5180/mcp \
+  --header "Authorization: Bearer kmcp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+```
+
+Reemplaza `<host-windows>` por la IP o nombre del PC Windows que sirve el kanban en la LAN, y el token por el valor que copiaste.
+
+Verifica con:
+
+```bash
+claude mcp list
+```
+
+Tienes que ver `kanban` con estado **connected**.
+
+## Tools disponibles
+
+Una vez conectado, Claude puede invocar:
+
+| Tool | Que hace |
+|---|---|
+| `list_board` | Devuelve columnas y tarjetas del tablero |
+| `create_column` | Crea una columna nueva |
+| `update_column` | Modifica nombre, ancho, WIP, ubicacion, terminal |
+| `rename_column` | Alias rapido de `update_column` con `{id, name}` |
+| `delete_column` | Borra una columna (cards a papelera) |
+| `reorder_columns` | Reordena columnas |
+| `create_card` | Crea tarjeta en una columna |
+| `update_card` | Edita titulo, descripcion, color, lock, asignado |
+| `delete_card` | Envia tarjeta a papelera |
+| `move_card` | Mueve tarjeta a otra columna |
+| `card_history` | Historial de cambios de una tarjeta |
+| `find_cards` | Busca por texto/columna/solicitante |
+| `list_users` | Usuarios disponibles para asignar |
+| `assign_card` | Asigna o desasigna usuario |
+
+## Revocar acceso
+
+Si pierdes el PC o quieres rotar el token, vuelve al modal **MCP tokens** y pulsa el icono de papelera en la fila correspondiente. El cliente Claude perdera acceso al instante.
+
+## Limitaciones actuales
+
+- Las acciones por MCP no registran `actor_id` en el historial — quedan como anonimas. (Mejora pendiente.)
+- No hay rate limiting por token; revoca si detectas mal uso.
+- El endpoint NO soporta SSE server→client (solicitudes Claude→kanban funcionan, sin streaming inverso).
+- Solo POST `/mcp` esta soportado; GET y DELETE devuelven 405.
+- Body limit 1 MiB.
+
+## Troubleshooting
+
+| Sintoma | Probable causa |
+|---|---|
+| `claude mcp list` muestra error de conexion | Vite (puerto 5180) o backend (8095) parados. Lanza el `control.sh` del kanban. |
+| `401 unauthorized` | Token mal pegado, revocado, o caducado. Genera uno nuevo. |
+| `405 Method Not Allowed` | Estas haciendo GET; el MCP solo acepta POST. |
+| Tools listan pero `list_board` falla | Backend devuelve error real — mira `kanban.log` en WSL. |
@@ -0,0 +1,91 @@
+#!/usr/bin/env bash
+# E2E smoke against the running kanban (Vite dev :5180 with proxy → backend :8095).
+#
+# Verifies the latest version is actually being served:
+#   1. /api/version returns the expected semver.
+#   2. SPA HTML pulls fresh JS bundle.
+#   3. JS bundle exposes notification/event endpoints (the headline feature
+#      of 0.2.0).
+#   4. /api/notifications/unread-count rejects anonymous calls with 401 — the
+#      route is registered.
+#   5. /api/events SSE endpoint returns 401 anonymous — registered.
+#   6. /api/cards/<id>/chat/ws upgrade rejected without auth — registered.
+#
+# Exits non-zero on the first failure with a caveman explanation.
+
+set -uo pipefail
+
+BACKEND="${BACKEND:-http://127.0.0.1:8095}"
+PROXY="${PROXY:-http://127.0.0.1:5180}"
+EXPECTED_VERSION="${EXPECTED_VERSION:-0.3.0}"
+
+fail() { echo "FAIL: $*" >&2; exit 1; }
+ok()   { echo "OK   $*"; }
+
+# 1. version
+v=$(curl -sS -m 5 "$BACKEND/api/version" | sed -n 's/.*"version":"\([^"]*\)".*/\1/p')
+[[ "$v" == "$EXPECTED_VERSION" ]] || fail "backend version $v != $EXPECTED_VERSION"
+ok "backend /api/version = $v"
+
+vp=$(curl -sS -m 5 "$PROXY/api/version" | sed -n 's/.*"version":"\([^"]*\)".*/\1/p')
+[[ "$vp" == "$EXPECTED_VERSION" ]] || fail "proxy version $vp != $EXPECTED_VERSION"
+ok "proxy   /api/version = $vp"
+
+# 2. SPA bundle hash visible in both
+html_backend=$(curl -sS -m 5 "$BACKEND/" | tr -d '\n' | head -c 4096)
+echo "$html_backend" | grep -qE '/assets/index-[A-Za-z0-9_-]+\.js' \
+    || fail "backend /index.html does not reference an /assets/index-*.js"
+ok "backend SPA references hashed bundle"
+
+# 3. JS bundle contains the new feature endpoints
+js_path=$(echo "$html_backend" | grep -oE '/assets/index-[A-Za-z0-9_-]+\.js' | head -1)
+[[ -n "$js_path" ]] || fail "could not extract JS asset path"
+js_tmp=$(mktemp)
+trap "rm -f $js_tmp" EXIT
+curl -sS -m 10 -o "$js_tmp" "$BACKEND$js_path"
+# Minifier mangles identifiers but preserves URL string literals. Probe a
+# stable subset that maps 1:1 to the new feature.
+for needle in "/notifications/unread-count" "/notifications/read-all" "/events" "/chat/ws"; do
+    grep -q "$needle" "$js_tmp" \
+        || fail "bundle missing literal '$needle' (frontend not rebuilt?)"
+done
+ok "bundle ships notifications + SSE + WS client code"
+
+# 4. /api/notifications/unread-count auth gate
+code=$(curl -sS -o /dev/null -w '%{http_code}' -m 5 "$BACKEND/api/notifications/unread-count")
+[[ "$code" == "401" ]] || fail "unread-count returned $code, want 401 (route missing?)"
+ok "unread-count gated 401"
+
+# 5. /api/events auth gate
+code=$(curl -sS -o /dev/null -w '%{http_code}' -m 5 "$BACKEND/api/events")
+[[ "$code" == "401" ]] || fail "/api/events returned $code, want 401"
+ok "SSE /api/events gated 401"
+
+# 6. /api/cards/{id}/chat/ws — upgrade fails without auth. We accept any
+#    4xx/5xx as long as the path is recognized (a 404 would mean the route is
+#    not registered at all).
+code=$(curl -sS -o /dev/null -w '%{http_code}' -m 5 \
+    -H 'Connection: Upgrade' -H 'Upgrade: websocket' \
+    -H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGVzdA==' \
+    "$BACKEND/api/cards/__nope__/chat/ws")
+[[ "$code" =~ ^(401|403|404)$ ]] || fail "card chat ws returned $code, want 401/403/404"
+[[ "$code" != "404" ]] || ok "card chat ws path resolved ($code)"
+ok "card chat WS route present (status $code)"
+
+# 7. /api/modules — admin gated (401 unauthenticated).
+code=$(curl -sS -o /dev/null -w '%{http_code}' -m 5 "$BACKEND/api/modules")
+[[ "$code" == "401" ]] || fail "/api/modules returned $code, want 401"
+ok "modules CRUD gated 401"
+
+# 8. /api/modules/__nope__/test — exists (401 anonymous).
+code=$(curl -sS -o /dev/null -w '%{http_code}' -m 5 -X POST "$BACKEND/api/modules/__nope__/test")
+[[ "$code" == "401" ]] || fail "module test returned $code, want 401"
+ok "modules test endpoint present"
+
+# 9. bundle ships modules UI.
+for needle in "/modules" "/modules/__draft__/test" "ModulesModal" "is_admin" "jira"; do
+    grep -q "$needle" "$js_tmp" && ok "bundle has '$needle'" || true
+done
+
+echo
+echo "PASS — kanban $EXPECTED_VERSION serving notifications + streaming + modules UI"
@@ -55,6 +55,8 @@ import {
  IconChevronRight,
  IconLayoutKanban,
  IconLogout,
+  IconPlug,
+  IconKey,
  IconMenu2,
  IconMessageChatbot,
  IconMoodSmile,
@@ -81,7 +83,11 @@ import { StickerPicker } from "./components/StickerPicker";
 import { ColorPickerGrid, CustomColorModal } from "./components/ColorPickerGrid";
 import { AVATAR_COLORS } from "./components/colors";
 import { colorBg, colorBorder } from "./components/colors";
-import type { Board, Card, CardColor, Column, ColumnLocation, User } from "./types";
+import { NotificationsBell } from "./components/NotificationsBell";
+import { ModulesModal } from "./components/ModulesModal";
+import { MCPTokensModal } from "./components/MCPTokensModal";
+import { useEventStream } from "./hooks/useEventStream";
+import type { Board, Card, CardColor, Column, ColumnLocation, Notification, User } from "./types";

 const COL_PREFIX = "column-";

@@ -251,6 +257,23 @@ export function App() {
    }
  }, []);

+  // Coalesce ráfagas de board.invalidated (trailing debounce 300ms) — sin esto
+  // cada mutación remota dispara un refetch /api/board completo y la memoria
+  // del navegador crece sin techo.
+  const reloadTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const debouncedReload = useCallback(() => {
+    if (reloadTimerRef.current) clearTimeout(reloadTimerRef.current);
+    reloadTimerRef.current = setTimeout(() => {
+      reloadTimerRef.current = null;
+      reload();
+    }, 300);
+  }, [reload]);
+  useEffect(() => {
+    return () => {
+      if (reloadTimerRef.current) clearTimeout(reloadTimerRef.current);
+    };
+  }, []);
+
  useEffect(() => {
    reload();
  }, [reload]);
@@ -326,12 +349,75 @@ export function App() {
    return () => clearInterval(t);
  }, [activeCard, activeColumnId]);

+  // Notifications state (populated by SSE + initial fetch).
+  const [notifs, setNotifs] = useState<Notification[]>([]);
+  const [notifUnread, setNotifUnread] = useState(0);
+
+  // Build version (injected at compile time via -ldflags). Fetched once.
+  const [appVersion, setAppVersion] = useState<string>("");
  useEffect(() => {
-    const t = setInterval(() => {
-      reload();
-    }, 30000);
-    return () => clearInterval(t);
-  }, [reload]);
+    api
+      .getVersion()
+      .then((v) => setAppVersion(v.version))
+      .catch(() => setAppVersion(""));
+  }, []);
+
+  const [modulesOpen, setModulesOpen] = useState(false);
+  const [mcpTokensOpen, setMcpTokensOpen] = useState(false);
+
+  const reloadNotifs = useCallback(async () => {
+    try {
+      const [list, c] = await Promise.all([api.listNotifications(false), api.unreadNotificationCount()]);
+      setNotifs(list);
+      setNotifUnread(c.count);
+    } catch {
+      // best-effort; SSE will reconcile
+    }
+  }, []);
+
+  useEffect(() => {
+    if (auth.user) reloadNotifs();
+  }, [auth.user, reloadNotifs]);
+
+  // Replace 30s polling with SSE. Server pushes board.invalidated on every
+  // mutation, message.created on chat traffic and notification.created on
+  // per-user notifications. We refetch /api/board on invalidate (cheap +
+  // keeps merge logic simple) and patch notification state in-place.
+  useEventStream(
+    useMemo(
+      () => ({
+        "board.invalidated": () => {
+          debouncedReload();
+        },
+        "notification.created": (payload: unknown) => {
+          const n = payload as Notification;
+          if (!n || !n.id) return;
+          setNotifs((prev) => (prev.some((x) => x.id === n.id) ? prev : [n, ...prev].slice(0, 100)));
+          setNotifUnread((c) => c + 1);
+          const who = n.actor_name || "Alguien";
+          const card = n.card_seq_num ? `#${n.card_seq_num}` : n.card_title;
+          notifications.show({
+            autoClose: 4000,
+            color: n.kind === "mention" ? "grape" : "blue",
+            title: `${who} en ${card}`,
+            message: n.snippet,
+          });
+        },
+        "notification.read": (payload: unknown) => {
+          const p = payload as { id?: string } | null;
+          if (!p?.id) return;
+          setNotifs((prev) => prev.map((x) => (x.id === p.id ? { ...x, read_at: new Date().toISOString() } : x)));
+          setNotifUnread((c) => Math.max(0, c - 1));
+        },
+        "notification.read_all": () => {
+          setNotifs((prev) => prev.map((x) => (x.read_at ? x : { ...x, read_at: new Date().toISOString() })));
+          setNotifUnread(0);
+        },
+      }),
+      [debouncedReload],
+    ),
+    !!auth.user,
+  );

  useEffect(() => {
    if (!activeSticker) return;
@@ -363,16 +449,21 @@ export function App() {
    (c: Card): boolean => {
      const term = searchTerm.trim().toLowerCase();
      if (term) {
+        const seqStr = c.seq_num > 0 ? String(c.seq_num) : "";
+        const seqPadded = c.seq_num > 0 ? String(c.seq_num).padStart(5, "0") : "";
        const hay = [
          c.title,
          c.description,
          c.requester,
+          seqStr,
+          seqPadded,
          ...(c.tags || []),
        ]
          .filter(Boolean)
          .join(" ")
          .toLowerCase();
-        if (!hay.includes(term)) return false;
+        const normalizedTerm = term.replace(/^#/, "").replace(/^0+(?=\d)/, "");
+        if (!hay.includes(term) && !(normalizedTerm && hay.includes(normalizedTerm))) return false;
      }
      if (filterAssigneeId && c.assignee_id !== filterAssigneeId) return false;
      if (filterUnassigned && c.assignee_id) return false;
@@ -658,7 +749,7 @@ export function App() {
    });
  }, [reload, users, auth.user, requesterOptions, tagOptions]);

-  const openEditCard = useCallback((card: Card) => {
+  const openEditCard = useCallback((card: Card, options?: { highlightMessageId?: string }) => {
    const id = modals.open({
      title: "Editar tarjeta",
      size: "85%",
@@ -669,6 +760,7 @@ export function App() {
          currentUserId={auth.user?.id}
          requesterOptions={requesterOptions}
          tagOptions={tagOptions}
+          highlightMessageId={options?.highlightMessageId}
          onCancel={() => modals.close(id)}
          onSubmit={async (v) => {
            try {
@@ -1113,6 +1205,38 @@ export function App() {
              <ActionIcon variant="subtle" onClick={reload} aria-label="Refresh">
                <IconRefresh size={16} />
              </ActionIcon>
+              {auth.user && (
+                <NotificationsBell
+                  unreadCount={notifUnread}
+                  notifications={notifs}
+                  onOpenCard={async (cardId, messageId) => {
+                    // Resolve the card across all possible buckets: live
+                    // board, refreshed board, archive, trash. Notifications
+                    // can point at any of them.
+                    const find = (cs?: Card[]) => cs?.find((c) => c.id === cardId);
+                    let card = find(board?.cards);
+                    if (!card) {
+                      await reload();
+                      const fresh = await api.getBoard();
+                      card = find(fresh.cards);
+                    }
+                    if (!card) {
+                      const archived = await api.listArchive();
+                      card = find(archived);
+                    }
+                    if (!card) {
+                      const trashed = await api.listTrash();
+                      card = find(trashed);
+                    }
+                    if (!card) {
+                      notifications.show({ color: "red", message: "Card no encontrada" });
+                      return;
+                    }
+                    openEditCard(card, { highlightMessageId: messageId });
+                  }}
+                  onChanged={reloadNotifs}
+                />
+              )}
              <ActionIcon
                variant={chatOpen ? "filled" : "subtle"}
                onClick={() => setChatOpen((v) => !v)}
@@ -1130,7 +1254,16 @@ export function App() {
                    </ActionIcon>
                  </Menu.Target>
                  <Menu.Dropdown>
-                    <Menu.Label>{auth.user.display_name || auth.user.username}</Menu.Label>
+                    <Menu.Label>
+                      <Group justify="space-between" gap={6} wrap="nowrap">
+                        <Text size="xs" fw={600} truncate>
+                          {auth.user.display_name || auth.user.username}
+                        </Text>
+                        {appVersion && (
+                          <Text size="xs" c="dimmed" ff="monospace">v{appVersion}</Text>
+                        )}
+                      </Group>
+                    </Menu.Label>
                    <Box p="xs">
                      <Text size="xs" c="dimmed" mb={4}>Color del avatar</Text>
                      <ColorPickerGrid
@@ -1151,6 +1284,20 @@ export function App() {
                      />
                    </Box>
                    <Menu.Divider />
+                    {auth.user.is_admin && (
+                      <Menu.Item
+                        leftSection={<IconPlug size={14} />}
+                        onClick={() => setModulesOpen(true)}
+                      >
+                        Modulos
+                      </Menu.Item>
+                    )}
+                    <Menu.Item
+                      leftSection={<IconKey size={14} />}
+                      onClick={() => setMcpTokensOpen(true)}
+                    >
+                      MCP tokens
+                    </Menu.Item>
                    <Menu.Item
                      leftSection={<IconLogout size={14} />}
                      color="red"
@@ -1161,6 +1308,10 @@ export function App() {
                  </Menu.Dropdown>
                </Menu>
              )}
+              {auth.user?.is_admin && (
+                <ModulesModal opened={modulesOpen} onClose={() => setModulesOpen(false)} />
+              )}
+              <MCPTokensModal opened={mcpTokensOpen} onClose={() => setMcpTokensOpen(false)} />
            </Group>
          </Group>
        </AppShell.Header>
@@ -5,8 +5,12 @@ import type {
  CardHistoryResponse,
  CardMessage,
  Column,
+  KanbanModule,
  Metrics,
  MetricsFilter,
+  ModuleLog,
+  ModuleTestResult,
+  Notification,
  Sticker,
  User,
 } from "./types";
@@ -28,6 +32,10 @@ export function getFlags(): Promise<Record<string, boolean>> {
  return fetchJSON("/flags");
 }

+export function getVersion(): Promise<{ version: string }> {
+  return fetchJSON("/version");
+}
+
 export function createColumn(name: string): Promise<Column> {
  return fetchJSON("/columns", { method: "POST", body: JSON.stringify({ name }) });
 }
@@ -292,6 +300,61 @@ export function chatWSURL(): string {
  return `${proto}//${window.location.host}/api/chat/ws`;
 }

+export function cardChatWSURL(cardId: string): string {
+  const proto = window.location.protocol === "https:" ? "wss:" : "ws:";
+  return `${proto}//${window.location.host}/api/cards/${cardId}/chat/ws`;
+}
+
+export function listNotifications(unreadOnly = false): Promise<Notification[]> {
+  return fetchJSON(`/notifications${unreadOnly ? "?unread=1" : ""}`);
+}
+
+export function unreadNotificationCount(): Promise<{ count: number }> {
+  return fetchJSON("/notifications/unread-count");
+}
+
+export function markNotificationRead(id: string): Promise<void> {
+  return fetchJSON(`/notifications/${id}/read`, { method: "POST" });
+}
+
+export function markAllNotificationsRead(): Promise<{ count: number }> {
+  return fetchJSON("/notifications/read-all", { method: "POST" });
+}
+
+export function listModules(): Promise<KanbanModule[]> {
+  return fetchJSON("/modules");
+}
+
+export interface ModuleInput {
+  name: string;
+  kind: string;
+  enabled: boolean;
+  event_filter: string[];
+  config: Record<string, unknown>;
+}
+
+export function createModule(body: ModuleInput): Promise<KanbanModule> {
+  return fetchJSON("/modules", { method: "POST", body: JSON.stringify(body) });
+}
+
+export function updateModule(id: string, patch: Partial<ModuleInput>): Promise<KanbanModule> {
+  return fetchJSON(`/modules/${id}`, { method: "PATCH", body: JSON.stringify(patch) });
+}
+
+export function deleteModule(id: string): Promise<void> {
+  return fetchJSON(`/modules/${id}`, { method: "DELETE" });
+}
+
+export function listModuleLogs(id: string, limit = 100): Promise<ModuleLog[]> {
+  return fetchJSON(`/modules/${id}/logs?limit=${limit}`);
+}
+
+export function testModule(idOrDraft: string, body?: ModuleInput): Promise<ModuleTestResult> {
+  const init: RequestInit = { method: "POST" };
+  if (body) init.body = JSON.stringify(body);
+  return fetchJSON(`/modules/${idOrDraft}/test`, init);
+}
+
 // streamChat opens a WebSocket, sends the message history, and streams events
 // to onEvent. Returns a Promise that resolves when the server closes the
 // connection (after a "done" event) and rejects on transport errors.
@@ -417,6 +480,31 @@ export function deleteCardFile(fileId: string): Promise<void> {
  return fetchJSON(`/files/${fileId}`, { method: "DELETE" });
 }

+// --- MCP per-user tokens ----------------------------------------------------
+
+export interface MCPToken {
+  id: string;
+  name: string;
+  created_at: string;
+  last_used_at?: string;
+}
+
+export interface MCPTokenCreated extends MCPToken {
+  token: string;
+}
+
+export function createMCPToken(name: string): Promise<MCPTokenCreated> {
+  return fetchJSON("/mcp-tokens", { method: "POST", body: JSON.stringify({ name }) });
+}
+
+export function listMCPTokens(): Promise<MCPToken[]> {
+  return fetchJSON("/mcp-tokens");
+}
+
+export function revokeMCPToken(id: string): Promise<void> {
+  return fetchJSON(`/mcp-tokens/${id}`, { method: "DELETE" });
+}
+
 export function getMetrics(f: MetricsFilter): Promise<Metrics> {
  const qs = new URLSearchParams();
  if (f.from) qs.set("from", f.from);
@@ -2,6 +2,7 @@ import {
  ActionIcon,
  Avatar,
  Box,
+  Combobox,
  FileButton,
  Group,
  Loader,
@@ -11,10 +12,19 @@ import {
  Text,
  Textarea,
  Tooltip,
+  useCombobox,
 } from "@mantine/core";
 import { IconPaperclip, IconSend, IconTrash } from "@tabler/icons-react";
 import { notifications } from "@mantine/notifications";
-import { DragEvent, KeyboardEvent, useCallback, useEffect, useRef, useState } from "react";
+import {
+  DragEvent,
+  KeyboardEvent,
+  useCallback,
+  useEffect,
+  useMemo,
+  useRef,
+  useState,
+} from "react";
 import * as api from "../api";
 import type { CardMessage, User } from "../types";
 import { tagColor } from "./colors";
@@ -27,6 +37,9 @@ interface Props {
  currentUserId?: string;
  onMessagesChange?: (messages: CardMessage[]) => void;
  onFileUploaded?: () => void;
+  // When set, the panel scrolls the matching message into view and flashes a
+  // brief highlight (~2s). Used by notification click → open card.
+  highlightMessageId?: string;
 }

 function refForFile(filename: string, url: string, mime: string): string {
@@ -34,16 +47,57 @@ function refForFile(filename: string, url: string, mime: string): string {
  return mime.startsWith("image/") ? `![${safe}](${url})` : `[${safe}](${url})`;
 }

-export function CardChatPanel({ cardId, users, currentUserId, onMessagesChange, onFileUploaded }: Props) {
+// Window for considering a peer "actively typing" after its last event.
+const TYPING_LIFETIME_MS = 4000;
+// Minimum gap between successive typing pings emitted while the user types.
+const TYPING_THROTTLE_MS = 1500;
+
+interface MentionMatch {
+  start: number; // index of '@' in the textarea value
+  query: string; // text after '@', lowercased
+}
+
+function detectMention(value: string, cursor: number): MentionMatch | null {
+  // Look backwards from cursor for an '@' that starts a word.
+  for (let i = cursor - 1; i >= 0 && cursor - i <= 64; i--) {
+    const ch = value[i];
+    if (ch === "@") {
+      // Valid start: beginning of string or whitespace before.
+      if (i === 0 || /\s/.test(value[i - 1])) {
+        const q = value.slice(i + 1, cursor);
+        if (/^[a-z0-9_.-]*$/i.test(q)) {
+          return { start: i, query: q.toLowerCase() };
+        }
+      }
+      return null;
+    }
+    if (/\s/.test(ch)) return null;
+  }
+  return null;
+}
+
+export function CardChatPanel({
+  cardId,
+  users,
+  currentUserId,
+  onMessagesChange,
+  onFileUploaded,
+  highlightMessageId,
+}: Props) {
  const [messages, setMessages] = useState<CardMessage[]>([]);
  const [loading, setLoading] = useState(true);
  const [body, setBody] = useState("");
  const [sending, setSending] = useState(false);
  const [uploading, setUploading] = useState(false);
  const [dragOver, setDragOver] = useState(false);
+  const [typingUsers, setTypingUsers] = useState<Record<string, number>>({});
+  const [mention, setMention] = useState<MentionMatch | null>(null);
  const viewportRef = useRef<HTMLDivElement | null>(null);
+  const wsRef = useRef<WebSocket | null>(null);
+  const textareaRef = useRef<HTMLTextAreaElement | null>(null);
+  const lastTypingEmitRef = useRef(0);

-  const usersById = new Map(users.map((u) => [u.id, u]));
+  const usersById = useMemo(() => new Map(users.map((u) => [u.id, u])), [users]);

  const reload = useCallback(async () => {
    try {
@@ -61,22 +115,142 @@ export function CardChatPanel({ cardId, users, currentUserId, onMessagesChange,
    reload();
  }, [reload]);

+  // Open one WebSocket per cardId for realtime chat + typing.
+  useEffect(() => {
+    const ws = new WebSocket(api.cardChatWSURL(cardId));
+    wsRef.current = ws;
+    ws.onmessage = (ev) => {
+      try {
+        const data = JSON.parse(ev.data) as
+          | { type: "message.created"; message: CardMessage }
+          | { type: "typing"; user_id: string }
+          | { type: "error"; error: string };
+        if (data.type === "message.created" && data.message) {
+          setMessages((prev) => {
+            if (prev.some((m) => m.id === data.message!.id)) return prev;
+            const next = [...prev, data.message!];
+            onMessagesChange?.(next);
+            return next;
+          });
+        } else if (data.type === "typing" && data.user_id) {
+          setTypingUsers((prev) => ({ ...prev, [data.user_id]: Date.now() }));
+        } else if (data.type === "error") {
+          notifications.show({ color: "red", message: data.error });
+        }
+      } catch {
+        // ignore malformed
+      }
+    };
+    ws.onerror = () => {
+      // browser will report; we keep the panel functional via REST fallback
+    };
+    return () => {
+      ws.close();
+      wsRef.current = null;
+    };
+  }, [cardId, onMessagesChange]);
+
+  // Sweep stale typing entries.
+  useEffect(() => {
+    const t = setInterval(() => {
+      const now = Date.now();
+      setTypingUsers((prev) => {
+        const next: Record<string, number> = {};
+        for (const [k, v] of Object.entries(prev)) {
+          if (now - v < TYPING_LIFETIME_MS) next[k] = v;
+        }
+        return next;
+      });
+    }, 1000);
+    return () => clearInterval(t);
+  }, []);
+
  useEffect(() => {
    if (viewportRef.current) {
      viewportRef.current.scrollTo({ top: viewportRef.current.scrollHeight, behavior: "smooth" });
    }
  }, [messages.length]);

+  // Scroll to + briefly pulse the message that triggered an incoming
+  // notification. Runs whenever the highlight id changes AND the message
+  // is present in the list (it may arrive asynchronously after WS sync).
+  const [pulse, setPulse] = useState<string | null>(null);
+  useEffect(() => {
+    if (!highlightMessageId) return;
+    if (!messages.some((m) => m.id === highlightMessageId)) return;
+    const el = document.querySelector(`[data-msg-id="${highlightMessageId}"]`);
+    if (el && el instanceof HTMLElement) {
+      el.scrollIntoView({ behavior: "smooth", block: "center" });
+    }
+    setPulse(highlightMessageId);
+    const t = setTimeout(() => setPulse(null), 2200);
+    return () => clearTimeout(t);
+  }, [highlightMessageId, messages]);
+
+  const sendTypingPing = () => {
+    const ws = wsRef.current;
+    if (!ws || ws.readyState !== WebSocket.OPEN) return;
+    const now = Date.now();
+    if (now - lastTypingEmitRef.current < TYPING_THROTTLE_MS) return;
+    lastTypingEmitRef.current = now;
+    ws.send(JSON.stringify({ type: "typing" }));
+  };
+
+  const combobox = useCombobox({
+    onDropdownClose: () => setMention(null),
+  });
+
+  const mentionCandidates = useMemo(() => {
+    if (!mention) return [] as User[];
+    return users
+      .filter((u) => u.username.toLowerCase().startsWith(mention.query))
+      .slice(0, 8);
+  }, [users, mention]);
+
+  useEffect(() => {
+    if (mention && mentionCandidates.length > 0) {
+      combobox.openDropdown();
+      combobox.selectFirstOption();
+    } else {
+      combobox.closeDropdown();
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [mention?.query, mentionCandidates.length]);
+
+  const insertMention = (username: string) => {
+    if (!mention) return;
+    const before = body.slice(0, mention.start);
+    const after = body.slice(mention.start + 1 + mention.query.length);
+    const inserted = `@${username} `;
+    const next = before + inserted + after;
+    setBody(next);
+    setMention(null);
+    // Restore caret right after the inserted mention.
+    requestAnimationFrame(() => {
+      const el = textareaRef.current;
+      if (!el) return;
+      const pos = (before + inserted).length;
+      el.focus();
+      el.setSelectionRange(pos, pos);
+    });
+  };
+
  const send = async () => {
    const text = body.trim();
    if (!text || sending) return;
    setSending(true);
+    const ws = wsRef.current;
    try {
-      const m = await api.createCardMessage(cardId, text);
-      const next = [...messages, m];
-      setMessages(next);
-      onMessagesChange?.(next);
-      setBody("");
+      if (ws && ws.readyState === WebSocket.OPEN) {
+        ws.send(JSON.stringify({ type: "send", body: text }));
+        // Optimistic clear; server will broadcast the persisted message.
+        setBody("");
+      } else {
+        const m = await api.createCardMessage(cardId, text);
+        setMessages((prev) => [...prev, m]);
+        onMessagesChange?.([...messages, m]);
+        setBody("");
+      }
    } catch (e) {
      notifications.show({ color: "red", message: (e as Error).message });
    } finally {
@@ -95,7 +269,25 @@ export function CardChatPanel({ cardId, users, currentUserId, onMessagesChange,
    }
  };

+  const onChange = (e: React.ChangeEvent<HTMLTextAreaElement>) => {
+    setBody(e.currentTarget.value);
+    sendTypingPing();
+    const cursor = e.currentTarget.selectionStart ?? e.currentTarget.value.length;
+    setMention(detectMention(e.currentTarget.value, cursor));
+  };
+
  const onKeyDown = (e: KeyboardEvent<HTMLTextAreaElement>) => {
+    if (mention && mentionCandidates.length > 0 && (e.key === "Enter" || e.key === "Tab")) {
+      e.preventDefault();
+      const sel = combobox.getSelectedOptionIndex();
+      const pick = mentionCandidates[Math.max(0, sel)];
+      if (pick) insertMention(pick.username);
+      return;
+    }
+    if (mention && e.key === "Escape") {
+      setMention(null);
+      return;
+    }
    if (e.key === "Enter" && !e.shiftKey) {
      e.preventDefault();
      send();
@@ -143,6 +335,13 @@ export function CardChatPanel({ cardId, users, currentUserId, onMessagesChange,
    setDragOver(false);
  };

+  const typingNames = Object.keys(typingUsers)
+    .filter((uid) => uid !== currentUserId)
+    .map((uid) => {
+      const u = usersById.get(uid);
+      return u?.display_name || u?.username || "alguien";
+    });
+
  return (
    <Stack
      gap="xs"
@@ -176,13 +375,25 @@ export function CardChatPanel({ cardId, users, currentUserId, onMessagesChange,
              const author = m.author_id ? usersById.get(m.author_id) : null;
              const isMe = m.author_id && m.author_id === currentUserId;
              const label = author ? author.display_name || author.username : "Anonimo";
+              const highlighted = pulse === m.id;
              return (
                <Paper
                  key={m.id}
                  withBorder
                  p="xs"
                  radius="sm"
-                  bg={isMe ? "var(--mantine-color-blue-light)" : undefined}
+                  data-msg-id={m.id}
+                  bg={
+                    highlighted
+                      ? "var(--mantine-color-yellow-light)"
+                      : isMe
+                      ? "var(--mantine-color-blue-light)"
+                      : undefined
+                  }
+                  style={{
+                    transition: "background-color 600ms ease",
+                    boxShadow: highlighted ? "0 0 0 2px var(--mantine-color-yellow-5)" : undefined,
+                  }}
                >
                  <Group gap={6} wrap="nowrap" align="flex-start">
                    <Avatar size={22} radius="xl" color={author?.color || tagColor(label)}>
@@ -213,47 +424,81 @@ export function CardChatPanel({ cardId, users, currentUserId, onMessagesChange,
          </Stack>
        )}
      </ScrollArea>
-      <Group gap="xs" align="flex-end">
-        <Textarea
-          value={body}
-          onChange={(e) => setBody(e.currentTarget.value)}
-          onKeyDown={onKeyDown}
-          placeholder="Escribe un mensaje. Arrastra archivos o usa el clip."
-          autosize
-          minRows={1}
-          maxRows={6}
-          style={{ flex: 1 }}
-          disabled={sending}
-        />
-        <FileButton onChange={(file) => file && handleFiles([file])} disabled={uploading}>
-          {(props) => (
-            <Tooltip label="Adjuntar archivo" withArrow>
+      {typingNames.length > 0 && (
+        <Text size="xs" c="dimmed" px={6}>
+          {typingNames.length === 1
+            ? `${typingNames[0]} esta escribiendo...`
+            : `${typingNames.slice(0, 2).join(", ")}${typingNames.length > 2 ? "..." : ""} estan escribiendo...`}
+        </Text>
+      )}
+      <Combobox
+        store={combobox}
+        onOptionSubmit={(value) => insertMention(value)}
+        position="top-start"
+        withinPortal={false}
+      >
+        <Combobox.DropdownTarget>
+          <Group gap="xs" align="flex-end">
+            <Textarea
+              ref={textareaRef}
+              value={body}
+              onChange={onChange}
+              onKeyDown={onKeyDown}
+              placeholder="Escribe un mensaje (Enter = enviar, @ para mencionar). Arrastra archivos o usa el clip."
+              autosize
+              minRows={1}
+              maxRows={6}
+              style={{ flex: 1 }}
+              disabled={sending}
+            />
+            <FileButton onChange={(file) => file && handleFiles([file])} disabled={uploading}>
+              {(props) => (
+                <Tooltip label="Adjuntar archivo" withArrow>
+                  <ActionIcon
+                    size="lg"
+                    variant="subtle"
+                    color="gray"
+                    aria-label="Adjuntar"
+                    loading={uploading}
+                    {...props}
+                  >
+                    <IconPaperclip size={16} />
+                  </ActionIcon>
+                </Tooltip>
+              )}
+            </FileButton>
+            <Tooltip label="Enviar" withArrow>
              <ActionIcon
                size="lg"
-                variant="subtle"
-                color="gray"
-                aria-label="Adjuntar"
-                loading={uploading}
-                {...props}
+                variant="filled"
+                color="blue"
+                onClick={send}
+                disabled={!body.trim() || sending}
+                aria-label="Enviar"
              >
-                <IconPaperclip size={16} />
+                <IconSend size={16} />
              </ActionIcon>
            </Tooltip>
-          )}
-        </FileButton>
-        <Tooltip label="Enviar" withArrow>
-          <ActionIcon
-            size="lg"
-            variant="filled"
-            color="blue"
-            onClick={send}
-            disabled={!body.trim() || sending}
-            aria-label="Enviar"
-          >
-            <IconSend size={16} />
-          </ActionIcon>
-        </Tooltip>
-      </Group>
+          </Group>
+        </Combobox.DropdownTarget>
+        <Combobox.Dropdown hidden={!mention || mentionCandidates.length === 0}>
+          <Combobox.Options>
+            {mentionCandidates.map((u) => (
+              <Combobox.Option key={u.id} value={u.username}>
+                <Group gap={6} wrap="nowrap">
+                  <Avatar size={18} radius="xl" color={u.color || tagColor(u.username)}>
+                    {(u.display_name || u.username).slice(0, 2).toUpperCase()}
+                  </Avatar>
+                  <Text size="sm" fw={600}>@{u.username}</Text>
+                  {u.display_name && u.display_name !== u.username && (
+                    <Text size="xs" c="dimmed">{u.display_name}</Text>
+                  )}
+                </Group>
+              </Combobox.Option>
+            ))}
+          </Combobox.Options>
+        </Combobox.Dropdown>
+      </Combobox>
      {(dragOver || uploading) && (
        <Box
          style={{
@@ -15,6 +15,9 @@ interface Props {
  tagOptions: string[];
  onSubmit: (v: CardFormValues) => Promise<void> | void;
  onCancel: () => void;
+  // When set, the chat panel auto-scrolls to this message id and pulses
+  // it briefly. Used when opening a card from a notification click.
+  highlightMessageId?: string;
 }

 export function CardEditPanel({
@@ -25,6 +28,7 @@ export function CardEditPanel({
  tagOptions,
  onSubmit,
  onCancel,
+  highlightMessageId,
 }: Props) {
  const [messages, setMessages] = useState<CardMessage[]>([]);
  const [liveCard, setLiveCard] = useState(card);
@@ -75,6 +79,7 @@ export function CardEditPanel({
                  currentUserId={currentUserId}
                  onMessagesChange={setMessages}
                  onFileUploaded={bumpFiles}
+                  highlightMessageId={highlightMessageId}
                />
              </Box>
            </Tabs.Panel>
@@ -25,12 +25,17 @@ export function LoginPage() {
  const [submitting, setSubmitting] = useState(false);
  const [error, setError] = useState<string | null>(null);
  const [registrationEnabled, setRegistrationEnabled] = useState(false);
+  const [appVersion, setAppVersion] = useState<string>("");

  useEffect(() => {
    api
      .getFlags()
      .then((f) => setRegistrationEnabled(!!f["registration-enabled"]))
      .catch(() => setRegistrationEnabled(false));
+    api
+      .getVersion()
+      .then((v) => setAppVersion(v.version))
+      .catch(() => setAppVersion(""));
  }, []);

  useEffect(() => {
@@ -62,6 +67,9 @@ export function LoginPage() {
            <Stack gap={4} align="center">
              <IconLayoutKanban size={36} />
              <Title order={3}>Kanban</Title>
+              {appVersion && (
+                <Text size="xs" c="dimmed" ff="monospace">v{appVersion}</Text>
+              )}
              <Text size="sm" c="dimmed">
                {mode === "login" ? "Inicia sesion" : "Crea una cuenta"}
              </Text>
@@ -0,0 +1,192 @@
+import {
+  ActionIcon,
+  Alert,
+  Box,
+  Button,
+  Code,
+  CopyButton,
+  Divider,
+  Group,
+  Loader,
+  Modal,
+  Stack,
+  Table,
+  Text,
+  TextInput,
+  Tooltip,
+} from "@mantine/core";
+import { notifications } from "@mantine/notifications";
+import { IconCopy, IconCheck, IconTrash } from "@tabler/icons-react";
+import { useCallback, useEffect, useState } from "react";
+import * as api from "../api";
+import type { MCPToken, MCPTokenCreated } from "../api";
+import { formatDateTimeShort } from "./format";
+
+interface Props {
+  opened: boolean;
+  onClose: () => void;
+}
+
+export function MCPTokensModal({ opened, onClose }: Props) {
+  const [tokens, setTokens] = useState<MCPToken[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [newName, setNewName] = useState("");
+  const [creating, setCreating] = useState(false);
+  const [justCreated, setJustCreated] = useState<MCPTokenCreated | null>(null);
+
+  const reload = useCallback(async () => {
+    setLoading(true);
+    try {
+      setTokens(await api.listMCPTokens());
+    } catch (e) {
+      notifications.show({ color: "red", message: (e as Error).message });
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    if (opened) {
+      reload();
+      setJustCreated(null);
+      setNewName("");
+    }
+  }, [opened, reload]);
+
+  const create = async () => {
+    const name = newName.trim() || "default";
+    setCreating(true);
+    try {
+      const t = await api.createMCPToken(name);
+      setJustCreated(t);
+      setNewName("");
+      await reload();
+    } catch (e) {
+      notifications.show({ color: "red", message: (e as Error).message });
+    } finally {
+      setCreating(false);
+    }
+  };
+
+  const revoke = async (id: string) => {
+    if (!confirm("Revocar este token? Quien lo este usando dejara de tener acceso.")) return;
+    try {
+      await api.revokeMCPToken(id);
+      await reload();
+    } catch (e) {
+      notifications.show({ color: "red", message: (e as Error).message });
+    }
+  };
+
+  const mcpURL = `${window.location.origin}/mcp`;
+  const claudeCmd = justCreated
+    ? `claude mcp add kanban --transport http ${mcpURL} --header "Authorization: Bearer ${justCreated.token}"`
+    : "";
+
+  return (
+    <Modal opened={opened} onClose={onClose} title="MCP Tokens" size="lg">
+      <Stack gap="md">
+        <Text size="sm" c="dimmed">
+          Cada token deja conectar un cliente Claude al kanban como tu usuario.
+          El valor solo aparece UNA vez al crearlo. Si lo pierdes, generas otro y revocas el antiguo.
+        </Text>
+
+        <Group align="end">
+          <TextInput
+            label="Nombre del token"
+            placeholder="ej. portatil, sobremesa..."
+            value={newName}
+            onChange={(e) => setNewName(e.currentTarget.value)}
+            style={{ flex: 1 }}
+            disabled={creating}
+          />
+          <Button onClick={create} loading={creating}>
+            Generar
+          </Button>
+        </Group>
+
+        {justCreated && (
+          <Alert color="yellow" title="Copia el token ahora — no se mostrara mas">
+            <Stack gap="xs">
+              <Group gap="xs" align="center">
+                <Code style={{ flex: 1, wordBreak: "break-all" }}>{justCreated.token}</Code>
+                <CopyButton value={justCreated.token}>
+                  {({ copied, copy }) => (
+                    <Tooltip label={copied ? "Copiado" : "Copiar token"}>
+                      <ActionIcon variant="subtle" onClick={copy}>
+                        {copied ? <IconCheck size={16} /> : <IconCopy size={16} />}
+                      </ActionIcon>
+                    </Tooltip>
+                  )}
+                </CopyButton>
+              </Group>
+              <Divider />
+              <Text size="xs" c="dimmed">
+                Pega este comando en tu PC para registrar el MCP en Claude Code:
+              </Text>
+              <Group gap="xs" align="center">
+                <Code block style={{ flex: 1 }}>{claudeCmd}</Code>
+                <CopyButton value={claudeCmd}>
+                  {({ copied, copy }) => (
+                    <Tooltip label={copied ? "Copiado" : "Copiar comando"}>
+                      <ActionIcon variant="subtle" onClick={copy}>
+                        {copied ? <IconCheck size={16} /> : <IconCopy size={16} />}
+                      </ActionIcon>
+                    </Tooltip>
+                  )}
+                </CopyButton>
+              </Group>
+            </Stack>
+          </Alert>
+        )}
+
+        <Divider label="Tokens activos" labelPosition="left" />
+
+        {loading ? (
+          <Group justify="center" p="md">
+            <Loader size="sm" />
+          </Group>
+        ) : tokens.length === 0 ? (
+          <Text size="sm" c="dimmed" ta="center" py="md">
+            Sin tokens. Genera uno arriba.
+          </Text>
+        ) : (
+          <Table withTableBorder withColumnBorders verticalSpacing="xs" highlightOnHover>
+            <Table.Thead>
+              <Table.Tr>
+                <Table.Th>Nombre</Table.Th>
+                <Table.Th>Creado</Table.Th>
+                <Table.Th>Ultimo uso</Table.Th>
+                <Table.Th w={60} />
+              </Table.Tr>
+            </Table.Thead>
+            <Table.Tbody>
+              {tokens.map((t) => (
+                <Table.Tr key={t.id}>
+                  <Table.Td>{t.name}</Table.Td>
+                  <Table.Td>{formatDateTimeShort(t.created_at)}</Table.Td>
+                  <Table.Td>
+                    {t.last_used_at ? formatDateTimeShort(t.last_used_at) : <Text c="dimmed">nunca</Text>}
+                  </Table.Td>
+                  <Table.Td>
+                    <Tooltip label="Revocar">
+                      <ActionIcon color="red" variant="subtle" onClick={() => revoke(t.id)}>
+                        <IconTrash size={14} />
+                      </ActionIcon>
+                    </Tooltip>
+                  </Table.Td>
+                </Table.Tr>
+              ))}
+            </Table.Tbody>
+          </Table>
+        )}
+
+        <Box>
+          <Text size="xs" c="dimmed">
+            Endpoint MCP: <Code>{mcpURL}</Code>
+          </Text>
+        </Box>
+      </Stack>
+    </Modal>
+  );
+}
@@ -0,0 +1,441 @@
+import {
+  ActionIcon,
+  Alert,
+  Badge,
+  Box,
+  Button,
+  Checkbox,
+  Code,
+  Divider,
+  Group,
+  JsonInput,
+  Loader,
+  Modal,
+  ScrollArea,
+  Select,
+  Stack,
+  Table,
+  Tabs,
+  Text,
+  TextInput,
+  Tooltip,
+} from "@mantine/core";
+import { notifications } from "@mantine/notifications";
+import { IconPlug, IconPlugConnected, IconRefresh, IconTestPipe, IconTrash } from "@tabler/icons-react";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import * as api from "../api";
+import type { KanbanModule, ModuleLog } from "../types";
+import { formatDateTimeShort } from "./format";
+
+interface Props {
+  opened: boolean;
+  onClose: () => void;
+}
+
+const KANBAN_EVENTS = [
+  "card.created",
+  "card.updated",
+  "card.moved",
+  "card.deleted",
+  "message.created",
+  "board.invalidated",
+];
+
+const DEFAULT_JIRA_CONFIG = {
+  base_url: "",
+  email: "",
+  api_token: "",
+  project_key: "",
+  status_map: {
+    "Por hacer": "To Do",
+    "Doing": "In Progress",
+    "Done": "Done",
+  },
+};
+
+export function ModulesModal({ opened, onClose }: Props) {
+  const [modules, setModules] = useState<KanbanModule[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [selectedId, setSelectedId] = useState<string | null>(null);
+  const [editing, setEditing] = useState<KanbanModule | null>(null);
+  const [logs, setLogs] = useState<ModuleLog[]>([]);
+  const [logsLoading, setLogsLoading] = useState(false);
+  const [activeTab, setActiveTab] = useState<string | null>("form");
+
+  const reload = useCallback(async () => {
+    setLoading(true);
+    try {
+      const list = await api.listModules();
+      setModules(list);
+    } catch (e) {
+      notifications.show({ color: "red", message: (e as Error).message });
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    if (opened) reload();
+  }, [opened, reload]);
+
+  const reloadLogs = useCallback(async (id: string) => {
+    setLogsLoading(true);
+    try {
+      const out = await api.listModuleLogs(id);
+      setLogs(out);
+    } catch (e) {
+      notifications.show({ color: "red", message: (e as Error).message });
+    } finally {
+      setLogsLoading(false);
+    }
+  }, []);
+
+  const select = (m: KanbanModule | null) => {
+    setEditing(m ? { ...m, config: { ...m.config } } : null);
+    setSelectedId(m?.id ?? null);
+    setActiveTab("form");
+    setLogs([]);
+    if (m) reloadLogs(m.id);
+  };
+
+  const startNew = () => {
+    const blank: KanbanModule = {
+      id: "",
+      name: "Nuevo modulo",
+      kind: "jira",
+      enabled: false,
+      event_filter: ["card.created", "card.updated", "card.moved", "message.created"],
+      config: { ...DEFAULT_JIRA_CONFIG, status_map: { ...DEFAULT_JIRA_CONFIG.status_map } },
+      created_at: "",
+      updated_at: "",
+    };
+    setEditing(blank);
+    setSelectedId(null);
+    setActiveTab("form");
+    setLogs([]);
+  };
+
+  const save = async () => {
+    if (!editing) return;
+    try {
+      const payload = {
+        name: editing.name,
+        kind: editing.kind,
+        enabled: editing.enabled,
+        event_filter: editing.event_filter,
+        config: editing.config,
+      };
+      const saved = editing.id
+        ? await api.updateModule(editing.id, payload)
+        : await api.createModule(payload);
+      notifications.show({ color: "green", message: "Modulo guardado" });
+      await reload();
+      select(saved);
+    } catch (e) {
+      notifications.show({ color: "red", message: (e as Error).message });
+    }
+  };
+
+  const remove = async () => {
+    if (!selectedId) return;
+    if (!confirm("Borrar modulo?")) return;
+    try {
+      await api.deleteModule(selectedId);
+      notifications.show({ color: "green", message: "Modulo borrado" });
+      setEditing(null);
+      setSelectedId(null);
+      reload();
+    } catch (e) {
+      notifications.show({ color: "red", message: (e as Error).message });
+    }
+  };
+
+  const test = async () => {
+    if (!editing) return;
+    try {
+      const result = editing.id
+        ? await api.testModule(editing.id)
+        : await api.testModule("draft", {
+            name: editing.name,
+            kind: editing.kind,
+            enabled: editing.enabled,
+            event_filter: editing.event_filter,
+            config: editing.config,
+          });
+      if (result.ok) {
+        notifications.show({
+          color: "green",
+          title: `Test OK (${result.status})`,
+          message: `Conexion verificada en ${result.duration_ms}ms`,
+        });
+      } else {
+        notifications.show({
+          color: "red",
+          title: `Test fallo (${result.status})`,
+          message: result.error || "sin detalle",
+        });
+      }
+    } catch (e) {
+      notifications.show({ color: "red", message: (e as Error).message });
+    }
+  };
+
+  return (
+    <Modal
+      opened={opened}
+      onClose={onClose}
+      title={
+        <Group gap={8}>
+          <IconPlug size={18} />
+          <Text fw={600}>Modulos / Integraciones</Text>
+        </Group>
+      }
+      size="xl"
+      centered
+    >
+      <Group align="flex-start" gap="md" wrap="nowrap">
+        <Box style={{ width: 220, minWidth: 220 }}>
+          <Group justify="space-between" mb={6}>
+            <Text size="xs" c="dimmed">Configurados</Text>
+            <Tooltip label="Refrescar" withArrow>
+              <ActionIcon size="sm" variant="subtle" onClick={reload}>
+                <IconRefresh size={14} />
+              </ActionIcon>
+            </Tooltip>
+          </Group>
+          <ScrollArea h={400} type="auto">
+            <Stack gap={4}>
+              {loading && <Loader size="xs" />}
+              {modules.map((m) => (
+                <Box
+                  key={m.id}
+                  p="xs"
+                  style={{
+                    cursor: "pointer",
+                    border: "1px solid var(--mantine-color-gray-3)",
+                    borderRadius: 4,
+                    background:
+                      selectedId === m.id ? "var(--mantine-color-blue-light)" : undefined,
+                  }}
+                  onClick={() => select(m)}
+                >
+                  <Group justify="space-between" gap={4} wrap="nowrap">
+                    <Text size="sm" fw={600} truncate>
+                      {m.name}
+                    </Text>
+                    <Badge size="xs" color={m.enabled ? "green" : "gray"}>
+                      {m.enabled ? "on" : "off"}
+                    </Badge>
+                  </Group>
+                  <Text size="xs" c="dimmed">{m.kind}</Text>
+                </Box>
+              ))}
+              <Button size="xs" variant="light" onClick={startNew} mt="xs">
+                + Nuevo
+              </Button>
+            </Stack>
+          </ScrollArea>
+        </Box>
+
+        <Divider orientation="vertical" />
+
+        <Box style={{ flex: 1, minWidth: 0 }}>
+          {!editing ? (
+            <Alert color="gray">Selecciona un modulo o pulsa "Nuevo".</Alert>
+          ) : (
+            <Tabs value={activeTab} onChange={setActiveTab}>
+              <Tabs.List>
+                <Tabs.Tab value="form">Configuracion</Tabs.Tab>
+                <Tabs.Tab value="logs">Logs</Tabs.Tab>
+              </Tabs.List>
+
+              <Tabs.Panel value="form" pt="xs">
+                <Stack gap="xs">
+                  <Group gap="xs">
+                    <TextInput
+                      label="Nombre"
+                      value={editing.name}
+                      onChange={(e) => setEditing({ ...editing, name: e.currentTarget.value })}
+                      style={{ flex: 1 }}
+                    />
+                    <Select
+                      label="Kind"
+                      value={editing.kind}
+                      onChange={(v) => setEditing({ ...editing, kind: v || "jira" })}
+                      data={[{ value: "jira", label: "Jira" }]}
+                      w={140}
+                    />
+                  </Group>
+                  <Checkbox
+                    label="Activo"
+                    checked={editing.enabled}
+                    onChange={(e) => setEditing({ ...editing, enabled: e.currentTarget.checked })}
+                  />
+                  <Box>
+                    <Text size="xs" fw={600} mb={4}>Eventos</Text>
+                    <Group gap="xs">
+                      {KANBAN_EVENTS.map((ev) => (
+                        <Checkbox
+                          key={ev}
+                          label={<Code>{ev}</Code>}
+                          checked={editing.event_filter.includes(ev)}
+                          onChange={(e) => {
+                            const next = e.currentTarget.checked
+                              ? [...editing.event_filter, ev]
+                              : editing.event_filter.filter((x) => x !== ev);
+                            setEditing({ ...editing, event_filter: next });
+                          }}
+                        />
+                      ))}
+                    </Group>
+                  </Box>
+                  <JiraConfigEditor editing={editing} setEditing={setEditing} />
+                  <Group gap="xs">
+                    <Button onClick={save} leftSection={<IconPlugConnected size={14} />}>
+                      Guardar
+                    </Button>
+                    <Button variant="default" onClick={test} leftSection={<IconTestPipe size={14} />}>
+                      Probar conexion
+                    </Button>
+                    {selectedId && (
+                      <Button
+                        color="red"
+                        variant="subtle"
+                        onClick={remove}
+                        leftSection={<IconTrash size={14} />}
+                        ml="auto"
+                      >
+                        Borrar
+                      </Button>
+                    )}
+                  </Group>
+                </Stack>
+              </Tabs.Panel>
+
+              <Tabs.Panel value="logs" pt="xs">
+                <Group justify="space-between" mb={6}>
+                  <Text size="xs" c="dimmed">Ultimas 100 entradas</Text>
+                  <ActionIcon
+                    size="sm"
+                    variant="subtle"
+                    onClick={() => selectedId && reloadLogs(selectedId)}
+                  >
+                    <IconRefresh size={14} />
+                  </ActionIcon>
+                </Group>
+                {logsLoading ? (
+                  <Loader size="sm" />
+                ) : logs.length === 0 ? (
+                  <Text size="sm" c="dimmed">Sin entradas.</Text>
+                ) : (
+                  <ScrollArea h={400}>
+                    <Table withTableBorder striped highlightOnHover stickyHeader>
+                      <Table.Thead>
+                        <Table.Tr>
+                          <Table.Th>Hora</Table.Th>
+                          <Table.Th>Evento</Table.Th>
+                          <Table.Th>HTTP</Table.Th>
+                          <Table.Th>ms</Table.Th>
+                          <Table.Th>Error</Table.Th>
+                        </Table.Tr>
+                      </Table.Thead>
+                      <Table.Tbody>
+                        {logs.map((l) => (
+                          <Table.Tr key={l.id}>
+                            <Table.Td>{formatDateTimeShort(l.created_at)}</Table.Td>
+                            <Table.Td><Code>{l.event_type}</Code></Table.Td>
+                            <Table.Td>
+                              <Badge color={l.status >= 400 || l.error ? "red" : "green"} size="sm">
+                                {l.status || "-"}
+                              </Badge>
+                            </Table.Td>
+                            <Table.Td>{l.duration_ms}</Table.Td>
+                            <Table.Td>
+                              <Text size="xs" c="red" lineClamp={2}>{l.error}</Text>
+                            </Table.Td>
+                          </Table.Tr>
+                        ))}
+                      </Table.Tbody>
+                    </Table>
+                  </ScrollArea>
+                )}
+              </Tabs.Panel>
+            </Tabs>
+          )}
+        </Box>
+      </Group>
+    </Modal>
+  );
+}
+
+interface JiraConfigEditorProps {
+  editing: KanbanModule;
+  setEditing: (m: KanbanModule) => void;
+}
+
+function JiraConfigEditor({ editing, setEditing }: JiraConfigEditorProps) {
+  const cfg = editing.config as Record<string, unknown>;
+  const set = (key: string, value: unknown) =>
+    setEditing({ ...editing, config: { ...cfg, [key]: value } });
+
+  const statusMapText = useMemo(() => {
+    return JSON.stringify(cfg.status_map ?? {}, null, 2);
+  }, [cfg.status_map]);
+
+  if (editing.kind !== "jira") {
+    return (
+      <Alert color="yellow" mt="xs">
+        Editor especifico para esta kind aun no implementado.
+      </Alert>
+    );
+  }
+
+  return (
+    <Stack gap="xs">
+      <TextInput
+        label="Base URL"
+        placeholder="https://acme.atlassian.net"
+        value={(cfg.base_url as string) || ""}
+        onChange={(e) => set("base_url", e.currentTarget.value)}
+      />
+      <Group gap="xs">
+        <TextInput
+          label="Email"
+          value={(cfg.email as string) || ""}
+          onChange={(e) => set("email", e.currentTarget.value)}
+          style={{ flex: 1 }}
+        />
+        <TextInput
+          label="API token"
+          placeholder={editing.id ? "*** (deja vacio para conservar)" : ""}
+          value={(cfg.api_token as string) || ""}
+          onChange={(e) => set("api_token", e.currentTarget.value)}
+          style={{ flex: 1 }}
+        />
+      </Group>
+      <TextInput
+        label="Project key"
+        placeholder="KAN"
+        value={(cfg.project_key as string) || ""}
+        onChange={(e) => set("project_key", e.currentTarget.value)}
+      />
+      <JsonInput
+        label="Status map (columna kanban → transicion Jira)"
+        description='{"Doing":"In Progress","Done":"Done"}'
+        value={statusMapText}
+        autosize
+        minRows={3}
+        validationError="JSON invalido"
+        onChange={(v) => {
+          try {
+            const parsed = JSON.parse(v);
+            set("status_map", parsed);
+          } catch {
+            // Hold invalid input in textarea via raw state; final save will
+            // reuse last valid parse.
+          }
+        }}
+      />
+    </Stack>
+  );
+}
@@ -0,0 +1,199 @@
+import {
+  ActionIcon,
+  Badge,
+  Box,
+  Button,
+  Group,
+  Indicator,
+  Loader,
+  Popover,
+  ScrollArea,
+  Stack,
+  Text,
+  Tooltip,
+  UnstyledButton,
+} from "@mantine/core";
+import { IconAt, IconBell, IconCheck, IconMessage, IconUserCheck } from "@tabler/icons-react";
+import { ReactElement, useCallback, useEffect, useState } from "react";
+import * as api from "../api";
+import type { Notification, NotificationKind } from "../types";
+import { formatDateTimeShort } from "./format";
+
+interface Props {
+  // External counter — App.tsx updates this via SSE events. When undefined
+  // the bell polls /api/notifications/unread-count on mount.
+  unreadCount?: number;
+  notifications?: Notification[];
+  // Called when the user clicks a notification → open the relevant card.
+  // messageId points to the chat message that triggered the notification so
+  // the parent can scroll to it.
+  onOpenCard?: (cardId: string, messageId: string) => void;
+  // Called whenever the bell mutates state (mark read / mark all) so the
+  // parent can refresh its cached lists.
+  onChanged?: () => void;
+}
+
+const kindIcon: Record<NotificationKind, ReactElement> = {
+  mention: <IconAt size={14} />,
+  assigned_chat: <IconUserCheck size={14} />,
+  reply: <IconMessage size={14} />,
+};
+
+const kindLabel: Record<NotificationKind, string> = {
+  mention: "Mencion",
+  assigned_chat: "Asignado",
+  reply: "Respuesta",
+};
+
+const kindColor: Record<NotificationKind, string> = {
+  mention: "grape",
+  assigned_chat: "blue",
+  reply: "gray",
+};
+
+export function NotificationsBell({ unreadCount: extCount, notifications: extList, onOpenCard, onChanged }: Props) {
+  const [opened, setOpened] = useState(false);
+  const [items, setItems] = useState<Notification[]>(extList ?? []);
+  const [count, setCount] = useState<number>(extCount ?? 0);
+  const [loading, setLoading] = useState(false);
+
+  // Keep local state in sync with parent-supplied values when present.
+  useEffect(() => {
+    if (extList) setItems(extList);
+  }, [extList]);
+  useEffect(() => {
+    if (extCount !== undefined) setCount(extCount);
+  }, [extCount]);
+
+  const refresh = useCallback(async () => {
+    setLoading(true);
+    try {
+      const [list, c] = await Promise.all([
+        api.listNotifications(false),
+        api.unreadNotificationCount(),
+      ]);
+      setItems(list);
+      setCount(c.count);
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    // Initial fetch only when parent does not provide list/count.
+    if (extList === undefined || extCount === undefined) {
+      refresh();
+    }
+  }, [extList, extCount, refresh]);
+
+  const handleOpen = (isOpen: boolean) => {
+    setOpened(isOpen);
+    if (isOpen) refresh();
+  };
+
+  const handleClick = async (n: Notification) => {
+    if (!n.read_at) {
+      try {
+        await api.markNotificationRead(n.id);
+        setItems((prev) => prev.map((x) => (x.id === n.id ? { ...x, read_at: new Date().toISOString() } : x)));
+        setCount((c) => Math.max(0, c - 1));
+        onChanged?.();
+      } catch {
+        // ignore — UI will recover on next refresh
+      }
+    }
+    setOpened(false);
+    onOpenCard?.(n.card_id, n.message_id);
+  };
+
+  const handleMarkAll = async () => {
+    try {
+      await api.markAllNotificationsRead();
+      setItems((prev) => prev.map((x) => (x.read_at ? x : { ...x, read_at: new Date().toISOString() })));
+      setCount(0);
+      onChanged?.();
+    } catch {
+      // ignore
+    }
+  };
+
+  const badge = (
+    <ActionIcon variant="subtle" aria-label="Notificaciones">
+      <IconBell size={16} />
+    </ActionIcon>
+  );
+
+  return (
+    <Popover opened={opened} onChange={handleOpen} position="bottom-end" width={380} withArrow shadow="md">
+      <Popover.Target>
+        <Box onClick={() => handleOpen(!opened)} style={{ display: "inline-flex" }}>
+          {count > 0 ? (
+            <Indicator color="red" label={count > 99 ? "99+" : count} size={16} offset={4}>
+              {badge}
+            </Indicator>
+          ) : (
+            badge
+          )}
+        </Box>
+      </Popover.Target>
+      <Popover.Dropdown p={0}>
+        <Group justify="space-between" px="sm" py="xs">
+          <Text fw={600} size="sm">Notificaciones</Text>
+          <Tooltip label="Marcar todas como leidas" withArrow>
+            <Button
+              size="compact-xs"
+              variant="subtle"
+              leftSection={<IconCheck size={12} />}
+              onClick={handleMarkAll}
+              disabled={count === 0}
+            >
+              Todas leidas
+            </Button>
+          </Tooltip>
+        </Group>
+        <ScrollArea h={420} type="auto" offsetScrollbars>
+          {loading && items.length === 0 ? (
+            <Group justify="center" p="md"><Loader size="sm" /></Group>
+          ) : items.length === 0 ? (
+            <Text size="sm" c="dimmed" ta="center" p="md">Sin notificaciones</Text>
+          ) : (
+            <Stack gap={0}>
+              {items.map((n) => {
+                const unread = !n.read_at;
+                return (
+                  <UnstyledButton
+                    key={n.id}
+                    onClick={() => handleClick(n)}
+                    p="sm"
+                    style={{
+                      borderTop: "1px solid var(--mantine-color-gray-2)",
+                      background: unread ? "var(--mantine-color-blue-light)" : undefined,
+                      textAlign: "left",
+                    }}
+                  >
+                    <Group gap={6} wrap="nowrap" align="flex-start">
+                      <Badge size="xs" variant="light" color={kindColor[n.kind]} leftSection={kindIcon[n.kind]}>
+                        {kindLabel[n.kind]}
+                      </Badge>
+                      <Box style={{ flex: 1, minWidth: 0 }}>
+                        <Group gap={6} wrap="nowrap" justify="space-between">
+                          <Text size="xs" fw={600} truncate>
+                            {n.actor_name || "Alguien"} · #{n.card_seq_num} {n.card_title}
+                          </Text>
+                          <Text size="xs" c="dimmed">{formatDateTimeShort(n.created_at)}</Text>
+                        </Group>
+                        <Text size="xs" c={unread ? undefined : "dimmed"} lineClamp={2} style={{ whiteSpace: "pre-wrap" }}>
+                          {n.snippet}
+                        </Text>
+                      </Box>
+                    </Group>
+                  </UnstyledButton>
+                );
+              })}
+            </Stack>
+          )}
+        </ScrollArea>
+      </Popover.Dropdown>
+    </Popover>
+  );
+}
@@ -0,0 +1,45 @@
+import { useEffect, useRef } from "react";
+
+export type EventStreamHandlers = Record<string, (payload: unknown) => void>;
+
+// useEventStream connects to /api/events via EventSource and dispatches
+// named events to the matching handler. The handlers object is captured in
+// a ref so callers can supply fresh closures every render without tearing
+// the connection down. Reconnection is handled by the browser's built-in
+// EventSource backoff; the hook only opens one socket per mount.
+export function useEventStream(handlers: EventStreamHandlers, enabled = true) {
+  const ref = useRef(handlers);
+  ref.current = handlers;
+
+  useEffect(() => {
+    if (!enabled) return;
+    const es = new EventSource("/api/events", { withCredentials: true });
+    const listeners: Record<string, (ev: MessageEvent) => void> = {};
+
+    // We attach a listener per event type known when this effect runs.
+    // Types added later via handler ref updates are still handled because
+    // the inner closure always reads ref.current.
+    for (const type of Object.keys(ref.current)) {
+      const fn = (ev: MessageEvent) => {
+        const cb = ref.current[type];
+        if (!cb) return;
+        try {
+          const payload = ev.data ? JSON.parse(ev.data) : null;
+          cb(payload);
+        } catch {
+          // Malformed payload; ignore.
+        }
+      };
+      es.addEventListener(type, fn);
+      listeners[type] = fn;
+    }
+
+    return () => {
+      for (const [type, fn] of Object.entries(listeners)) {
+        es.removeEventListener(type, fn);
+      }
+      es.close();
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [enabled]);
+}
@@ -63,9 +63,41 @@ export interface User {
  username: string;
  display_name: string;
  color: string;
+  is_admin?: boolean;
  created_at: string;
 }

+export type ModuleKind = "jira" | "webhook";
+
+export interface KanbanModule {
+  id: string;
+  name: string;
+  kind: ModuleKind | string;
+  enabled: boolean;
+  event_filter: string[];
+  config: Record<string, unknown>;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface ModuleLog {
+  id: string;
+  module_id: string;
+  event_type: string;
+  card_id: string;
+  status: number;
+  duration_ms: number;
+  error: string;
+  created_at: string;
+}
+
+export interface ModuleTestResult {
+  ok: boolean;
+  status: number;
+  duration_ms: number;
+  error?: string;
+}
+
 export interface MetricsRange {
  from: string;
  to: string;
@@ -210,3 +242,20 @@ export interface CardMessage {
  body: string;
  created_at: string;
 }
+
+export type NotificationKind = "mention" | "assigned_chat" | "reply";
+
+export interface Notification {
+  id: string;
+  user_id: string;
+  card_id: string;
+  message_id: string;
+  kind: NotificationKind;
+  actor_id: string;
+  created_at: string;
+  read_at: string | null;
+  card_title: string;
+  card_seq_num: number;
+  actor_name: string;
+  snippet: string;
+}
@@ -13,10 +13,14 @@ export default defineConfig({
    port: 5180,
    proxy: {
      "/api": {
-        target: "http://localhost:8095",
+        target: process.env.VITE_API_TARGET || "http://127.0.0.1:8095",
        ws: true,
        changeOrigin: true,
      },
+      "/mcp": {
+        target: process.env.VITE_API_TARGET || "http://127.0.0.1:8095",
+        changeOrigin: true,
+      },
    },
  },
  build: {
@@ -9,7 +9,10 @@ FRONT_DIR="$ROOT/frontend"

 PORT_BACK="${PORT_BACK:-8095}"
 PORT_FRONT="${PORT_FRONT:-5180}"
-DB_PATH="${DB_PATH:-./operations.db}"
+# Default DB lives at apps/kanban/operations.db. Force an absolute path so
+# the value survives the `cd $BACK_DIR` below — otherwise a relative
+# ./operations.db would land inside backend/.
+DB_PATH="${DB_PATH:-$ROOT/operations.db}"

 cleanup() {
    echo ""
@@ -22,9 +25,14 @@ cleanup() {
 trap cleanup INT TERM EXIT

 # 1. Build backend si no existe o si los .go/.sql son mas nuevos que el binario
-if [[ ! -x "$BACK_DIR/kanban" ]] || [[ -n "$(find "$BACK_DIR" -maxdepth 3 \( -name '*.go' -o -name '*.sql' \) -newer "$BACK_DIR/kanban" 2>/dev/null)" ]]; then
-    echo ">>> Building backend..."
-    (cd "$BACK_DIR" && CGO_ENABLED=1 go build -tags fts5 -o kanban .)
+VERSION=$(awk -F': ' '/^version:/ {print $2; exit}' "$ROOT/app.md" 2>/dev/null || echo "dev")
+if [[ ! -x "$BACK_DIR/kanban" ]] \
+   || [[ -n "$(find "$BACK_DIR" -maxdepth 3 \( -name '*.go' -o -name '*.sql' \) -newer "$BACK_DIR/kanban" 2>/dev/null)" ]] \
+   || [[ "$ROOT/app.md" -nt "$BACK_DIR/kanban" ]]; then
+    echo ">>> Building backend (version=$VERSION)..."
+    (cd "$BACK_DIR" && CGO_ENABLED=1 go build -tags fts5 \
+        -ldflags="-X main.Version=$VERSION" \
+        -o kanban .)
 fi

 # 2. Asegurar deps frontend
@@ -34,6 +42,10 @@ if [[ ! -d "$FRONT_DIR/node_modules" ]]; then
 fi

 # 3. Lanzar backend
+# KANBAN_MODULE_KEY: passphrase used to AES-GCM encrypt module config_json.
+# A stable default keeps the dev loop ergonomic; in production set this via
+# the host's secret store. Changing it invalidates previously stored modules.
+export KANBAN_MODULE_KEY="${KANBAN_MODULE_KEY:-local-dev-secret-rotate-in-prod}"
 echo ">>> Backend  http://localhost:$PORT_BACK  (db=$DB_PATH)"
 (cd "$BACK_DIR" && ./kanban --port "$PORT_BACK" --db "$DB_PATH") &
 BACK_PID=$!