chore: auto-commit (1 archivos)

- app.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

app.md

@@ -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.2
+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,8 @@ 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.2 (2026-06-01) — patch: el alta a Jira rellena el campo obligatorio "Área Solicitante" (`customfield_10158`) que el issue type Epic (y Mejora) del proyecto DATA exige en la pantalla de creacion. Sin esto, el `card.created` del 0.5.1 daba HTTP 400 "Solicitante is required". Nuevos campos en `jiraConfig`: `requester_field`, `requester_map`, `requester_default`. `create()`/`update()` inyectan el campo como single-select `{value:<opcion>}` resuelto desde el requester de la card (mapa case-insensitive) o el default. Como los requesters del kanban son nombres de persona (no departamentos), las cards caen al default (`Transformación`). `seed-jira-data` gana flags `--requester-field`/`--requester-default` y la rama de update ahora mergea config para no pisar ediciones de UI.
+- v0.5.1 (2026-06-01) — patch: `handleCreateCard` ahora emite el evento `card.created` (antes solo `board.invalidated`, que no estaba en el filtro del modulo). Con esto la creacion de una card dispara `jiraHandler.create` y sincroniza el alta a Jira, igual que ya ocurria con move (`card.moved`) y chat (`message.created`). El evento se emite tras aplicar assignee/tags para que el issue de Jira los lleve.
+- 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.

backend/backfill_jira.go

@@ -0,0 +1,190 @@
+package main
+
+import (
+	"context"
+	"database/sql"
+	"flag"
+	"fmt"
+	"strings"
+	"time"
+)
+
+// backfillCandidate is the minimal projection we read from the cards table
+// for the backfill loop. Avoids loading the full Card row + history we do not
+// need.
+type backfillCandidate struct {
+	ID         string
+	Title      string
+	ColumnID   string
+	ColumnName string
+}
+
+// runBackfillJira walks every active kanban card that is not yet linked to a
+// Jira issue and creates one via the configured jira module's handler. It is
+// the only sanctioned way to backport existing kanban cards into Jira because
+// the event dispatcher only ever fires on NEW kanban mutations.
+//
+// Batching: cards are processed in groups of --batch-size with a
+// --pause-sec sleep between groups so we stay well below Jira's REST quota.
+// --limit caps the total number of cards processed (0 = no cap).
+// --column restricts to a single kanban column by name (case-insensitive).
+// --dry-run lists the candidates without calling Jira.
+func runBackfillJira(args []string) error {
+	fs := flag.NewFlagSet("kanban backfill-jira", flag.ContinueOnError)
+	dbPath := fs.String("db", "operations.db", "SQLite database path")
+	batchSize := fs.Int("batch-size", 10, "Cards processed per batch before pausing")
+	pauseSec := fs.Int("pause-sec", 5, "Seconds to sleep between batches")
+	limit := fs.Int("limit", 0, "Maximum cards to process total (0 = no limit)")
+	columnFilter := fs.String("column", "", "Only backfill cards whose column name matches (case-insensitive)")
+	dryRun := fs.Bool("dry-run", false, "List candidates and exit without calling Jira")
+	if err := fs.Parse(args); err != nil {
+		return err
+	}
+	if *batchSize <= 0 {
+		return fmt.Errorf("--batch-size must be > 0")
+	}
+
+	db, err := openDB(*dbPath)
+	if err != nil {
+		return fmt.Errorf("open db: %w", err)
+	}
+	defer db.Close()
+
+	mod, cfg, err := activeJiraModule(db)
+	if err != nil {
+		return fmt.Errorf("module config: %w", err)
+	}
+
+	candidates, err := listBackfillCandidates(db, *columnFilter, *limit)
+	if err != nil {
+		return err
+	}
+	if len(candidates) == 0 {
+		fmt.Println("no cards to backfill (all active cards have jira_key set or filter is empty)")
+		return nil
+	}
+
+	fmt.Printf("backfill plan: %d cards across columns; batch=%d pause=%ds dry_run=%v\n",
+		len(candidates), *batchSize, *pauseSec, *dryRun)
+	fmt.Printf("module: %q (project=%s, board=%d, issue_type=%q)\n",
+		mod.Name, cfg.ProjectKey, cfg.BoardID, cfg.IssueType)
+	fmt.Println()
+
+	if *dryRun {
+		printCandidates(candidates)
+		return nil
+	}
+
+	h := &jiraHandler{}
+	var ok, failed int
+	for i := 0; i < len(candidates); i++ {
+		c := candidates[i]
+		if i > 0 && i%*batchSize == 0 {
+			fmt.Printf("--- batch boundary (%d/%d) — sleeping %ds ---\n", i, len(candidates), *pauseSec)
+			time.Sleep(time.Duration(*pauseSec) * time.Second)
+		}
+		status, err := h.Handle(context.Background(), db, mod, Event{
+			Type:   "card.created",
+			CardID: c.ID,
+		})
+		now := time.Now().UTC().Format(time.RFC3339)
+		if err != nil {
+			failed++
+			_ = db.updateCardJiraSync(c.ID, "", now, err.Error())
+			fmt.Printf("[%4d/%4d] FAIL  %-40s  http=%d  err=%s\n",
+				i+1, len(candidates), truncateInline(c.Title, 40), status, truncateInline(err.Error(), 80))
+			continue
+		}
+		ok++
+		statusName := cfg.StatusMap[c.ColumnName]
+		_ = db.updateCardJiraSync(c.ID, statusName, now, "")
+		// After Handle() the card row now carries the assigned jira_key.
+		linked, _ := db.lookupCardJiraKey(c.ID)
+		fmt.Printf("[%4d/%4d] OK    %-40s  -> %-12s  status=%s\n",
+			i+1, len(candidates), truncateInline(c.Title, 40), linked, statusName)
+	}
+	fmt.Println()
+	fmt.Printf("done: %d ok · %d failed · %d total\n", ok, failed, len(candidates))
+	if failed > 0 {
+		return fmt.Errorf("%d cards failed to backfill", failed)
+	}
+	return nil
+}
+
+// listBackfillCandidates returns active (not deleted, not archived) cards
+// without a Jira link, optionally filtered by column name. Newest-first so
+// recent cards are mirrored first.
+func listBackfillCandidates(db *DB, columnFilter string, limit int) ([]backfillCandidate, error) {
+	q := `
+SELECT c.id, c.title, c.column_id, col.name
+FROM cards c
+JOIN columns col ON col.id = c.column_id
+WHERE (c.jira_key IS NULL OR c.jira_key = '')
+  AND c.deleted_at IS NULL
+  AND c.archived_at IS NULL
+`
+	args := []interface{}{}
+	if strings.TrimSpace(columnFilter) != "" {
+		q += " AND LOWER(col.name) = LOWER(?) "
+		args = append(args, columnFilter)
+	}
+	q += " ORDER BY c.created_at ASC "
+	if limit > 0 {
+		q += " LIMIT ? "
+		args = append(args, limit)
+	}
+	rows, err := db.conn.Query(q, args...)
+	if err != nil {
+		return nil, fmt.Errorf("list candidates: %w", err)
+	}
+	defer rows.Close()
+	out := []backfillCandidate{}
+	for rows.Next() {
+		var c backfillCandidate
+		if err := rows.Scan(&c.ID, &c.Title, &c.ColumnID, &c.ColumnName); err != nil {
+			return nil, err
+		}
+		out = append(out, c)
+	}
+	return out, rows.Err()
+}
+
+// lookupCardJiraKey returns the jira_key column for a card, or empty string.
+// Used to print the freshly-assigned key in the progress log.
+func (db *DB) lookupCardJiraKey(cardID string) (string, error) {
+	var k sql.NullString
+	err := db.conn.QueryRow(`SELECT jira_key FROM cards WHERE id = ?`, cardID).Scan(&k)
+	if err != nil {
+		return "", err
+	}
+	if !k.Valid {
+		return "", nil
+	}
+	return k.String, nil
+}
+
+func printCandidates(cs []backfillCandidate) {
+	byCol := map[string]int{}
+	for _, c := range cs {
+		byCol[c.ColumnName]++
+	}
+	fmt.Println("candidates by column:")
+	for col, n := range byCol {
+		fmt.Printf("  %-25s  %d\n", col, n)
+	}
+	fmt.Println()
+	fmt.Printf("first 20 of %d:\n", len(cs))
+	for i, c := range cs {
+		if i >= 20 {
+			break
+		}
+		fmt.Printf("  %-12s  [%s]  %s\n", c.ID, c.ColumnName, truncateInline(c.Title, 60))
+	}
+}
+
+func truncateInline(s string, n int) string {
+	if len(s) <= n {
+		return s
+	}
+	return s[:n-1] + "…"
+}

backend/dist/index.html

@@ -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-Be_Ib5cu.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-b0xjFtx2.css">
   </head>
   <body>

backend/events.go

@@ -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})
+}

backend/events_test.go

@@ -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)
+	}
+}

backend/go.mod

@@ -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 => ../../..

backend/go.sum

@@ -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=

backend/handlers.go

@@ -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,20 @@ func handleCreateCard(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		// card.created drives outbound modules (Jira) to create the issue.
+		// Emitted after assignee/tags are applied so the synced issue carries
+		// them. board.invalidated stays for the SPA's refetch path.
+		hub.PublishJSON("card.created", c.ID, "", map[string]string{
+			"card_id":   c.ID,
+			"column_id": body.ColumnID,
+		})
+		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 +274,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 +294,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 +308,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 {
@@ -301,6 +329,10 @@ func handleMoveCard(db *DB) http.HandlerFunc {
 			badRequest(w, "column_id required")
 			return
 		}
+		// Read the previous column BEFORE mutating so we can decide whether
+		// this is an actual column move (vs a same-column reorder). Outbound
+		// modules (Jira) only care about the former.
+		prevColumnID, _ := db.lookupCardColumnID(id)
 		actor, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
 		if err := db.MoveCard(id, body.ColumnID, body.OrderedIDs, actor); err != nil {
 			if strings.Contains(err.Error(), "not found") {
@@ -310,6 +342,18 @@ func handleMoveCard(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		// Distinct event when the card crossed columns so the Jira module
+		// runs transition() instead of plain update(). Reorder-only goes
+		// straight to board.invalidated (frontend refetch) without a Jira
+		// roundtrip.
+		if prevColumnID != "" && prevColumnID != body.ColumnID {
+			hub.PublishJSON("card.moved", id, "", map[string]string{
+				"card_id":            id,
+				"from_column_id":     prevColumnID,
+				"to_column_id":       body.ColumnID,
+			})
+		}
+		publishInvalidated(hub, id, body.ColumnID)
 		w.WriteHeader(http.StatusNoContent)
 	}
 }
@@ -328,7 +372,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 +394,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 +408,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 +425,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 +446,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 +477,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 +485,7 @@ func handleRestoreCard(db *DB) http.HandlerFunc {
 			serverError(w, err)
 			return
 		}
+		publishInvalidated(hub, id, "")
 		w.WriteHeader(http.StatusNoContent)
 	}
 }
@@ -553,44 +606,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 +655,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 +691,42 @@ 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)},
+		// Per-card Jira sync state (indicator + tooltip).
+		{Method: "GET", Path: "/api/cards/{id}/jira-sync", Handler: handleCardJiraSync(db, dispatcher)},
+		// Jira import: list issues not yet in kanban + bulk import.
+		{Method: "GET", Path: "/api/jira/issues", Handler: handleListJiraIssues(db)},
+		{Method: "POST", Path: "/api/jira/import", Handler: handleImportJiraIssues(db)},
+		// Jira column-sync check: detect drift between kanban col ↔ Jira status.
+		{Method: "GET", Path: "/api/jira/check-columns", Handler: handleCheckJiraColumns(db)},
+		{Method: "POST", Path: "/api/jira/reconcile-columns", Handler: handleReconcileJiraColumns(db)},
+	}
+}
+
+// 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})
 	}
 }
 

backend/jira_import.go

