feat(api-keys): scopes for triage, tasks and list items (FLAW-07)

Keys get scopes when created (webhook:triage, webhook:task,
webhook:list; default triage, old keys become triage). The webhook
ingest learns target task (optional task list) and list_item (needs a
list the owner may write to); /inbox checks the scope of its target as
well; a missing scope answers 403. Keys can no longer open live streams,
which carried all of the owner's events.

The visible key UI lived in the account settings while EcosystemView
was never rendered; it is replaced by ApiKeysPanel in the settings with
scope chips, scope badges per key and a simulator for all three
targets. Examples send the key as X-API-Key header, not in the URL.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

internal/api/handlers_integrations.go

@@ -1,7 +1,9 @@
 package api
 
 import (
+	"context"
 	"encoding/json"
+	"errors"
 	"fmt"
 	"io"
 	"net/http"
@@ -9,6 +11,7 @@ import (
 
 	"github.com/go-chi/chi/v5"
 	"github.com/sandrodach/mindsift/internal/auth"
+	"github.com/sandrodach/mindsift/internal/storage"
 )
 
 // --- API KEYS & WEBHOOK INGESTION ---
@@ -26,11 +29,12 @@ func (s *Server) handleGetAPIKeys(w http.ResponseWriter, r *http.Request) {
 func (s *Server) handleCreateAPIKey(w http.ResponseWriter, r *http.Request) {
 	userID := auth.GetUserID(r.Context())
 	var req struct {
-		Name string `json:"name"`
+		Name   string   `json:"name"`
+		Scopes []string `json:"scopes"`
 	}
 	_ = json.NewDecoder(r.Body).Decode(&req)
 
-	key, err := s.store.CreateAPIKey(userID, req.Name)
+	key, err := s.store.CreateAPIKey(userID, req.Name, req.Scopes)
 	if err != nil {
 		writeError(w, http.StatusInternalServerError, err.Error())
 		return
@@ -59,11 +63,14 @@ func (s *Server) handleWebhookIngest(w http.ResponseWriter, r *http.Request) {
 	}
 
 	// Same checks as every other request (revoked/outdated sessions, inactive accounts)
-	user, _ := s.authenticateToken(token)
+	user, keyScopes := s.authenticateToken(token)
 	if user == nil {
 		writeError(w, http.StatusUnauthorized, "Ungültiger Webhook-Token oder API-Key")
 		return
 	}
+	if keyScopes != nil {
+		r = r.WithContext(context.WithValue(r.Context(), apiKeyScopesKey{}, keyScopes))
+	}
 
 	var req struct {
 		Title    string   `json:"title"`
@@ -75,6 +82,13 @@ func (s *Server) handleWebhookIngest(w http.ResponseWriter, r *http.Request) {
 		Tags     []string `json:"tags"`
 		DueDate  string   `json:"dueDate"`
 		DueDate2 string   `json:"due_date"`
+		// Where it goes: "triage" (default, inbox), "task" or "list_item"; "type" is accepted as well
+		Target     string `json:"target"`
+		Type       string `json:"type"`
+		TaskListID string `json:"taskListId"`
+		ListID     string `json:"listId"`
+		Category   string `json:"category"`
+		Quantity   string `json:"quantity"`
 	}
 
 	bodyBytes, _ := io.ReadAll(r.Body)
@@ -120,8 +134,20 @@ func (s *Server) handleWebhookIngest(w http.ResponseWriter, r *http.Request) {
 		}
 	}
 
-	if req.Priority == "" {
-		req.Priority = "high"
+	target := strings.ToLower(strings.TrimSpace(req.Target))
+	if target == "" {
+		target = strings.ToLower(strings.TrimSpace(req.Type))
+	}
+	switch target {
+	case "", "triage", "inbox":
+		target = "triage"
+	case "task", "list_item":
+	default:
+		writeError(w, http.StatusBadRequest, "Unbekanntes Ziel – erlaubt: triage, task, list_item")
+		return
+	}
+	if !requireDeliveryScope(w, r, target) {
+		return
 	}
 
 	source := strings.ToLower(strings.TrimSpace(req.Source))
@@ -129,6 +155,18 @@ func (s *Server) handleWebhookIngest(w http.ResponseWriter, r *http.Request) {
 		source = "webhook"
 	}
 
+	if target == "list_item" {
+		s.ingestListItem(w, user.ID, req.ListID, bodyText, req.Category, req.Quantity)
+		return
+	}
+	if target == "task" {
+		s.ingestTask(w, user.ID, bodyText, req.Priority, source, dueDate, req.TaskListID)
+		return
+	}
+
+	if req.Priority == "" {
+		req.Priority = "high"
+	}
 	thought, err := s.store.CreateThought(user.ID, bodyText, req.Priority, source, dueDate)
 	if err != nil {
 		writeError(w, http.StatusInternalServerError, err.Error())
@@ -142,3 +180,50 @@ func (s *Server) handleWebhookIngest(w http.ResponseWriter, r *http.Request) {
 		"thought": thought,
 	})
 }
+
+// ingestTask creates a task directly (scope webhook:task), optionally in a task list the owner of
+// the key may write to.
+func (s *Server) ingestTask(w http.ResponseWriter, userID, content, priority, source, dueDate, taskListID string) {
+	if priority == "" {
+		priority = "normal"
+	}
+	if taskListID != "" && !s.store.CanEditTaskList(userID, taskListID) {
+		writeError(w, http.StatusForbidden, storage.ErrTaskListReadOnly.Error())
+		return
+	}
+	thought, err := s.store.CreateThoughtWithDetails(userID, content, priority, source, dueDate, taskListID, "todo", "")
+	if err != nil {
+		writeStoreError(w, http.StatusBadRequest, err)
+		return
+	}
+	task, err := s.store.UpdateThoughtTriage(userID, thought.ID, "keep", "task", "", dueDate, taskListID)
+	if err != nil {
+		writeStoreError(w, http.StatusBadRequest, err)
+		return
+	}
+	s.wsHub.BroadcastToUsers(s.taskAudience(task), "TASK_CREATED", task)
+	writeJSON(w, http.StatusCreated, map[string]interface{}{"status": "ingested", "task": task})
+}
+
+// ingestListItem adds an item to a list (scope webhook:list) the owner of the key may write to.
+func (s *Server) ingestListItem(w http.ResponseWriter, userID, listID, content, category, quantity string) {
+	if strings.TrimSpace(listID) == "" {
+		writeError(w, http.StatusBadRequest, "Feld 'listId' ist für Listeneinträge erforderlich")
+		return
+	}
+	if err := s.store.EnsureListItemsWritable(userID, listID, ""); err != nil {
+		status := http.StatusNotFound
+		if errors.Is(err, storage.ErrListReadOnly) {
+			status = http.StatusForbidden
+		}
+		writeError(w, status, err.Error())
+		return
+	}
+	item, err := s.store.CreateListItem(listID, content, category, quantity, 0, userID)
+	if err != nil {
+		writeError(w, http.StatusBadRequest, err.Error())
+		return
+	}
+	s.wsHub.BroadcastListEvent(listID, "ITEM_CREATED", item)
+	writeJSON(w, http.StatusCreated, map[string]interface{}{"status": "ingested", "item": item})
+}