@@ -0,0 +1,569 @@
+package main
+
+import (
+	"bytes"
+	"context"
+	"encoding/base64"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"net/url"
+	"strconv"
+	"strings"
+	"time"
+
+	"fn-registry/functions/infra"
+)
+
+// jiraImportRequest is the body shape for POST /api/jira/import.
+type jiraImportRequest struct {
+	IssueKeys        []string `json:"issue_keys"`
+	FallbackColumnID string   `json:"fallback_column_id"` // optional: where to land issues whose status has no kanban mapping
+}
+
+// jiraIssueOut is what we return in GET /api/jira/issues for the frontend
+// import picker. We deliberately keep this small — clicking a row redirects
+// to Jira for full detail.
+type jiraIssueOut struct {
+	Key             string `json:"key"`
+	Summary         string `json:"summary"`
+	StatusName      string `json:"status_name"`
+	IssueType       string `json:"issue_type"`
+	Assignee        string `json:"assignee"`
+	Updated         string `json:"updated"`
+	URL             string `json:"url"`
+	AlreadyImported bool   `json:"already_imported"`
+	MappedColumnID  string `json:"mapped_column_id,omitempty"`
+	IssueTypeIcon   string `json:"issue_type_icon,omitempty"`
+}
+
+// linkedCardForCheck is the projection used by the check-columns endpoint.
+// We only need fields visible in the report table.
+type linkedCardForCheck struct {
+	ID         string
+	Title      string
+	JiraKey    string
+	ColumnID   string
+	ColumnName string
+}
+
+func listLinkedCardsForCheck(db *DB) ([]linkedCardForCheck, error) {
+	rows, err := db.conn.Query(`
+SELECT c.id, c.title, c.jira_key, c.column_id, col.name
+FROM cards c
+JOIN columns col ON col.id = c.column_id
+WHERE c.jira_key != ''
+  AND c.deleted_at IS NULL
+ORDER BY c.jira_key ASC
+`)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	out := []linkedCardForCheck{}
+	for rows.Next() {
+		var c linkedCardForCheck
+		if err := rows.Scan(&c.ID, &c.Title, &c.JiraKey, &c.ColumnID, &c.ColumnName); err != nil {
+			return nil, err
+		}
+		out = append(out, c)
+	}
+	return out, rows.Err()
+}
+
+// activeJiraModule returns the first enabled Jira module + its decoded config,
+// or an error if no module is configured. The handlers below need both the
+// credentials and the status_map to operate.
+func activeJiraModule(db *DB) (Module, jiraConfig, error) {
+	mods, err := db.listModulesEnabled()
+	if err != nil {
+		return Module{}, jiraConfig{}, err
+	}
+	for _, m := range mods {
+		if m.Kind != "jira" {
+			continue
+		}
+		cfg, perr := parseJiraConfig(m)
+		if perr != nil {
+			return Module{}, jiraConfig{}, perr
+		}
+		return m, cfg, nil
+	}
+	return Module{}, jiraConfig{}, fmt.Errorf("no enabled jira module configured")
+}
+
+// jiraGET performs an authenticated GET against the configured Jira API and
+// decodes the JSON response into out.
+func jiraGET(ctx context.Context, cfg jiraConfig, path string, out interface{}) (int, error) {
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, cfg.BaseURL+path, nil)
+	if err != nil {
+		return 0, err
+	}
+	req.Header.Set("Accept", "application/json")
+	if cfg.Email != "" && cfg.APIToken != "" {
+		basic := base64.StdEncoding.EncodeToString([]byte(cfg.Email + ":" + cfg.APIToken))
+		req.Header.Set("Authorization", "Basic "+basic)
+	}
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		return 0, err
+	}
+	defer resp.Body.Close()
+	body, _ := io.ReadAll(io.LimitReader(resp.Body, 4<<20))
+	if resp.StatusCode >= 400 {
+		return resp.StatusCode, fmt.Errorf("jira GET %s: %d %s", path, resp.StatusCode, truncate(body, 240))
+	}
+	if out != nil {
+		if err := json.Unmarshal(body, out); err != nil {
+			return resp.StatusCode, fmt.Errorf("decode %s: %w", path, err)
+		}
+	}
+	return resp.StatusCode, nil
+}
+
+// extractADFText walks an Atlassian Document Format JSON node and collects the
+// text content. Returns "" when the input is not a valid ADF doc. Used to
+// pre-populate the kanban card description on import — operators can edit it
+// later, the Jira link is the source of truth for rich content.
+func extractADFText(raw json.RawMessage) string {
+	if len(raw) == 0 || string(raw) == "null" {
+		return ""
+	}
+	var node struct {
+		Type    string            `json:"type"`
+		Text    string            `json:"text"`
+		Content []json.RawMessage `json:"content"`
+	}
+	if err := json.Unmarshal(raw, &node); err != nil {
+		return ""
+	}
+	var buf bytes.Buffer
+	collectADFText(&buf, node.Type, node.Text, node.Content)
+	return strings.TrimSpace(buf.String())
+}
+
+func collectADFText(buf *bytes.Buffer, nodeType, text string, content []json.RawMessage) {
+	if text != "" {
+		buf.WriteString(text)
+	}
+	for _, c := range content {
+		var inner struct {
+			Type    string            `json:"type"`
+			Text    string            `json:"text"`
+			Content []json.RawMessage `json:"content"`
+		}
+		if err := json.Unmarshal(c, &inner); err != nil {
+			continue
+		}
+		collectADFText(buf, inner.Type, inner.Text, inner.Content)
+	}
+	// Paragraph / list-item / heading boundaries get a newline so the result
+	// is roughly readable in the kanban card body.
+	switch nodeType {
+	case "paragraph", "heading", "listItem", "bulletList", "orderedList":
+		buf.WriteString("\n")
+	}
+}
+
+// reverseStatusMap inverts the kanban-col-name -> jira-status-name mapping so
+// importers can land an issue in the column whose status matches. Lower-cased
+// keys for case-insensitive lookup.
+func reverseStatusMap(cfg jiraConfig) map[string]string {
+	out := make(map[string]string, len(cfg.StatusMap))
+	for col, status := range cfg.StatusMap {
+		out[strings.ToLower(status)] = col
+	}
+	return out
+}
+
+// handleListJiraIssues fetches up to `limit` issues from the configured Jira
+// board and annotates each with whether it is already imported into kanban
+// and (if mappable) the kanban column it would land in.
+func handleListJiraIssues(db *DB) http.HandlerFunc {
+	return requireAdmin(db, func(w http.ResponseWriter, r *http.Request) {
+		_, cfg, err := activeJiraModule(db)
+		if err != nil {
+			badRequest(w, err.Error())
+			return
+		}
+		if cfg.BoardID <= 0 {
+			badRequest(w, "module is missing board_id")
+			return
+		}
+		limit := 100
+		if v := r.URL.Query().Get("limit"); v != "" {
+			if n, perr := strconv.Atoi(v); perr == nil && n > 0 && n <= 200 {
+				limit = n
+			}
+		}
+		showImported := r.URL.Query().Get("include_imported") == "true"
+
+		q := url.Values{}
+		q.Set("maxResults", strconv.Itoa(limit))
+		q.Set("fields", "summary,status,assignee,updated,issuetype,description")
+		path := fmt.Sprintf("/rest/agile/1.0/board/%d/issue?%s", cfg.BoardID, q.Encode())
+
+		var page struct {
+			Issues []struct {
+				Key    string `json:"key"`
+				Fields struct {
+					Summary string `json:"summary"`
+					Status  struct {
+						Name string `json:"name"`
+					} `json:"status"`
+					Assignee *struct {
+						DisplayName string `json:"displayName"`
+					} `json:"assignee"`
+					Updated   string `json:"updated"`
+					IssueType struct {
+						Name    string `json:"name"`
+						IconURL string `json:"iconUrl"`
+					} `json:"issuetype"`
+				} `json:"fields"`
+			} `json:"issues"`
+		}
+		ctx, cancel := context.WithTimeout(r.Context(), moduleHTTPTimeout)
+		defer cancel()
+		if _, err := jiraGET(ctx, cfg, path, &page); err != nil {
+			serverError(w, err)
+			return
+		}
+
+		// Build lookup: jira_key -> bool (already imported)
+		importedKeys, err := db.listImportedJiraKeys()
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		colByName, err := db.listColumnsByName()
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		statusToCol := reverseStatusMap(cfg)
+
+		out := make([]jiraIssueOut, 0, len(page.Issues))
+		for _, iss := range page.Issues {
+			already := importedKeys[iss.Key]
+			if already && !showImported {
+				continue
+			}
+			row := jiraIssueOut{
+				Key:             iss.Key,
+				Summary:         iss.Fields.Summary,
+				StatusName:      iss.Fields.Status.Name,
+				IssueType:       iss.Fields.IssueType.Name,
+				Updated:         iss.Fields.Updated,
+				URL:             cfg.BaseURL + "/browse/" + iss.Key,
+				AlreadyImported: already,
+				IssueTypeIcon:   iss.Fields.IssueType.IconURL,
+			}
+			if iss.Fields.Assignee != nil {
+				row.Assignee = iss.Fields.Assignee.DisplayName
+			}
+			if colName, ok := statusToCol[strings.ToLower(iss.Fields.Status.Name)]; ok {
+				if col, ok := colByName[colName]; ok {
+					row.MappedColumnID = col.ID
+				}
+			}
+			out = append(out, row)
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, map[string]interface{}{
+			"issues":            out,
+			"board_id":          cfg.BoardID,
+			"project_key":       cfg.ProjectKey,
+			"status_to_column":  statusToCol,
+			"include_imported":  showImported,
+		})
+	})
+}
+
+// jiraCheckRow is one row of the check-columns report.
+type jiraCheckRow struct {
+	CardID            string `json:"card_id"`
+	JiraKey           string `json:"jira_key"`
+	Title             string `json:"title"`
+	KanbanColumnID    string `json:"kanban_column_id"`
+	KanbanColumnName  string `json:"kanban_column_name"`
+	JiraStatusName    string `json:"jira_status_name"`
+	ExpectedKanbanCol string `json:"expected_kanban_col"` // kanban col that matches the current Jira status (reverse status_map)
+	ExpectedJiraStat  string `json:"expected_jira_status"` // jira status that matches the current kanban col (status_map)
+	Mismatch          bool   `json:"mismatch"`
+	IssueURL          string `json:"issue_url"`
+}
+
+// handleCheckJiraColumns walks every linked card, fetches its current Jira
+// status, and reports whether the kanban column ↔ Jira status mapping is in
+// sync. Used by the "Comprobar columnas" tab in the Jira modal.
+//
+// Performance note: one Jira REST call per linked card. With 127 cards that
+// is ~127 round-trips — slow (≈30s end-to-end) but tolerable as an admin op.
+// A future optimisation could batch via /search/jql with key IN (...) and a
+// fields=status projection.
+func handleCheckJiraColumns(db *DB) http.HandlerFunc {
+	return requireAdmin(db, func(w http.ResponseWriter, r *http.Request) {
+		_, cfg, err := activeJiraModule(db)
+		if err != nil {
+			badRequest(w, err.Error())
+			return
+		}
+		cards, err := listLinkedCardsForCheck(db)
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		statusToCol := reverseStatusMap(cfg)
+
+		ctx, cancel := context.WithTimeout(r.Context(), moduleHTTPTimeout*5)
+		defer cancel()
+
+		rows := make([]jiraCheckRow, 0, len(cards))
+		var mismatches int
+		for _, c := range cards {
+			var iss struct {
+				Fields struct {
+					Status struct {
+						Name string `json:"name"`
+					} `json:"status"`
+				} `json:"fields"`
+			}
+			if _, err := jiraGET(ctx, cfg, "/rest/api/3/issue/"+url.PathEscape(c.JiraKey)+"?fields=status", &iss); err != nil {
+				rows = append(rows, jiraCheckRow{
+					CardID:           c.ID,
+					JiraKey:          c.JiraKey,
+					Title:            c.Title,
+					KanbanColumnID:   c.ColumnID,
+					KanbanColumnName: c.ColumnName,
+					JiraStatusName:   "(fetch failed: " + err.Error() + ")",
+					Mismatch:         true,
+					IssueURL:         cfg.BaseURL + "/browse/" + c.JiraKey,
+				})
+				mismatches++
+				continue
+			}
+			expectedCol := statusToCol[strings.ToLower(iss.Fields.Status.Name)]
+			expectedStat := cfg.StatusMap[c.ColumnName]
+			mm := !strings.EqualFold(iss.Fields.Status.Name, expectedStat)
+			if mm {
+				mismatches++
+			}
+			rows = append(rows, jiraCheckRow{
+				CardID:            c.ID,
+				JiraKey:           c.JiraKey,
+				Title:             c.Title,
+				KanbanColumnID:    c.ColumnID,
+				KanbanColumnName:  c.ColumnName,
+				JiraStatusName:    iss.Fields.Status.Name,
+				ExpectedKanbanCol: expectedCol,
+				ExpectedJiraStat:  expectedStat,
+				Mismatch:          mm,
+				IssueURL:          cfg.BaseURL + "/browse/" + c.JiraKey,
+			})
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, map[string]interface{}{
+			"rows":        rows,
+			"total":       len(rows),
+			"mismatches":  mismatches,
+			"in_sync":     len(rows) - mismatches,
+			"status_map":  cfg.StatusMap,
+			"reverse_map": statusToCol,
+		})
+	})
+}
+
+// reconcileRequest is the body shape for POST /api/jira/reconcile-columns.
+// direction=kanban-wins → push Jira to match kanban (the only mode for now;
+// reverse is risky because moving cards in kanban can trigger downstream
+// notifications/timers).
+type reconcileRequest struct {
+	CardIDs   []string `json:"card_ids"`
+	Direction string   `json:"direction"` // currently only "kanban-wins"
+}
+
+// handleReconcileJiraColumns transitions each requested issue so its status
+// matches the current kanban column (kanban as source of truth). Reuses
+// the dispatcher's transitionToStatus helper for consistency with the
+// regular card.moved path. Per-card result.
+func handleReconcileJiraColumns(db *DB) http.HandlerFunc {
+	return requireAdmin(db, func(w http.ResponseWriter, r *http.Request) {
+		var body reconcileRequest
+		if err := infra.HTTPParseBody(r, &body, maxBodyBytes); err != nil {
+			badRequest(w, err.Error())
+			return
+		}
+		if len(body.CardIDs) == 0 {
+			badRequest(w, "card_ids required")
+			return
+		}
+		if body.Direction == "" {
+			body.Direction = "kanban-wins"
+		}
+		if body.Direction != "kanban-wins" {
+			badRequest(w, "only direction=kanban-wins is supported")
+			return
+		}
+		_, cfg, err := activeJiraModule(db)
+		if err != nil {
+			badRequest(w, err.Error())
+			return
+		}
+
+		h := &jiraHandler{}
+		ctx, cancel := context.WithTimeout(r.Context(), moduleHTTPTimeout*time.Duration(len(body.CardIDs)+1))
+		defer cancel()
+
+		results := make([]map[string]interface{}, 0, len(body.CardIDs))
+		for _, cid := range body.CardIDs {
+			res := map[string]interface{}{"card_id": cid}
+			card, cerr := db.getCardForJira(cid)
+			if cerr != nil {
+				res["status"] = "error"
+				res["error"] = cerr.Error()
+				results = append(results, res)
+				continue
+			}
+			if card.JiraKey == "" {
+				res["status"] = "skipped"
+				res["error"] = "card has no jira_key"
+				results = append(results, res)
+				continue
+			}
+			if _, ok := cfg.StatusMap[card.ColumnName]; !ok {
+				res["status"] = "skipped"
+				res["error"] = "no status_map entry for column " + card.ColumnName
+				results = append(results, res)
+				continue
+			}
+			status, terr := h.transitionToStatus(ctx, cfg, card.JiraKey, card.ColumnName)
+			if terr != nil {
+				res["status"] = "error"
+				res["error"] = terr.Error()
+				res["http"] = status
+				results = append(results, res)
+				continue
+			}
+			now := time.Now().UTC().Format(time.RFC3339)
+			_ = db.updateCardJiraSync(cid, cfg.StatusMap[card.ColumnName], now, "")
+			res["status"] = "fixed"
+			res["jira_key"] = card.JiraKey
+			res["jira_status"] = cfg.StatusMap[card.ColumnName]
+			results = append(results, res)
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, map[string]interface{}{"results": results})
+	})
+}
+
+// handleImportJiraIssues creates a kanban card for each requested issue_key
+// and links it to the existing Jira issue (sets jira_key directly, so the
+// dispatcher will treat any future kanban edits as updates instead of trying
+// to create a duplicate). The card lands in the column whose status_map entry
+// matches the issue's current status; falls back to FallbackColumnID when
+// unmappable.
+func handleImportJiraIssues(db *DB) http.HandlerFunc {
+	return requireAdmin(db, func(w http.ResponseWriter, r *http.Request) {
+		uid, _ := infra.UserIDFromContext(r.Context(), userCtxKey)
+		var body jiraImportRequest
+		if err := infra.HTTPParseBody(r, &body, maxBodyBytes); err != nil {
+			badRequest(w, err.Error())
+			return
+		}
+		if len(body.IssueKeys) == 0 {
+			badRequest(w, "issue_keys required")
+			return
+		}
+		_, cfg, err := activeJiraModule(db)
+		if err != nil {
+			badRequest(w, err.Error())
+			return
+		}
+		colByName, err := db.listColumnsByName()
+		if err != nil {
+			serverError(w, err)
+			return
+		}
+		statusToCol := reverseStatusMap(cfg)
+
+		results := make([]map[string]interface{}, 0, len(body.IssueKeys))
+		ctx, cancel := context.WithTimeout(r.Context(), moduleHTTPTimeout*time.Duration(len(body.IssueKeys)+1))
+		defer cancel()
+
+		for _, key := range body.IssueKeys {
+			res := map[string]interface{}{"key": key}
+			// Skip if already imported.
+			if existing, _ := db.findCardByJiraKey(key); existing != "" {
+				res["status"] = "skipped"
+				res["error"] = "already imported (card " + existing + ")"
+				results = append(results, res)
+				continue
+			}
+			// Fetch issue detail to get summary + description + status.
+			var iss struct {
+				Fields struct {
+					Summary string `json:"summary"`
+					Status  struct {
+						Name string `json:"name"`
+					} `json:"status"`
+					Description json.RawMessage `json:"description"`
+					Assignee    *struct {
+						DisplayName string `json:"displayName"`
+					} `json:"assignee"`
+				} `json:"fields"`
+			}
+			if _, err := jiraGET(ctx, cfg, "/rest/api/3/issue/"+url.PathEscape(key), &iss); err != nil {
+				res["status"] = "error"
+				res["error"] = err.Error()
+				results = append(results, res)
+				continue
+			}
+			// Determine target column.
+			columnID := body.FallbackColumnID
+			if colName, ok := statusToCol[strings.ToLower(iss.Fields.Status.Name)]; ok {
+				if col, ok := colByName[colName]; ok {
+					columnID = col.ID
+				}
+			}
+			if columnID == "" {
+				res["status"] = "error"
+				res["error"] = fmt.Sprintf("no column mapping for status %q and no fallback_column_id", iss.Fields.Status.Name)
+				results = append(results, res)
+				continue
+			}
+			requester := ""
+			if iss.Fields.Assignee != nil {
+				requester = iss.Fields.Assignee.DisplayName
+			}
+			description := extractADFText(iss.Fields.Description)
+			if description == "" {
+				description = "Imported from Jira " + key
+			} else {
+				description = description + "\n\n— Imported from Jira " + key
+			}
+			card, cerr := db.CreateCard(columnID, requester, iss.Fields.Summary, description, uid)
+			if cerr != nil {
+				res["status"] = "error"
+				res["error"] = cerr.Error()
+				results = append(results, res)
+				continue
+			}
+			// Link to existing Jira issue + seed sync state so the indicator
+			// renders green immediately.
+			if err := db.setCardJiraKey(card.ID, key); err != nil {
+				res["status"] = "error"
+				res["error"] = "card created but link failed: " + err.Error()
+				results = append(results, res)
+				continue
+			}
+			now := time.Now().UTC().Format(time.RFC3339)
+			_ = db.updateCardJiraSync(card.ID, iss.Fields.Status.Name, now, "")
+			res["status"] = "imported"
+			res["card_id"] = card.ID
+			res["column_id"] = columnID
+			results = append(results, res)
+		}
+
+		infra.HTTPJSONResponse(w, http.StatusOK, map[string]interface{}{
+			"results": results,
+		})
+	})
+}

backend/main.go

@@ -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" {
@@ -31,6 +36,45 @@ func main() {
 		return
 	}
 
+	// Subcommand `kanban mint-token` issues an HTTP MCP bearer token for a user.
+	if len(os.Args) > 1 && os.Args[1] == "mint-token" {
+		if err := runMintToken(os.Args[2:]); err != nil {
+			fmt.Fprintf(os.Stderr, "kanban mint-token: %v\n", err)
+			os.Exit(1)
+		}
+		return
+	}
+
+	// Subcommand `kanban seed-jira-data` provisions the Jira push module
+	// scoped to project DATA + board 33 using pass-stored credentials.
+	if len(os.Args) > 1 && os.Args[1] == "seed-jira-data" {
+		if err := runSeedJiraData(os.Args[2:]); err != nil {
+			fmt.Fprintf(os.Stderr, "kanban seed-jira-data: %v\n", err)
+			os.Exit(1)
+		}
+		return
+	}
+
+	// Subcommand `kanban backfill-jira` mirrors every active kanban card that
+	// is not yet linked to a Jira issue into Jira, in batches.
+	if len(os.Args) > 1 && os.Args[1] == "backfill-jira" {
+		if err := runBackfillJira(os.Args[2:]); err != nil {
+			fmt.Fprintf(os.Stderr, "kanban backfill-jira: %v\n", err)
+			os.Exit(1)
+		}
+		return
+	}
+
+	// Subcommand `kanban resync-jira-fields` patches existing linked issues
+	// so their issuetype/assignee/labels reflect the current module config.
+	if len(os.Args) > 1 && os.Args[1] == "resync-jira-fields" {
+		if err := runResyncJiraFields(os.Args[2:]); err != nil {
+			fmt.Fprintf(os.Stderr, "kanban resync-jira-fields: %v\n", err)
+			os.Exit(1)
+		}
+		return
+	}
+
 	flags := flag.NewFlagSet("kanban", flag.ExitOnError)
 	port := flags.Int("port", 8095, "HTTP port")
 	dbPath := flags.String("db", "operations.db", "SQLite database path")
@@ -63,7 +107,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 +126,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 +213,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)
+	})
 }

backend/mcp.go

@@ -254,6 +254,57 @@ 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"},
+			}),
+		},
+		{
+			Name: "delete_comment",
+			Description: "Borra un comentario propio. Solo el autor original puede borrar (validado en server). " +
+				"Requiere autenticacion via MCP HTTP — el actor se infiere del bearer token. " +
+				"Output: {ok:true}.",
+			InputSchema: rawSchema(map[string]any{
+				"type": "object",
+				"properties": map[string]any{
+					"id": map[string]any{"type": "string", "description": "ID del card_message a borrar (no de la card)."},
+				},
+				"required": []string{"id"},
+			}),
+		},
+		{
+			Name: "get_card",
+			Description: "Devuelve una tarjeta activa (no archivada) por id o por seq_num. Read-only. " +
+				"Pasa exactamente UNO de los dos: id (hash interno) o seq_num (entero visible, ej. la '115' de 'card 00115'). " +
+				"Output: Card completa con time_in_column_ms, total_locked_ms, tags, stickers, deadline.",
+			InputSchema: rawSchema(map[string]any{
+				"type": "object",
+				"properties": map[string]any{
+					"id":      map[string]any{"type": "string", "description": "ID hash de la tarjeta (16 hex)."},
+					"seq_num": map[string]any{"type": "integer", "description": "Numero secuencial visible al usuario."},
+				},
+			}),
+		},
 	}
 }
 

backend/mcp_http.go

@@ -0,0 +1,56 @@
+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 executeToolAs() so per-user tools (add_comment,
+// delete_comment) can infer the actor from the authenticated token.
+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(`{}`)
+		}
+		actor, _ := infra.UserIDFromContext(ctx, userCtxKey)
+		res := executeToolAs(db, name, body, actor)
+		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,
+	})
+}

backend/mcp_tokens.go

@@ -0,0 +1,174 @@
+package main
+
+import (
+	"crypto/rand"
+	"crypto/sha256"
+	"database/sql"
+	"encoding/hex"
+	"errors"
+	"flag"
+	"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
+}
+
+// runMintToken implements `kanban mint-token --user <id> --name <pc>`.
+// Generates a fresh token, persists its sha256 in mcp_tokens, and prints the
+// plaintext ONCE to stdout. The caller must save it — the server keeps only
+// the hash.
+func runMintToken(args []string) error {
+	fs := flag.NewFlagSet("kanban mint-token", flag.ContinueOnError)
+	dbPath := fs.String("db", "operations.db", "SQLite database path")
+	userID := fs.String("user", "", "owner user_id (must exist in users table)")
+	name := fs.String("name", "", "label for this token (e.g. PC name)")
+	if err := fs.Parse(args); err != nil {
+		return err
+	}
+	if *userID == "" || *name == "" {
+		return fmt.Errorf("--user and --name required")
+	}
+
+	db, err := openDB(*dbPath)
+	if err != nil {
+		return fmt.Errorf("open db: %w", err)
+	}
+	defer db.Close()
+
+	var exists int
+	if err := db.conn.QueryRow(`SELECT COUNT(*) FROM users WHERE id=?`, *userID).Scan(&exists); err != nil {
+		return fmt.Errorf("user lookup: %w", err)
+	}
+	if exists == 0 {
+		return fmt.Errorf("user %q not found", *userID)
+	}
+
+	plaintext, tok, err := db.MintMCPToken(*userID, *name)
+	if err != nil {
+		return fmt.Errorf("mint: %w", err)
+	}
+	fmt.Printf("token id:   %s\n", tok.ID)
+	fmt.Printf("name:       %s\n", tok.Name)
+	fmt.Printf("created_at: %s\n", tok.CreatedAt)
+	fmt.Printf("\ntoken (save now, will not be shown again):\n%s\n", plaintext)
+	return nil
+}

backend/mcp_tokens_handlers.go

@@ -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)
+	}
+}

backend/migrations/015_notifications.sql

@@ -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);

backend/migrations/016_modules.sql

@@ -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';

backend/migrations/017_mcp_tokens.sql

@@ -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;

backend/migrations/018_card_jira_sync_state.sql

@@ -0,0 +1,13 @@
+-- Per-card Jira sync state. Populated by the dispatcher after every push to
+-- Jira so the frontend can render an indicator (gray/yellow/green) and a
+-- tooltip with the last known status without polling Jira itself.
+--
+-- jira_last_status: the Jira status name the card was transitioned to in the
+--                   most recent successful sync (e.g. "In Progress", "Done").
+-- jira_last_sync_at: RFC3339 timestamp of the last sync attempt (success or
+--                    failure).
+-- jira_last_error: the error message from the last failed sync, or empty when
+--                  the last sync succeeded.
+ALTER TABLE cards ADD COLUMN jira_last_status   TEXT NOT NULL DEFAULT '';
+ALTER TABLE cards ADD COLUMN jira_last_sync_at  TEXT NOT NULL DEFAULT '';
+ALTER TABLE cards ADD COLUMN jira_last_error    TEXT NOT NULL DEFAULT '';

backend/modules_crypto.go

@@ -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)
+}

backend/modules_handlers.go

@@ -0,0 +1,267 @@
+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)
+	})
+}
+
+// handleCardJiraSync returns the per-card Jira sync state for the indicator
+// tooltip. Reads cards.jira_last_* columns + dispatcher inflight map. The
+// caller does not need admin: any authenticated user can see the state of
+// their cards. Returns 200 + zero-valued state when the card has no link
+// yet (so the UI can show the gray indicator without a special case).
+func handleCardJiraSync(db *DB, dispatcher *Dispatcher) 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
+		}
+		id := r.PathValue("id")
+		state, err := db.readCardJiraSync(id)
+		if err != nil {
+			notFound(w, "card not found")
+			return
+		}
+		state.Inflight = dispatcher.IsInflight(id)
+		// Resolve issue URL by reading any enabled jira module's base_url. We
+		// pick the first match because the kanban-jira link is conceptually
+		// 1:1 — multiple jira modules pointing at different projects would be
+		// a misconfiguration.
+		if state.JiraKey != "" {
+			if mods, err := db.listModulesEnabled(); err == nil {
+				for _, m := range mods {
+					if m.Kind != "jira" {
+						continue
+					}
+					cfg, perr := parseJiraConfig(m)
+					if perr == nil && cfg.BaseURL != "" {
+						state.IssueURL = cfg.BaseURL + "/browse/" + state.JiraKey
+						break
+					}
+				}
+			}
+		}
+		infra.HTTPJSONResponse(w, http.StatusOK, state)
+	}
+}

backend/modules_test.go

@@ -0,0 +1,235 @@
+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) {
+		switch {
+		case 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"}`)
+		case r.Method == http.MethodGet && r.URL.Path == "/rest/api/3/issue/KAN-1/transitions":
+			w.WriteHeader(http.StatusOK)
+			_, _ = io.WriteString(w, `{"transitions":[{"id":"11","name":"Start","to":{"name":"To Do"}}]}`)
+		case r.Method == http.MethodPost && r.URL.Path == "/rest/api/3/issue/KAN-1/transitions":
+			w.WriteHeader(http.StatusNoContent)
+		case r.Method == http.MethodPut && r.URL.Path == "/rest/api/3/issue/KAN-1":
+			w.WriteHeader(http.StatusNoContent)
+		default:
+			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")
+	}
+}

backend/notifications.go

@@ -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
+}

backend/notifications_test.go

@@ -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)
+	}
+}

backend/realtime.go

@@ -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})
+	}
+}

backend/resync_jira.go

@@ -0,0 +1,192 @@
+package main
+
+import (
+	"bytes"
+	"context"
+	"encoding/base64"
+	"encoding/json"
+	"flag"
+	"fmt"
+	"io"
+	"net/http"
+	"strings"
+	"time"
+)
+
+// runResyncJiraFields patches every Jira issue currently linked to a kanban
+// card so its issuetype / assignee / labels reflect the *latest* module
+// configuration. Use cases:
+//
+//   - We changed issue_type in the module (e.g. "Tarea Técnica" → "Epic") and
+//     need the backfilled issues to match.
+//   - We added/changed the assignee_map and want existing issues to pick up
+//     the mapping retroactively.
+//   - We renamed kanban columns and need labels re-applied.
+//
+// The CLI is idempotent: running it twice on the same set is a no-op for
+// fields that already match. Batching mirrors `backfill-jira` so we stay
+// under Jira's REST quota.
+func runResyncJiraFields(args []string) error {
+	fs := flag.NewFlagSet("kanban resync-jira-fields", flag.ContinueOnError)
+	dbPath := fs.String("db", "operations.db", "SQLite database path")
+	batchSize := fs.Int("batch-size", 10, "Issues per batch before pausing")
+	pauseSec := fs.Int("pause-sec", 5, "Seconds to sleep between batches")
+	limit := fs.Int("limit", 0, "Maximum issues to patch (0 = no limit)")
+	doIssueType := fs.Bool("set-issuetype", true, "Set issuetype to module.issue_type")
+	doAssignee := fs.Bool("set-assignee", true, "Set assignee from module.assignee_map (or clear when no mapping)")
+	doLabels := fs.Bool("set-labels", false, "Re-apply labels from module.labels_map (off by default; labels were already correct after backfill)")
+	dryRun := fs.Bool("dry-run", false, "Print the planned PATCH for each issue and exit")
+	if err := fs.Parse(args); err != nil {
+		return err
+	}
+
+	db, err := openDB(*dbPath)
+	if err != nil {
+		return fmt.Errorf("open db: %w", err)
+	}
+	defer db.Close()
+
+	_, cfg, err := activeJiraModule(db)
+	if err != nil {
+		return fmt.Errorf("module config: %w", err)
+	}
+
+	cards, err := listLinkedJiraCards(db, *limit)
+	if err != nil {
+		return err
+	}
+	if len(cards) == 0 {
+		fmt.Println("no linked cards to resync")
+		return nil
+	}
+
+	fmt.Printf("resync plan: %d issues; batch=%d pause=%ds dry_run=%v\n",
+		len(cards), *batchSize, *pauseSec, *dryRun)
+	fmt.Printf("ops: issuetype=%v(%q)  assignee=%v(%d mappings)  labels=%v\n",
+		*doIssueType, cfg.IssueType, *doAssignee, len(cfg.AssigneeMap), *doLabels)
+	fmt.Println()
+
+	var ok, failed, noop int
+	for i, c := range cards {
+		if i > 0 && i%*batchSize == 0 {
+			fmt.Printf("--- batch boundary (%d/%d) — sleeping %ds ---\n", i, len(cards), *pauseSec)
+			time.Sleep(time.Duration(*pauseSec) * time.Second)
+		}
+		fields := map[string]interface{}{}
+		if *doIssueType && cfg.IssueType != "" {
+			fields["issuetype"] = map[string]string{"name": cfg.IssueType}
+		}
+		if *doAssignee {
+			acct := cfg.AssigneeMap[c.AssigneeID]
+			if acct != "" {
+				fields["assignee"] = map[string]string{"accountId": acct}
+			}
+			// We intentionally do NOT clear the assignee when the card has no
+			// mapping — that would overwrite a manual Jira assignment with
+			// nothing. To explicitly clear, the operator can remove the card's
+			// kanban assignee and trigger a card.updated event.
+		}
+		if *doLabels {
+			labels := cfg.LabelsMap[c.ColumnName]
+			if labels == nil {
+				labels = []string{}
+			}
+			fields["labels"] = labels
+		}
+		if len(fields) == 0 {
+			noop++
+			fmt.Printf("[%4d/%4d] NOOP  %s  (no fields to patch)\n", i+1, len(cards), c.JiraKey)
+			continue
+		}
+		if *dryRun {
+			b, _ := json.Marshal(fields)
+			fmt.Printf("[%4d/%4d] PLAN  %s  fields=%s\n", i+1, len(cards), c.JiraKey, b)
+			continue
+		}
+		status, err := jiraPUTFields(context.Background(), cfg, c.JiraKey, fields)
+		if err != nil {
+			failed++
+			fmt.Printf("[%4d/%4d] FAIL  %s  http=%d  err=%s\n",
+				i+1, len(cards), c.JiraKey, status, truncateInline(err.Error(), 100))
+			continue
+		}
+		ok++
+		fmt.Printf("[%4d/%4d] OK    %s\n", i+1, len(cards), c.JiraKey)
+	}
+	fmt.Println()
+	fmt.Printf("done: %d ok · %d noop · %d failed · %d total\n", ok, noop, failed, len(cards))
+	if failed > 0 {
+		return fmt.Errorf("%d issues failed to patch", failed)
+	}
+	return nil
+}
+
+// linkedJiraCard is the projection used by the resync CLI. We also pull
+// assignee_id so the assignee_map lookup works without re-fetching cards.
+type linkedJiraCard struct {
+	ID         string
+	JiraKey    string
+	ColumnName string
+	AssigneeID string
+}
+
+func listLinkedJiraCards(db *DB, limit int) ([]linkedJiraCard, error) {
+	q := `
+SELECT c.id, c.jira_key, col.name, COALESCE(c.assignee_id, '')
+FROM cards c
+JOIN columns col ON col.id = c.column_id
+WHERE c.jira_key != ''
+  AND c.deleted_at IS NULL
+ORDER BY c.jira_key ASC
+`
+	args := []interface{}{}
+	if limit > 0 {
+		q += " LIMIT ? "
+		args = append(args, limit)
+	}
+	rows, err := db.conn.Query(q, args...)
+	if err != nil {
+		return nil, fmt.Errorf("list linked cards: %w", err)
+	}
+	defer rows.Close()
+	out := []linkedJiraCard{}
+	for rows.Next() {
+		var c linkedJiraCard
+		if err := rows.Scan(&c.ID, &c.JiraKey, &c.ColumnName, &c.AssigneeID); err != nil {
+			return nil, err
+		}
+		out = append(out, c)
+	}
+	return out, rows.Err()
+}
+
+// jiraPUTFields is a thin wrapper around PUT /rest/api/3/issue/{key} that
+// returns the HTTP status code + error. We do not need the response body —
+// Jira returns 204 No Content on success.
+func jiraPUTFields(ctx context.Context, c jiraConfig, key string, fields map[string]interface{}) (int, error) {
+	body := map[string]interface{}{"fields": fields}
+	raw, err := json.Marshal(body)
+	if err != nil {
+		return 0, err
+	}
+	req, err := http.NewRequestWithContext(ctx, http.MethodPut,
+		c.BaseURL+"/rest/api/3/issue/"+key, bytes.NewReader(raw))
+	if err != nil {
+		return 0, err
+	}
+	req.Header.Set("Accept", "application/json")
+	req.Header.Set("Content-Type", "application/json")
+	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, err
+	}
+	defer resp.Body.Close()
+	respBody, _ := io.ReadAll(io.LimitReader(resp.Body, 1<<20))
+	if resp.StatusCode >= 400 {
+		return resp.StatusCode, fmt.Errorf("jira PUT %s: %d %s",
+			key, resp.StatusCode, truncateInline(strings.TrimSpace(string(respBody)), 240))
+	}
+	return resp.StatusCode, nil
+}

backend/seed_jira.go

@@ -0,0 +1,166 @@
+package main
+
+import (
+	"flag"
+	"fmt"
+	"os/exec"
+	"strings"
+)
+
+// runSeedJiraData provisions (or updates) the Jira module that pushes kanban
+// changes to soporte-anjana.atlassian.net, project DATA, board 33.
+//
+// Credentials are read from `pass` so they never appear in argv or env. The
+// API token, email, and domain are loaded from the canonical entries:
+//
+//	pass jira/anjana/api-token
+//	pass jira/anjana/email
+//	pass jira/anjana/domain
+//
+// Defaults can be overridden with flags (project, board, name, filter).
+//
+// Idempotent: if a module with the same name already exists, its config is
+// rewritten (encrypted at rest by saveModule). The kanban module key
+// (KANBAN_MODULE_KEY env var) must be set — the same value the running server
+// uses, otherwise the server cannot decrypt the secrets we wrote.
+func runSeedJiraData(args []string) error {
+	fs := flag.NewFlagSet("kanban seed-jira-data", flag.ContinueOnError)
+	dbPath := fs.String("db", "operations.db", "SQLite database path")
+	name := fs.String("name", "Jira DATA", "Module display name (also used as upsert key)")
+	project := fs.String("project", "DATA", "Jira project key (e.g. DATA)")
+	board := fs.Int("board", 33, "Jira board id (Agile board; informational + validated at /test)")
+	filter := fs.String("event-filter", "card.created,card.updated,card.moved,message.created",
+		"Comma-separated event types this module subscribes to")
+	enabled := fs.Bool("enabled", true, "Start with module enabled (true) or disabled (false)")
+	passEntry := fs.String("pass-prefix", "jira/anjana", "pass entry prefix; reads ${prefix}/{email,api-token,domain}")
+	requesterField := fs.String("requester-field", "customfield_10158",
+		"Jira custom field id for the required 'Área Solicitante' select (empty to disable)")
+	requesterDefault := fs.String("requester-default", "Transformación",
+		"Default 'Área Solicitante' option value for auto-created cards whose requester is not mapped")
+	if err := fs.Parse(args); err != nil {
+		return err
+	}
+
+	email, err := passShow(*passEntry + "/email")
+	if err != nil {
+		return fmt.Errorf("read email from pass: %w", err)
+	}
+	token, err := passShow(*passEntry + "/api-token")
+	if err != nil {
+		return fmt.Errorf("read api-token from pass: %w", err)
+	}
+	domain, err := passShow(*passEntry + "/domain")
+	if err != nil {
+		return fmt.Errorf("read domain from pass: %w", err)
+	}
+	baseURL := "https://" + strings.TrimSpace(domain)
+
+	db, err := openDB(*dbPath)
+	if err != nil {
+		return fmt.Errorf("open db: %w", err)
+	}
+	defer db.Close()
+
+	// Default mapping for our setup: Kanban columns → Jira `Epicas en Data` board (33)
+	// statuses. Operator can edit via the Modulos UI once the row exists.
+	statusMap := map[string]string{
+		"HACIENDO 🚧":       "In Progress",
+		"PNDNT FEEDBACK ▶️": "IMPLEMENTADO",
+		"HECHO ✅":          "Done",
+		"IDEAS 💡":          "CREADO",
+		"DEUDA TÉCNICA 🔄":  "To Do",
+		"Bloqueadas":        "In Progress",
+	}
+	labelsMap := map[string][]string{
+		"Bloqueadas": {"blocked"},
+	}
+	// kanban user_id -> Jira accountId. Resolved via Jira /user/search; the
+	// three current data-team users keep stable IDs across sessions. New
+	// users added to the kanban must be added here (or the seed re-run with
+	// --pass-prefix overrides) so the dispatcher can route the assignee.
+	assigneeMap := map[string]string{
+		"6a75edc6e99d8405": "712020:2cf3b82f-47d6-4597-b0e9-ffaaf3a07cc3", // Enmaa  -> Enmanuel Gutierrez Perez
+		"039c97acf1869393": "712020:3f3ca9e1-c86e-445e-979a-bc7b82a4f45d", // alfon  -> Alfonso Massaguer Gómez
+		"9e91db261084d529": "712020:feb5f7c5-7643-4381-977c-d83c95ba4955", // Nat    -> Natalia Tajuelo Gomez
+	}
+
+	cfg := JSONValue{
+		"base_url":     baseURL,
+		"email":        email,
+		"api_token":    token,
+		"project_key":  *project,
+		"board_id":     *board,
+		"issue_type":   "Epic",
+		"status_map":   statusMap,
+		"labels_map":   labelsMap,
+		"assignee_map": assigneeMap,
+	}
+	if *requesterField != "" {
+		cfg["requester_field"] = *requesterField
+		cfg["requester_default"] = *requesterDefault
+	}
+
+	// Upsert by name. Module name is the human-friendly identifier; we treat
+	// it as unique for the purposes of seeding so re-running this command does
+	// not duplicate the row.
+	mods, err := db.listModulesAll()
+	if err != nil {
+		return fmt.Errorf("list modules: %w", err)
+	}
+	var existing *Module
+	for i := range mods {
+		if mods[i].Name == *name {
+			existing = &mods[i]
+			break
+		}
+	}
+
+	if existing != nil {
+		existing.Kind = "jira"
+		existing.Enabled = *enabled
+		existing.EventFilter = splitCSV(*filter)
+		// Merge so keys the operator added via the UI (e.g. a custom
+		// requester_map) survive a re-seed. Seed-managed keys are refreshed.
+		if existing.Config == nil {
+			existing.Config = JSONValue{}
+		}
+		for k, v := range cfg {
+			existing.Config[k] = v
+		}
+		if err := db.saveModule(existing); err != nil {
+			return fmt.Errorf("update module: %w", err)
+		}
+		fmt.Printf("updated module %q (id=%s)\n", existing.Name, existing.ID)
+		return nil
+	}
+
+	m := &Module{
+		Name:        *name,
+		Kind:        "jira",
+		Enabled:     *enabled,
+		EventFilter: splitCSV(*filter),
+		Config:      cfg,
+	}
+	if err := db.saveModule(m); err != nil {
+		return fmt.Errorf("create module: %w", err)
+	}
+	fmt.Printf("created module %q (id=%s)\n", m.Name, m.ID)
+	fmt.Printf("project: %s  board: %d  base_url: %s  email: %s\n",
+		*project, *board, baseURL, email)
+	fmt.Println("\nnext steps:")
+	fmt.Println("  1. Edit status_map in the Modulos UI: map kanban column names to Jira statuses")
+	fmt.Println("     (e.g. \"In Progress\" → \"In Progress\", \"Done\" → \"Done\")")
+	fmt.Println("  2. Click \"Test\" in the UI to verify board 33 belongs to project DATA")
+	fmt.Println("  3. Move a card in kanban — push should hit Jira REST API")
+	return nil
+}
+
+// passShow shells out to pass(1) to read a secret. We do not cache or print
+// the value; just trim trailing whitespace before returning.
+func passShow(entry string) (string, error) {
+	out, err := exec.Command("pass", "show", entry).Output()
+	if err != nil {
+		return "", fmt.Errorf("pass show %s: %w", entry, err)
+	}
+	return strings.TrimSpace(string(out)), nil
+}

backend/tools.go

@@ -19,8 +19,15 @@ func errResult(err error) ToolResult  { return ToolResult{OK: false, Error: err.
 func errMsg(msg string) ToolResult    { return ToolResult{OK: false, Error: msg} }
 
 // executeTool dispatches a tool by name with raw JSON input and returns a ToolResult.
-// Tools that mutate the board return ok=true on success; read-only tools include their data in result.
+// Used by the legacy chat path (no authenticated user available).
 func executeTool(db *DB, name string, input json.RawMessage) ToolResult {
+	return executeToolAs(db, name, input, "")
+}
+
+// executeToolAs is the actor-aware dispatch used by the HTTP MCP path.
+// actor is the authenticated user id (resolved from the bearer token) for tools
+// that need it (add_comment / delete_comment infer the author from it).
+func executeToolAs(db *DB, name string, input json.RawMessage, actor string) ToolResult {
 	switch name {
 	case "list_board":
 		return toolListBoard(db)
@@ -50,6 +57,14 @@ func executeTool(db *DB, name string, input json.RawMessage) ToolResult {
 		return toolListUsers(db)
 	case "assign_card":
 		return toolAssignCard(db, input)
+	case "get_card":
+		return toolGetCard(db, input)
+	case "add_comment":
+		return toolAddCommentAs(db, input, actor)
+	case "list_comments":
+		return toolListComments(db, input)
+	case "delete_comment":
+		return toolDeleteComment(db, input, actor)
 	default:
 		return errMsg("unknown tool: " + name)
 	}
@@ -59,7 +74,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", "delete_comment":
 		return true
 	}
 	return false
@@ -347,9 +363,124 @@ 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, "delete_comment": true,
+		"get_card": true,
 	}
 	if !known[name] {
 		return fmt.Errorf("unknown tool: %s", name)
 	}
 	return nil
 }
+
+// toolAddCommentAs appends a comment (card_message) to a card.
+//
+// Author resolution order:
+//  1. explicit "author_id" in input (legacy chat path)
+//  2. explicit "author_username" in input -> resolve to id
+//  3. fallback to `actor` (authenticated user from MCP HTTP token)
+//
+// At least one must yield a non-empty id.
+func toolAddCommentAs(db *DB, input json.RawMessage, actor string) 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 == "" && in.AuthorUsername != "" {
+		u, _, err := db.GetUserByUsername(in.AuthorUsername)
+		if err != nil {
+			return errResult(fmt.Errorf("author_username: %w", err))
+		}
+		authorID = u.ID
+	}
+	if authorID == "" {
+		authorID = actor
+	}
+	if authorID == "" {
+		return errMsg("author_id, author_username, or authenticated MCP token required")
+	}
+	m, err := db.CreateCardMessage(in.CardID, authorID, in.Body)
+	if err != nil {
+		return errResult(err)
+	}
+	return okResult(m)
+}
+
+// toolGetCard returns a single active (non-archived) card by id or seq_num.
+// Pass exactly ONE of {id, seq_num}.
+func toolGetCard(db *DB, input json.RawMessage) ToolResult {
+	var in struct {
+		ID     string `json:"id"`
+		SeqNum int    `json:"seq_num"`
+	}
+	if err := json.Unmarshal(input, &in); err != nil {
+		return errResult(err)
+	}
+	if in.ID == "" && in.SeqNum == 0 {
+		return errMsg("provide id or seq_num")
+	}
+	cards, err := db.ListCardsWithTime()
+	if err != nil {
+		return errResult(err)
+	}
+	for _, c := range cards {
+		if in.ID != "" && c.ID == in.ID {
+			return okResult(c)
+		}
+		if in.SeqNum != 0 && c.SeqNum == in.SeqNum {
+			return okResult(c)
+		}
+	}
+	return errMsg("card not found")
+}
+
+// toolDeleteComment deletes a comment. Only the original author can delete it
+// (enforced via actor == message.author_id).
+func toolDeleteComment(db *DB, input json.RawMessage, actor string) ToolResult {
+	if actor == "" {
+		return errMsg("authenticated user required (call via MCP HTTP with a valid token)")
+	}
+	var in struct {
+		ID string `json:"id"`
+	}
+	if err := json.Unmarshal(input, &in); err != nil {
+		return errResult(err)
+	}
+	if in.ID == "" {
+		return errMsg("id required")
+	}
+	if err := db.DeleteCardMessage(in.ID, actor); err != nil {
+		return errResult(err)
+	}
+	return okResult(map[string]bool{"ok": true})
+}
+
+// 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)
+}

backend/tools_test.go

@@ -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)
 	}

backend/users.go

@@ -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()

control.sh

@@ -0,0 +1,248 @@
+#!/usr/bin/env bash
+# Kanban control TUI — gestiona backend (WSL) + frontend Vite (Windows) desde WSL.
+# Lanzamientos fire-and-forget; status panel auto-refresca cada 2s.
+# Lanzar: ./control.sh
+set -u
+
+BACKEND_PORT=8095
+FRONTEND_PORT=5180
+APP_DIR="/home/egutierrez/fn_registry/apps/kanban"
+BACKEND_LOG="/tmp/kanban.log"
+BUILD_LOG="/tmp/kanban_build.log"
+MSG_FILE="/tmp/kanban_control.msg"
+WIN_FRONT_DIR='C:\Users\egutierrez\fn_apps\kanban\frontend'
+
+RED=$'\033[31m'; GRN=$'\033[32m'; YLW=$'\033[33m'; CYN=$'\033[36m'; BLD=$'\033[1m'; RST=$'\033[0m'
+
+msg() { printf '%s\n' "$*" > "$MSG_FILE"; }
+
+wsl_pid_on_port() {
+    local port=$1
+    ss -ltnp 2>/dev/null | awk -v p=":$port\$" '$4 ~ p {print $0}' \
+        | grep -oP 'pid=\K[0-9]+' | head -1
+}
+
+win_pid_on_port() {
+    local port=$1
+    netstat.exe -ano 2>/dev/null | tr -d '\r' \
+        | awk -v p=":$port\$" '$2 ~ p && $4 == "LISTENING" {print $5; exit}'
+}
+
+backend_building() {
+    [[ -f /tmp/kanban_build.pid ]] && kill -0 "$(cat /tmp/kanban_build.pid 2>/dev/null)" 2>/dev/null
+}
+
+# Build + launch en background — retorna inmediatamente
+start_backend() {
+    if [[ -n $(wsl_pid_on_port "$BACKEND_PORT") ]]; then
+        msg "${YLW}backend ya corriendo${RST}"; return 0
+    fi
+    if backend_building; then
+        msg "${YLW}backend ya esta compilando, espera${RST}"; return 0
+    fi
+    local version
+    version=$(awk -F': ' '/^version:/ {print $2; exit}' "$APP_DIR/app.md" 2>/dev/null || echo dev)
+    msg "${CYN}lanzando backend en background (version=$version)...${RST}"
+    (
+        cd "$APP_DIR/backend" || exit 1
+        # Rebuild si: binario no existe, .go/.sql mas nuevos, app.md mas nuevo (bump de version)
+        if [[ ! -x kanban ]] \
+           || [[ -n $(find . -maxdepth 3 \( -name '*.go' -o -name '*.sql' \) -newer kanban 2>/dev/null) ]] \
+           || [[ "$APP_DIR/app.md" -nt kanban ]]; then
+            CGO_ENABLED=1 go build -tags fts5 \
+                -ldflags="-X main.Version=$version" \
+                -o kanban . > "$BUILD_LOG" 2>&1 || {
+                printf 'build failed — ver %s\n' "$BUILD_LOG" > "$MSG_FILE"
+                exit 1
+            }
+        fi
+        cd "$APP_DIR" || exit 1
+        KANBAN_CLAUDE_BIN=/home/egutierrez/.local/bin/claude \
+            setsid nohup ./backend/kanban --port "$BACKEND_PORT" --db ./operations.db \
+            > "$BACKEND_LOG" 2>&1 < /dev/null &
+        disown
+    ) &
+    echo $! > /tmp/kanban_build.pid
+    disown
+}
+
+stop_backend() {
+    local pid
+    pid=$(wsl_pid_on_port "$BACKEND_PORT")
+    if [[ -z $pid ]]; then
+        msg "${YLW}backend ya parado${RST}"; return 0
+    fi
+    kill "$pid" 2>/dev/null
+    ( sleep 1; kill -0 "$pid" 2>/dev/null && kill -9 "$pid" 2>/dev/null ) &
+    disown
+    msg "${GRN}backend stopped (pid $pid)${RST}"
+}
+
+wsl_ip() { hostname -I | awk '{print $1}'; }
+
+# WSL frontend → Windows frontend (excluye node_modules, dist, .vite)
+sync_frontend() {
+    local src="$APP_DIR/frontend/"
+    local dst="/mnt/c/Users/egutierrez/fn_apps/kanban/frontend/"
+    if [[ ! -d $dst ]]; then
+        msg "${RED}no existe $dst${RST}"; return 1
+    fi
+    rsync -a --delete \
+        --exclude node_modules --exclude dist --exclude .vite \
+        --exclude .cache --exclude tsconfig.tsbuildinfo \
+        "$src" "$dst" 2>&1 | tail -3
+    # pnpm install si package.json cambio
+    if ! cmp -s "$src/package.json" "$dst/package.json" 2>/dev/null \
+       || [[ ! -d "$dst/node_modules" ]]; then
+        msg "${CYN}deps cambiaron, lanza pnpm install en Windows...${RST}"
+        cmd.exe /c start "" cmd /c "cd /d $WIN_FRONT_DIR && pnpm install" >/dev/null 2>&1 &
+        disown
+    fi
+}
+
+# Lanza ventana cmd Windows con pnpm dev — no bloquea
+# Inyecta VITE_API_TARGET con IP WSL real porque localhost forwarding Win→WSL no es fiable
+start_vite() {
+    if [[ -n $(win_pid_on_port "$FRONTEND_PORT") ]]; then
+        msg "${YLW}vite ya corriendo${RST}"; return 0
+    fi
+    sync_frontend
+    local ip target
+    ip=$(wsl_ip)
+    target="http://${ip}:${BACKEND_PORT}"
+    cmd.exe /c start "" cmd /c "cd /d $WIN_FRONT_DIR && set VITE_API_TARGET=$target && pnpm dev --port $FRONTEND_PORT --strictPort --host" >/dev/null 2>&1 &
+    disown
+    msg "${CYN}vite lanzado, proxy → $target${RST}"
+}
+
+stop_vite() {
+    local pid
+    pid=$(win_pid_on_port "$FRONTEND_PORT")
+    if [[ -z $pid ]]; then
+        msg "${YLW}vite ya parado${RST}"; return 0
+    fi
+    taskkill.exe /F /T /PID "$pid" >/dev/null 2>&1 &
+    disown
+    msg "${GRN}taskkill enviado a vite pid $pid${RST}"
+}
+
+kill_stale() {
+    local found=0 out=""
+    for pid in $(pgrep -f "backend/kanban --port" 2>/dev/null); do
+        local cmdl
+        cmdl=$(tr '\0' ' ' < /proc/$pid/cmdline 2>/dev/null)
+        if ! grep -q -- "--port $BACKEND_PORT" <<<"$cmdl"; then
+            kill -9 "$pid" 2>/dev/null
+            out+="killed wsl pid $pid ($cmdl); "
+            found=1
+        fi
+    done
+    [[ $found -eq 0 ]] && msg "${GRN}sin huerfanos WSL${RST}" || msg "${GRN}${out}${RST}"
+}
+
+_prev_frame=""
+build_frame() {
+    local bpid vpid hc others
+    bpid=$(wsl_pid_on_port "$BACKEND_PORT")
+    vpid=$(win_pid_on_port "$FRONTEND_PORT")
+    local out=""
+    out+=$(printf '%s=== Kanban control ===%s' "$BLD" "$RST")$'\n\n'
+    if [[ -n $bpid ]]; then
+        local rv av
+        rv=$(curl -s -m 1 "http://127.0.0.1:$BACKEND_PORT/api/version" | grep -oP '"version":"\K[^"]+' || echo "?")
+        av=$(awk -F': ' '/^version:/ {print $2; exit}' "$APP_DIR/app.md" 2>/dev/null || echo "?")
+        if [[ "$rv" == "$av" ]]; then
+            hc="${GRN}v$rv${RST}"
+        else
+            hc="${YLW}running=v$rv app.md=v$av (rebuild)${RST}"
+        fi
+        out+=$(printf '  backend (WSL :%s)   %sUP%s   pid %s   %s' \
+            "$BACKEND_PORT" "$GRN" "$RST" "$bpid" "$hc")$'\n'
+    elif backend_building; then
+        out+=$(printf '  backend (WSL :%s)   %sBUILDING/STARTING%s   tail %s' \
+            "$BACKEND_PORT" "$YLW" "$RST" "$BUILD_LOG")$'\n'
+    else
+        out+=$(printf '  backend (WSL :%s)   %sDOWN%s' "$BACKEND_PORT" "$RED" "$RST")$'\n'
+    fi
+    # frontend version + drift WSL↔Win
+    local fv drift
+    fv=$(grep -oP '"version":\s*"\K[^"]+' "$APP_DIR/frontend/package.json" 2>/dev/null || echo "?")
+    drift=$(diff -rq "$APP_DIR/frontend/src" "/mnt/c/Users/egutierrez/fn_apps/kanban/frontend/src" 2>/dev/null \
+        | grep -c -E "^(Files|Only)" || true)
+    local dlbl
+    if [[ ${drift:-0} -eq 0 ]]; then
+        dlbl="${GRN}sync${RST}"
+    else
+        dlbl="${YLW}drift=$drift (sync al start)${RST}"
+    fi
+    if [[ -n $vpid ]]; then
+        out+=$(printf '  vite    (WIN :%s)  %sUP%s   pid %s   v%s   %s' "$FRONTEND_PORT" "$GRN" "$RST" "$vpid" "$fv" "$dlbl")$'\n'
+    else
+        out+=$(printf '  vite    (WIN :%s)  %sDOWN%s   v%s   %s' "$FRONTEND_PORT" "$RED" "$RST" "$fv" "$dlbl")$'\n'
+    fi
+    others=$(pgrep -af "backend/kanban --port" 2>/dev/null | grep -v -- "--port $BACKEND_PORT" || true)
+    if [[ -n $others ]]; then
+        out+=$(printf '  %sOTROS kanban backends WSL:%s' "$YLW" "$RST")$'\n'
+        out+=$(echo "$others" | sed 's/^/    /')$'\n'
+    fi
+    out+=$'\n'
+    out+=$(printf '%sUltimo evento:%s %s' "$CYN" "$RST" "$(tail -1 "$MSG_FILE" 2>/dev/null || echo '-')")$'\n\n'
+    out+="${BLD}Acciones${RST} (auto-refresh 2s, tecla suelta):"$'\n'
+    out+="  1) Start backend             5) Start TODO"$'\n'
+    out+="  2) Stop backend              6) Stop TODO"$'\n'
+    out+="  3) Start vite                7) Mata kanban huerfanos"$'\n'
+    out+="  4) Stop vite                 8) Tail backend log"$'\n'
+    out+="                               9) Refrescar     0) Salir"$'\n'
+    out+="> "
+    printf '%s' "$out"
+}
+
+draw_status() {
+    local frame
+    frame=$(build_frame)
+    if [[ $frame == "$_prev_frame" ]]; then
+        return 0
+    fi
+    _prev_frame=$frame
+    # cursor home + frame + erase-to-end-of-display (limpia lineas residuales)
+    printf '\033[H%s\033[J' "$frame"
+}
+
+tail_log() {
+    clear
+    printf '%stail -f %s (Ctrl-C vuelve al menu)%s\n' "$CYN" "$BACKEND_LOG" "$RST"
+    trap 'trap - INT; return 0' INT
+    tail -f "$BACKEND_LOG" 2>/dev/null
+    trap - INT
+}
+
+menu() {
+    : > "$MSG_FILE"
+    # limpia pantalla una sola vez; redraw posterior usa cursor-home
+    printf '\033[2J\033[H'
+    trap 'printf "\033[?25h\n"; exit 0' EXIT INT TERM
+    printf '\033[?25l'  # oculta cursor mientras dibujamos
+    while true; do
+        draw_status
+        # read con timeout 2s — refresco automatico si no hay tecla
+        local choice=""
+        if read -rsn1 -t 2 choice; then
+            case "$choice" in
+                1) start_backend ;;
+                2) stop_backend ;;
+                3) start_vite ;;
+                4) stop_vite ;;
+                5) start_backend; start_vite ;;
+                6) stop_vite; stop_backend ;;
+                7) kill_stale ;;
+                8) printf '\033[?25h'; tail_log; printf '\033[?25l'; _prev_frame=""; printf '\033[2J\033[H' ;;
+                9) : ;;
+                0|q|Q) printf '\033[?25h'; clear; exit 0 ;;
+                $'\n'|"") : ;;
+                *) msg "${RED}opcion invalida: $choice${RST}" ;;
+            esac
+        fi
+    done
+}
+
+menu

docs/INSTALL_CLAUDE_MCP.md

@@ -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.

docs/MCP.md

@@ -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. |

e2e/smoke_live.sh

@@ -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"

frontend/src/App.tsx

@@ -55,6 +55,9 @@ import {
   IconChevronRight,
   IconLayoutKanban,
   IconLogout,
+  IconPlug,
+  IconKey,
+  IconBrandJira,
   IconMenu2,
   IconMessageChatbot,
   IconMoodSmile,
@@ -81,7 +84,12 @@ 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 { JiraModal } from "./components/JiraModal";
+import { useEventStream } from "./hooks/useEventStream";
+import type { Board, Card, CardColor, Column, ColumnLocation, Notification, User } from "./types";
 
 const COL_PREFIX = "column-";
 
@@ -251,6 +259,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 +351,76 @@ 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 [jiraImportOpen, setJiraImportOpen] = 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 +452,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;
@@ -558,6 +652,10 @@ export function App() {
 
     try {
       await api.moveCard(activeId, destCol, orderedIds);
+      // Nudge the moved card's Jira sync indicator to refetch immediately
+      // so the operator sees the yellow "syncing" state without waiting for
+      // the steady-state poll tick (5s).
+      window.dispatchEvent(new CustomEvent("kanban-card-moved", { detail: { cardId: activeId } }));
     } catch (err) {
       notifications.show({ color: "red", message: (err as Error).message });
     }
@@ -658,7 +756,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 +767,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 +1212,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 +1261,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 +1291,28 @@ export function App() {
                       />
                     </Box>
                     <Menu.Divider />
+                    {auth.user.is_admin && (
+                      <Menu.Item
+                        leftSection={<IconPlug size={14} />}
+                        onClick={() => setModulesOpen(true)}
+                      >
+                        Modulos
+                      </Menu.Item>
+                    )}
+                    {auth.user.is_admin && (
+                      <Menu.Item
+                        leftSection={<IconBrandJira size={14} />}
+                        onClick={() => setJiraImportOpen(true)}
+                      >
+                        Jira
+                      </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 +1323,18 @@ export function App() {
                   </Menu.Dropdown>
                 </Menu>
               )}
+              {auth.user?.is_admin && (
+                <ModulesModal opened={modulesOpen} onClose={() => setModulesOpen(false)} />
+              )}
+              {auth.user?.is_admin && board && (
+                <JiraModal
+                  opened={jiraImportOpen}
+                  onClose={() => setJiraImportOpen(false)}
+                  columns={board.columns}
+                  onMutated={() => reload()}
+                />
+              )}
+              <MCPTokensModal opened={mcpTokensOpen} onClose={() => setMcpTokensOpen(false)} />
             </Group>
           </Group>
         </AppShell.Header>

frontend/src/api.ts

@@ -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,133 @@ 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" });
+}
+
+// --- Jira sync state + import ----------------------------------------------
+
+export interface CardJiraSyncState {
+  card_id: string;
+  jira_key: string;
+  last_status: string;
+  last_sync_at: string;
+  last_error: string;
+  inflight: boolean;
+  issue_url?: string;
+}
+
+export function getCardJiraSync(cardId: string): Promise<CardJiraSyncState> {
+  return fetchJSON(`/cards/${cardId}/jira-sync`);
+}
+
+export interface JiraIssue {
+  key: string;
+  summary: string;
+  status_name: string;
+  issue_type: string;
+  assignee: string;
+  updated: string;
+  url: string;
+  already_imported: boolean;
+  mapped_column_id?: string;
+  issue_type_icon?: string;
+}
+
+export interface ListJiraIssuesResponse {
+  issues: JiraIssue[];
+  board_id: number;
+  project_key: string;
+  status_to_column: Record<string, string>;
+  include_imported: boolean;
+}
+
+export function listJiraIssues(opts?: { includeImported?: boolean; limit?: number }): Promise<ListJiraIssuesResponse> {
+  const qs = new URLSearchParams();
+  if (opts?.includeImported) qs.set("include_imported", "true");
+  if (opts?.limit) qs.set("limit", String(opts.limit));
+  const q = qs.toString();
+  return fetchJSON(`/jira/issues${q ? `?${q}` : ""}`);
+}
+
+export interface JiraImportResult {
+  key: string;
+  status: "imported" | "skipped" | "error";
+  card_id?: string;
+  column_id?: string;
+  error?: string;
+}
+
+export function importJiraIssues(issueKeys: string[], fallbackColumnId?: string): Promise<{ results: JiraImportResult[] }> {
+  return fetchJSON("/jira/import", {
+    method: "POST",
+    body: JSON.stringify({ issue_keys: issueKeys, fallback_column_id: fallbackColumnId || "" }),
+  });
+}
+
+export interface JiraCheckRow {
+  card_id: string;
+  jira_key: string;
+  title: string;
+  kanban_column_id: string;
+  kanban_column_name: string;
+  jira_status_name: string;
+  expected_kanban_col: string;
+  expected_jira_status: string;
+  mismatch: boolean;
+  issue_url: string;
+}
+
+export interface JiraCheckResponse {
+  rows: JiraCheckRow[];
+  total: number;
+  mismatches: number;
+  in_sync: number;
+  status_map: Record<string, string>;
+  reverse_map: Record<string, string>;
+}
+
+export function checkJiraColumns(): Promise<JiraCheckResponse> {
+  return fetchJSON("/jira/check-columns");
+}
+
+export interface JiraReconcileResult {
+  card_id: string;
+  status: "fixed" | "skipped" | "error";
+  jira_key?: string;
+  jira_status?: string;
+  error?: string;
+  http?: number;
+}
+
+export function reconcileJiraColumns(cardIds: string[]): Promise<{ results: JiraReconcileResult[] }> {
+  return fetchJSON("/jira/reconcile-columns", {
+    method: "POST",
+    body: JSON.stringify({ card_ids: cardIds, direction: "kanban-wins" }),
+  });
+}
+
 export function getMetrics(f: MetricsFilter): Promise<Metrics> {
   const qs = new URLSearchParams();
   if (f.from) qs.set("from", f.from);

frontend/src/components/CardChatPanel.tsx

@@ -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={{

frontend/src/components/CardEditPanel.tsx

@@ -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>

frontend/src/components/JiraModal.tsx

@@ -0,0 +1,455 @@
+import {
+  Anchor,
+  Badge,
+  Box,
+  Button,
+  Checkbox,
+  Group,
+  Image,
+  Loader,
+  Modal,
+  Select,
+  Stack,
+  Tabs,
+  Text,
+  TextInput,
+  Tooltip,
+} from "@mantine/core";
+import { notifications } from "@mantine/notifications";
+import {
+  IconAlertTriangle,
+  IconBrandJira,
+  IconChecks,
+  IconDownload,
+  IconRefresh,
+  IconSearch,
+} from "@tabler/icons-react";
+import { useEffect, useMemo, useState } from "react";
+import * as api from "../api";
+import type { JiraIssue } from "../api";
+import type { Column } from "../types";
+
+interface Props {
+  opened: boolean;
+  onClose: () => void;
+  columns: Column[];
+  // Called when imports or reconciles modified the board so the parent can
+  // refetch /api/board.
+  onMutated?: () => void;
+}
+
+// JiraModal is the admin hub for everything Jira-related: importing issues
+// into kanban and verifying the kanban-column ↔ Jira-status mapping is in
+// sync. The previous standalone "Importar de Jira" modal moved here as the
+// "Importar" tab; the new "Comprobar columnas" tab surfaces drift detected
+// by /api/jira/check-columns and offers a one-click fix per row.
+export function JiraModal({ opened, onClose, columns, onMutated }: Props) {
+  const [tab, setTab] = useState<string | null>("import");
+  return (
+    <Modal
+      opened={opened}
+      onClose={onClose}
+      size="xl"
+      title={
+        <Group gap={8}>
+          <IconBrandJira size={18} />
+          <Text fw={600}>Jira</Text>
+        </Group>
+      }
+    >
+      <Tabs value={tab} onChange={setTab} keepMounted={false}>
+        <Tabs.List>
+          <Tabs.Tab value="import" leftSection={<IconDownload size={14} />}>
+            Importar de Jira
+          </Tabs.Tab>
+          <Tabs.Tab value="check" leftSection={<IconChecks size={14} />}>
+            Comprobar columnas
+          </Tabs.Tab>
+        </Tabs.List>
+        <Tabs.Panel value="import" pt="sm">
+          <ImportTab columns={columns} onImported={onMutated} />
+        </Tabs.Panel>
+        <Tabs.Panel value="check" pt="sm">
+          <CheckTab onReconciled={onMutated} />
+        </Tabs.Panel>
+      </Tabs>
+    </Modal>
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Importar de Jira (kept verbatim from the old standalone modal, minus the
+// Modal frame which lives in the parent now).
+// ---------------------------------------------------------------------------
+
+function ImportTab({ columns, onImported }: { columns: Column[]; onImported?: () => void }) {
+  const [issues, setIssues] = useState<JiraIssue[] | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [importing, setImporting] = useState(false);
+  const [selected, setSelected] = useState<Set<string>>(new Set());
+  const [showImported, setShowImported] = useState(false);
+  const [query, setQuery] = useState("");
+  const [fallbackColumn, setFallbackColumn] = useState<string>("");
+  const [boardId, setBoardId] = useState<number | null>(null);
+  const [projectKey, setProjectKey] = useState<string>("");
+  const [error, setError] = useState<string | null>(null);
+
+  const reload = async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const r = await api.listJiraIssues({ includeImported: showImported, limit: 200 });
+      setIssues(r.issues);
+      setBoardId(r.board_id);
+      setProjectKey(r.project_key);
+      setSelected((prev) => {
+        const validKeys = new Set(r.issues.map((i) => i.key));
+        const next = new Set<string>();
+        for (const k of prev) if (validKeys.has(k)) next.add(k);
+        return next;
+      });
+    } catch (e) {
+      setError((e as Error).message);
+      setIssues([]);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    reload();
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [showImported]);
+
+  useEffect(() => {
+    if (!fallbackColumn && columns.length > 0) {
+      const boardCol = columns.find((c) => c.location !== "sidebar") || columns[0];
+      setFallbackColumn(boardCol.id);
+    }
+  }, [columns, fallbackColumn]);
+
+  const visible = useMemo(() => {
+    if (!issues) return [];
+    const q = query.trim().toLowerCase();
+    if (!q) return issues;
+    return issues.filter(
+      (i) =>
+        i.key.toLowerCase().includes(q) ||
+        i.summary.toLowerCase().includes(q) ||
+        i.assignee.toLowerCase().includes(q) ||
+        i.status_name.toLowerCase().includes(q),
+    );
+  }, [issues, query]);
+
+  const toggle = (key: string) => {
+    setSelected((prev) => {
+      const next = new Set(prev);
+      if (next.has(key)) next.delete(key);
+      else next.add(key);
+      return next;
+    });
+  };
+
+  const toggleAll = () => {
+    const importable = visible.filter((i) => !i.already_imported);
+    if (selected.size === importable.length && importable.length > 0) {
+      setSelected(new Set());
+    } else {
+      setSelected(new Set(importable.map((i) => i.key)));
+    }
+  };
+
+  const doImport = async () => {
+    if (selected.size === 0) return;
+    setImporting(true);
+    try {
+      const res = await api.importJiraIssues(Array.from(selected), fallbackColumn || undefined);
+      const ok = res.results.filter((r) => r.status === "imported").length;
+      const skip = res.results.filter((r) => r.status === "skipped").length;
+      const err = res.results.filter((r) => r.status === "error");
+      const msg = `${ok} importadas` + (skip > 0 ? ` · ${skip} omitidas` : "") + (err.length > 0 ? ` · ${err.length} con error` : "");
+      notifications.show({
+        color: err.length > 0 ? "yellow" : "green",
+        message: msg,
+        autoClose: 5000,
+      });
+      if (err.length > 0) console.warn("import errors", err);
+      setSelected(new Set());
+      await reload();
+      onImported?.();
+    } catch (e) {
+      notifications.show({ color: "red", message: (e as Error).message });
+    } finally {
+      setImporting(false);
+    }
+  };
+
+  const columnOptions = columns.map((c) => ({ value: c.id, label: c.name }));
+
+  return (
+    <Stack gap="sm">
+      <Text size="xs" c="dimmed">
+        {boardId ? `Board ${boardId} (${projectKey})` : "Cargando board..."}
+      </Text>
+      <Group gap="xs" wrap="nowrap">
+        <TextInput
+          placeholder="Filtrar por key, titulo, asignado o status..."
+          value={query}
+          onChange={(e) => setQuery(e.currentTarget.value)}
+          leftSection={<IconSearch size={14} />}
+          style={{ flex: 1 }}
+        />
+        <Tooltip label="Refrescar" withArrow>
+          <Button variant="default" onClick={reload} loading={loading} leftSection={<IconRefresh size={14} />}>
+            Refrescar
+          </Button>
+        </Tooltip>
+      </Group>
+      <Group justify="space-between" gap="xs">
+        <Checkbox
+          label="Mostrar issues ya importadas"
+          checked={showImported}
+          onChange={(e) => setShowImported(e.currentTarget.checked)}
+        />
+        <Select
+          label="Columna fallback"
+          description="Para issues cuyo status no tiene mapping"
+          data={columnOptions}
+          value={fallbackColumn}
+          onChange={(v) => setFallbackColumn(v || "")}
+          allowDeselect={false}
+          w={260}
+          size="xs"
+        />
+      </Group>
+
+      {error && <Text size="sm" c="red">{error}</Text>}
+
+      <Box style={{ maxHeight: 440, overflowY: "auto", border: "1px solid var(--mantine-color-default-border)", borderRadius: 4 }}>
+        {loading && !issues ? (
+          <Group justify="center" p="md"><Loader size="sm" /></Group>
+        ) : visible.length === 0 ? (
+          <Text size="sm" c="dimmed" p="md" ta="center">
+            {issues?.length === 0 ? "No hay issues sin importar en el board." : "Ninguna issue coincide con el filtro."}
+          </Text>
+        ) : (
+          <Stack gap={0}>
+            <Group p="xs" gap="xs" style={{ borderBottom: "1px solid var(--mantine-color-default-border)", background: "var(--mantine-color-default-hover)" }}>
+              <Checkbox
+                checked={selected.size > 0 && selected.size === visible.filter((i) => !i.already_imported).length}
+                indeterminate={selected.size > 0 && selected.size < visible.filter((i) => !i.already_imported).length}
+                onChange={toggleAll}
+              />
+              <Text size="xs" fw={600} c="dimmed">{visible.length} issues · {selected.size} seleccionadas</Text>
+            </Group>
+            {visible.map((iss) => (
+              <Group key={iss.key} p="xs" gap="xs" wrap="nowrap" style={{ borderBottom: "1px solid var(--mantine-color-default-border)", opacity: iss.already_imported ? 0.5 : 1 }}>
+                <Checkbox checked={selected.has(iss.key)} disabled={iss.already_imported} onChange={() => toggle(iss.key)} />
+                {iss.issue_type_icon && <Image src={iss.issue_type_icon} w={16} h={16} alt={iss.issue_type} />}
+                <Stack gap={2} style={{ flex: 1, minWidth: 0 }}>
+                  <Group gap={6} wrap="nowrap">
+                    <Anchor href={iss.url} target="_blank" rel="noopener noreferrer" size="sm" fw={600}>{iss.key}</Anchor>
+                    <Text size="sm" truncate style={{ flex: 1 }}>{iss.summary}</Text>
+                  </Group>
+                  <Group gap={4} wrap="nowrap">
+                    <Badge size="xs" variant="light" color={badgeColor(iss.status_name)}>{iss.status_name}</Badge>
+                    <Badge size="xs" variant="outline">{iss.issue_type}</Badge>
+                    {iss.assignee && <Text size="xs" c="dimmed">· {iss.assignee}</Text>}
+                    {iss.already_imported && <Badge size="xs" color="gray">ya en kanban</Badge>}
+                    {!iss.already_imported && !iss.mapped_column_id && <Badge size="xs" color="orange" variant="light">sin mapping (usa fallback)</Badge>}
+                  </Group>
+                </Stack>
+              </Group>
+            ))}
+          </Stack>
+        )}
+      </Box>
+
+      <Group justify="flex-end" gap="xs">
+        <Button onClick={doImport} disabled={selected.size === 0 || importing} loading={importing}>
+          Importar {selected.size > 0 ? `(${selected.size})` : ""}
+        </Button>
+      </Group>
+    </Stack>
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Comprobar columnas: detects drift between kanban column ↔ Jira status.
+// ---------------------------------------------------------------------------
+
+function CheckTab({ onReconciled }: { onReconciled?: () => void }) {
+  const [data, setData] = useState<api.JiraCheckResponse | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [fixing, setFixing] = useState(false);
+  const [selected, setSelected] = useState<Set<string>>(new Set());
+  const [onlyMismatch, setOnlyMismatch] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  const reload = async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const r = await api.checkJiraColumns();
+      setData(r);
+      // After a refresh, drop selections that no longer apply.
+      setSelected((prev) => {
+        const validIds = new Set(r.rows.filter((x) => x.mismatch).map((x) => x.card_id));
+        const next = new Set<string>();
+        for (const id of prev) if (validIds.has(id)) next.add(id);
+        return next;
+      });
+    } catch (e) {
+      setError((e as Error).message);
+      setData(null);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  useEffect(() => {
+    reload();
+  }, []);
+
+  const visible = useMemo(() => {
+    if (!data) return [];
+    return onlyMismatch ? data.rows.filter((r) => r.mismatch) : data.rows;
+  }, [data, onlyMismatch]);
+
+  const toggle = (id: string) => {
+    setSelected((prev) => {
+      const next = new Set(prev);
+      if (next.has(id)) next.delete(id);
+      else next.add(id);
+      return next;
+    });
+  };
+
+  const toggleAll = () => {
+    const fixable = visible.filter((r) => r.mismatch).map((r) => r.card_id);
+    if (selected.size === fixable.length && fixable.length > 0) {
+      setSelected(new Set());
+    } else {
+      setSelected(new Set(fixable));
+    }
+  };
+
+  const doFix = async () => {
+    if (selected.size === 0) return;
+    setFixing(true);
+    try {
+      const res = await api.reconcileJiraColumns(Array.from(selected));
+      const ok = res.results.filter((r) => r.status === "fixed").length;
+      const skip = res.results.filter((r) => r.status === "skipped").length;
+      const err = res.results.filter((r) => r.status === "error");
+      const msg = `${ok} sincronizadas` + (skip > 0 ? ` · ${skip} omitidas` : "") + (err.length > 0 ? ` · ${err.length} con error` : "");
+      notifications.show({
+        color: err.length > 0 ? "yellow" : "green",
+        message: msg,
+        autoClose: 5000,
+      });
+      if (err.length > 0) console.warn("reconcile errors", err);
+      setSelected(new Set());
+      await reload();
+      onReconciled?.();
+    } catch (e) {
+      notifications.show({ color: "red", message: (e as Error).message });
+    } finally {
+      setFixing(false);
+    }
+  };
+
+  return (
+    <Stack gap="sm">
+      <Text size="xs" c="dimmed">
+        Compara la columna kanban de cada card con el status actual de su Jira issue. Lo hace
+        consultando Jira en vivo (1 request por card) — puede tardar varios segundos con
+        muchas cards.
+      </Text>
+      {data && (
+        <Group gap="xs">
+          <Badge color="green" variant="light">{data.in_sync} en sync</Badge>
+          {data.mismatches > 0 && (
+            <Badge color="red" variant="filled" leftSection={<IconAlertTriangle size={12} />}>
+              {data.mismatches} desincronizadas
+            </Badge>
+          )}
+          <Badge color="gray" variant="outline">{data.total} totales</Badge>
+        </Group>
+      )}
+      <Group gap="xs" justify="space-between">
+        <Checkbox
+          label="Solo mostrar desincronizadas"
+          checked={onlyMismatch}
+          onChange={(e) => setOnlyMismatch(e.currentTarget.checked)}
+        />
+        <Button variant="default" onClick={reload} loading={loading} leftSection={<IconRefresh size={14} />}>
+          Re-comprobar
+        </Button>
+      </Group>
+
+      {error && <Text size="sm" c="red">{error}</Text>}
+
+      <Box style={{ maxHeight: 440, overflowY: "auto", border: "1px solid var(--mantine-color-default-border)", borderRadius: 4 }}>
+        {loading && !data ? (
+          <Group justify="center" p="md"><Loader size="sm" /></Group>
+        ) : visible.length === 0 ? (
+          <Text size="sm" c="dimmed" p="md" ta="center">
+            {data && data.mismatches === 0
+              ? "Todas las cards estan en su columna correcta. ✅"
+              : "No hay rows que mostrar con el filtro actual."}
+          </Text>
+        ) : (
+          <Stack gap={0}>
+            <Group p="xs" gap="xs" style={{ borderBottom: "1px solid var(--mantine-color-default-border)", background: "var(--mantine-color-default-hover)" }}>
+              <Checkbox
+                checked={selected.size > 0 && selected.size === visible.filter((r) => r.mismatch).length}
+                indeterminate={selected.size > 0 && selected.size < visible.filter((r) => r.mismatch).length}
+                onChange={toggleAll}
+              />
+              <Text size="xs" fw={600} c="dimmed">
+                {visible.length} rows · {selected.size} seleccionadas para sync
+              </Text>
+            </Group>
+            {visible.map((row) => (
+              <Group key={row.card_id} p="xs" gap="xs" wrap="nowrap" style={{ borderBottom: "1px solid var(--mantine-color-default-border)" }}>
+                <Checkbox checked={selected.has(row.card_id)} disabled={!row.mismatch} onChange={() => toggle(row.card_id)} />
+                <Stack gap={2} style={{ flex: 1, minWidth: 0 }}>
+                  <Group gap={6} wrap="nowrap">
+                    <Anchor href={row.issue_url} target="_blank" rel="noopener noreferrer" size="sm" fw={600}>{row.jira_key}</Anchor>
+                    <Text size="sm" truncate style={{ flex: 1 }}>{row.title}</Text>
+                  </Group>
+                  <Group gap={4} wrap="nowrap">
+                    <Badge size="xs" variant="light" color="blue">kanban: {row.kanban_column_name}</Badge>
+                    <Text size="xs" c="dimmed">→ esperado Jira: <b>{row.expected_jira_status || "(sin mapeo)"}</b></Text>
+                    <Badge size="xs" variant="light" color={row.mismatch ? "red" : "green"}>
+                      jira: {row.jira_status_name}
+                    </Badge>
+                  </Group>
+                </Stack>
+              </Group>
+            ))}
+          </Stack>
+        )}
+      </Box>
+
+      <Group justify="space-between" gap="xs">
+        <Text size="xs" c="dimmed">Fix = transicionar Jira al status que matchea la columna kanban (kanban gana)</Text>
+        <Button color="orange" onClick={doFix} disabled={selected.size === 0 || fixing} loading={fixing}>
+          Sincronizar {selected.size > 0 ? `(${selected.size})` : ""}
+        </Button>
+      </Group>
+    </Stack>
+  );
+}
+
+// ---------------------------------------------------------------------------
+
+function badgeColor(status: string): string {
+  const s = status.toLowerCase();
+  if (s.includes("done") || s.includes("hecho") || s.includes("closed")) return "green";
+  if (s.includes("progress") || s.includes("doing")) return "blue";
+  if (s.includes("implementado") || s.includes("review")) return "violet";
+  if (s.includes("creado") || s.includes("backlog") || s.includes("nuevo")) return "gray";
+  return "yellow";
+}

frontend/src/components/JiraSyncIndicator.tsx

@@ -0,0 +1,178 @@
+import { Anchor, Box, Group, HoverCard, Stack, Text } from "@mantine/core";
+import { IconBrandJira, IconAlertCircle } from "@tabler/icons-react";
+import { CSSProperties, useEffect, useState } from "react";
+import * as api from "../api";
+import type { CardJiraSyncState } from "../api";
+import { formatDateTimeShort } from "./format";
+
+// Adaptive polling: 5s steady-state, 1s while the card is mid-sync. The fast
+// cadence catches the yellow → green transition right after a column drag;
+// the slow cadence keeps the per-card load manageable when the board is idle.
+const POLL_MS_STEADY = 5000;
+const POLL_MS_INFLIGHT = 1000;
+
+type Tone = "gray" | "yellow" | "green" | "red";
+
+function tone(state: CardJiraSyncState): Tone {
+  if (state.inflight) return "yellow";
+  if (state.last_error) return "red";
+  if (state.jira_key) return "green";
+  return "gray";
+}
+
+const TONE_COLOR: Record<Tone, string> = {
+  gray: "var(--mantine-color-gray-5)",
+  yellow: "var(--mantine-color-yellow-5)",
+  green: "var(--mantine-color-green-5)",
+  red: "var(--mantine-color-red-6)",
+};
+
+const TONE_LABEL: Record<Tone, string> = {
+  gray: "Sin sincronizar con Jira",
+  yellow: "Sincronizando...",
+  green: "Sincronizada con Jira",
+  red: "Error de sincronizacion",
+};
+
+interface Props {
+  cardId: string;
+  // Pollen-down so the parent can refresh when needed (e.g. after a move
+  // animation finishes) without waiting for the next tick.
+  refreshTick?: number;
+}
+
+export function JiraSyncIndicator({ cardId, refreshTick }: Props) {
+  const [state, setState] = useState<CardJiraSyncState | null>(null);
+  const [err, setErr] = useState<string | null>(null);
+
+  useEffect(() => {
+    let cancelled = false;
+    let timer: ReturnType<typeof setTimeout> | null = null;
+    const schedule = (ms: number) => {
+      if (cancelled) return;
+      if (timer) clearTimeout(timer);
+      timer = setTimeout(load, ms);
+    };
+    const load = async () => {
+      try {
+        const s = await api.getCardJiraSync(cardId);
+        if (cancelled) return;
+        setState(s);
+        setErr(null);
+        // Adaptive cadence: fast while the dispatcher is actively processing
+        // this card, slow otherwise. Re-arms on every fetch so the moment
+        // inflight flips off we drop back to the steady cadence.
+        schedule(s.inflight ? POLL_MS_INFLIGHT : POLL_MS_STEADY);
+      } catch (e) {
+        if (cancelled) return;
+        setErr((e as Error).message);
+        schedule(POLL_MS_STEADY);
+      }
+    };
+    // Window event fired by the App's drag-end handler so the indicator
+    // refetches immediately after a move (and so the user sees yellow within
+    // ~200ms instead of waiting up to POLL_MS_STEADY).
+    const onMoved = (e: Event) => {
+      const detail = (e as CustomEvent).detail as { cardId?: string } | undefined;
+      if (detail?.cardId === cardId) {
+        schedule(150);
+      }
+    };
+    window.addEventListener("kanban-card-moved", onMoved);
+    load();
+    return () => {
+      cancelled = true;
+      if (timer) clearTimeout(timer);
+      window.removeEventListener("kanban-card-moved", onMoved);
+    };
+  }, [cardId, refreshTick]);
+
+  if (err && !state) {
+    return (
+      <Box title={err} style={dotStyle("var(--mantine-color-gray-3)")} aria-label="Jira sync state unavailable" />
+    );
+  }
+  if (!state) {
+    // Initial render — fade in a placeholder dot so the layout does not shift
+    // when the fetch resolves.
+    return <Box style={dotStyle("var(--mantine-color-gray-2)")} aria-label="Cargando estado Jira" />;
+  }
+  const t = tone(state);
+  return (
+    <HoverCard width={300} shadow="md" openDelay={150} closeDelay={120} withinPortal>
+      <HoverCard.Target>
+        <Box
+          role="status"
+          aria-label={TONE_LABEL[t]}
+          onClick={(e) => e.stopPropagation()}
+          onPointerDown={(e) => e.stopPropagation()}
+          style={dotStyle(TONE_COLOR[t])}
+        />
+      </HoverCard.Target>
+      <HoverCard.Dropdown onClick={(e) => e.stopPropagation()}>
+        <Stack gap={6}>
+          <Group gap={6} wrap="nowrap" justify="space-between">
+            <Group gap={6} wrap="nowrap">
+              <IconBrandJira size={14} />
+              <Text size="sm" fw={600}>{TONE_LABEL[t]}</Text>
+            </Group>
+            {state.issue_url && (
+              <Anchor
+                size="xs"
+                href={state.issue_url}
+                target="_blank"
+                rel="noopener noreferrer"
+                onClick={(e) => e.stopPropagation()}
+              >
+                Abrir en Jira
+              </Anchor>
+            )}
+          </Group>
+          {state.jira_key && (
+            <Text size="xs">
+              <Text component="span" c="dimmed">Issue:</Text>{" "}
+              <Text component="span" fw={600}>{state.jira_key}</Text>
+            </Text>
+          )}
+          {state.last_status && (
+            <Text size="xs">
+              <Text component="span" c="dimmed">Status:</Text>{" "}
+              <Text component="span">{state.last_status}</Text>
+            </Text>
+          )}
+          {state.last_sync_at && (
+            <Text size="xs">
+              <Text component="span" c="dimmed">Ultimo sync:</Text>{" "}
+              <Text component="span">{formatDateTimeShort(state.last_sync_at)}</Text>
+            </Text>
+          )}
+          {state.last_error && (
+            <Group gap={6} wrap="nowrap" align="flex-start">
+              <IconAlertCircle size={14} color="var(--mantine-color-red-6)" />
+              <Text size="xs" c="red" style={{ wordBreak: "break-word" }}>{state.last_error}</Text>
+            </Group>
+          )}
+          {!state.jira_key && (
+            <Text size="xs" c="dimmed">
+              La card todavia no se ha empujado a Jira. Editala o muevela para
+              disparar el sync, o usa la opcion "Importar de Jira" si ya existe
+              alli.
+            </Text>
+          )}
+        </Stack>
+      </HoverCard.Dropdown>
+    </HoverCard>
+  );
+}
+
+function dotStyle(color: string): CSSProperties {
+  return {
+    width: 10,
+    height: 10,
+    borderRadius: "50%",
+    background: color,
+    cursor: "default",
+    boxShadow: "0 0 0 2px var(--mantine-color-body)",
+    transition: "background 120ms ease",
+  };
+}

frontend/src/components/KanbanCard.tsx

@@ -38,6 +38,7 @@ import type { Card, CardColor, User } from "../types";
 import { colorBg, colorBorder, tagColor } from "./colors";
 import { ColorPickerGrid } from "./ColorPickerGrid";
 import { formatDateTimeShort, formatDuration } from "./format";
+import { JiraSyncIndicator } from "./JiraSyncIndicator";
 
 interface Props {
   card: Card;
@@ -358,16 +359,19 @@ const KanbanCardBody = memo(function KanbanCardBody({
               {card.title}
             </Text>
           </Group>
-          <Menu opened={menuOpen} onChange={setMenuOpen} position="bottom-end" shadow="md" withArrow>
-            <Menu.Target>
-              <ActionIcon variant="subtle" color="gray" size="sm" aria-label="Acciones" style={{ flexShrink: 0 }} onPointerDown={(e) => e.stopPropagation()}>
-                <IconDotsVertical size={14} />
-              </ActionIcon>
-            </Menu.Target>
-            <Menu.Dropdown onDoubleClick={(e) => e.stopPropagation()} onClick={(e) => e.stopPropagation()} onMouseDown={(e) => e.stopPropagation()} onContextMenu={(e) => e.stopPropagation()}>
-              {menuItems}
-            </Menu.Dropdown>
-          </Menu>
+          <Stack gap={4} align="center" style={{ flexShrink: 0 }}>
+            <Menu opened={menuOpen} onChange={setMenuOpen} position="bottom-end" shadow="md" withArrow>
+              <Menu.Target>
+                <ActionIcon variant="subtle" color="gray" size="sm" aria-label="Acciones" onPointerDown={(e) => e.stopPropagation()}>
+                  <IconDotsVertical size={14} />
+                </ActionIcon>
+              </Menu.Target>
+              <Menu.Dropdown onDoubleClick={(e) => e.stopPropagation()} onClick={(e) => e.stopPropagation()} onMouseDown={(e) => e.stopPropagation()} onContextMenu={(e) => e.stopPropagation()}>
+                {menuItems}
+              </Menu.Dropdown>
+            </Menu>
+            <JiraSyncIndicator cardId={card.id} />
+          </Stack>
         </Group>
         {(card.requester || assignee) && (
           <Group gap={6} wrap="nowrap" style={{ minWidth: 0 }}>

frontend/src/components/LoginPage.tsx

@@ -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>

frontend/src/components/MCPTokensModal.tsx

@@ -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>
+  );
+}

frontend/src/components/ModulesModal.tsx

@@ -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>
+  );
+}

frontend/src/components/NotificationsBell.tsx

@@ -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>
+  );
+}

frontend/src/hooks/useEventStream.ts

@@ -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]);
+}

frontend/src/types.ts

@@ -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;
+}

frontend/vite.config.ts

@@ -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: {

run.sh

@@ -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=$!