Files
geniusrun/docs/superpowers/plans/2026-07-26-profile-deletion.md
Christophe Vila 0e6cf00dba refactor(config): mandatory app-config rows seeded in DB; rename to session.setup_timeout
All registry keys must exist as rows in the config table: main seeds
missing keys with their defaults at startup, LoadApp fails fast on a
missing key, and the code-side fallback const/helper for the onboarding
setup timeout is gone -- the value rides in SessionConfig.SetupTimeout.
The key is renamed session.idle_timeout -> session.setup_timeout, and
the /config page's 'overridden' now means 'differs from the default'.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-04 18:17:24 +02:00

28 KiB

Profile Deletion Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Let a signed-in geniusrun user permanently delete their entire account (Garmin credentials, custom rules, every synced activity) from a "Danger zone" button on the Profile page, and log them out afterward.

Architecture: Add ON DELETE CASCADE to every FK pointing at users(id) (and workout_kinds(id)) in schema.sql, so a single DELETE FROM users removes everything. Wrap that in a new store.DeleteUser, expose it via DELETE /api/profile, and have that handler also tear down the deleted user's cached Garmin subprocess/client and on-disk token-store directory. The frontend gates the call behind a type-DELETE-to-confirm UI, then performs a real POST navigation to the existing /api/session/logout route (the same one the header's Log out button already uses) so the OIDC session ends too.

Tech Stack: Go (net/http, database/sql via modernc.org/sqlite, chi router), React + TypeScript (Vite), no frontend test framework.

Global Constraints

  • internal/store/schema.sql is edited directly, never migrated — this is a pre-production app (see CLAUDE.md).
  • Every store/API method that touches per-user data takes an explicit userID and must filter/scope by it — the entire cross-user isolation boundary depends on this (see CLAUDE.md's Authentication section).
  • Cross-user isolation must be tested adversarially (two real users, real IDs), not just checked for non-collision — matches internal/store/isolation_test.go / internal/api/isolation_test.go convention.
  • After any schema.sql change, regenerate docs/DATABASE.md via go run ./cmd/dumpschema (run from backend/).
  • gofmt -l . must report nothing before committing; go vet ./... and go build ./... must pass.
  • No frontend test suite exists — frontend changes are verified via npm run build, npm run lint, and a manual browser check.

Task 1: Cascading deletes in the store layer

Files:

  • Modify: backend/internal/store/schema.sql:29,85,103,121,222,232
  • Modify: backend/internal/store/users.go (add DeleteUser)
  • Modify: backend/internal/store/users_test.go (add TestDeleteUser_RemovesUserAndCascadesEverything)
  • Modify: backend/internal/store/isolation_test.go (add TestIsolation_DeleteUserLeavesOtherUsersDataIntact)
  • Modify: docs/DATABASE.md (regenerated, not hand-edited)

Interfaces:

  • Produces: func (db *DB) DeleteUser(ctx context.Context, userID int64) error — deletes the users row for userID; every owned row (profile, workout_kinds, workout_type_paces, activities, laps, activity_samples, kind_assignments, sync_state, sync_runs) cascades away via the schema FKs added in this task.

  • Step 1: Write the failing test

Add to backend/internal/store/users_test.go:

func TestDeleteUser_RemovesUserAndCascadesEverything(t *testing.T) {
	db := openTestDB(t)
	ctx := context.Background()

	userID, err := db.ProvisionUser(ctx, "delete-me", "Delete Me")
	if err != nil {
		t.Fatalf("ProvisionUser: %v", err)
	}

	activityID, err := db.UpsertActivity(ctx, userID, Activity{GarminActivityID: 1, StartTimeUTC: "2026-07-11 06:00:00", RawJSON: "{}"})
	if err != nil {
		t.Fatalf("UpsertActivity: %v", err)
	}
	kindID, err := db.CreateWorkoutKind(ctx, userID, WorkoutKind{Name: "Test Delete Kind", RuleJSON: `{"match":"all","conditions":[]}`, IsActive: true})
	if err != nil {
		t.Fatalf("CreateWorkoutKind: %v", err)
	}
	if err := db.ReplaceLaps(ctx, userID, activityID, []Lap{{LapIndex: 1}}); err != nil {
		t.Fatalf("ReplaceLaps: %v", err)
	}
	if err := db.ReplaceActivitySamples(ctx, userID, activityID, []Sample{{ElapsedSeconds: 0}}); err != nil {
		t.Fatalf("ReplaceActivitySamples: %v", err)
	}
	if _, err := db.InsertKindAssignment(ctx, userID, KindAssignment{
		ActivityID: activityID, WorkoutKindID: &kindID, AssignmentSource: AssignmentSourceRuleEngine,
		Status: AssignmentStatusAssigned, CandidateKindsJSON: "[]",
	}); err != nil {
		t.Fatalf("InsertKindAssignment: %v", err)
	}
	minPace := 300.0
	if err := db.UpdateWorkoutTypePace(ctx, userID, WorkoutTypePace{WorkoutKindID: kindID, PaceMinSecPerKm: &minPace}); err != nil {
		t.Fatalf("UpdateWorkoutTypePace: %v", err)
	}
	if err := db.UpdateSyncState(ctx, userID, "2020-01-01", true); err != nil {
		t.Fatalf("UpdateSyncState: %v", err)
	}
	if _, err := db.StartSyncRun(ctx, userID, SyncKindBackfill); err != nil {
		t.Fatalf("StartSyncRun: %v", err)
	}

	if err := db.DeleteUser(ctx, userID); err != nil {
		t.Fatalf("DeleteUser: %v", err)
	}

	if _, found, err := db.GetUserBySub(ctx, "delete-me"); err != nil || found {
		t.Fatalf("expected user gone after DeleteUser, found=%v err=%v", found, err)
	}

	checks := []struct {
		query string
		arg   int64
	}{
		{`SELECT COUNT(*) FROM profile WHERE user_id = ?`, userID},
		{`SELECT COUNT(*) FROM workout_kinds WHERE user_id = ?`, userID},
		{`SELECT COUNT(*) FROM workout_type_paces WHERE workout_kind_id = ?`, kindID},
		{`SELECT COUNT(*) FROM activities WHERE user_id = ?`, userID},
		{`SELECT COUNT(*) FROM laps WHERE activity_id = ?`, activityID},
		{`SELECT COUNT(*) FROM activity_samples WHERE activity_id = ?`, activityID},
		{`SELECT COUNT(*) FROM kind_assignments WHERE activity_id = ?`, activityID},
		{`SELECT COUNT(*) FROM sync_state WHERE user_id = ?`, userID},
		{`SELECT COUNT(*) FROM sync_runs WHERE user_id = ?`, userID},
	}
	for _, c := range checks {
		var count int
		if err := db.QueryRowContext(ctx, c.query, c.arg).Scan(&count); err != nil {
			t.Fatalf("count query %q: %v", c.query, err)
		}
		if count != 0 {
			t.Errorf("query %q: got %d rows, want 0 after DeleteUser", c.query, count)
		}
	}
}

Add to backend/internal/store/isolation_test.go:

// TestIsolation_DeleteUserLeavesOtherUsersDataIntact confirms deleting one
// user's account never touches another user's profile, taxonomy, or
// activities, even though DeleteUser is a single blunt DELETE FROM users.
func TestIsolation_DeleteUserLeavesOtherUsersDataIntact(t *testing.T) {
	db := openTestDB(t)
	ctx := context.Background()

	userA, err := db.ProvisionUser(ctx, "sub-a", "A")
	if err != nil {
		t.Fatalf("ProvisionUser(a): %v", err)
	}
	userB, err := db.ProvisionUser(ctx, "sub-b", "B")
	if err != nil {
		t.Fatalf("ProvisionUser(b): %v", err)
	}
	if _, err := db.UpsertActivity(ctx, userB, Activity{GarminActivityID: 1, StartTimeUTC: "2026-07-11 06:00:00", RawJSON: "{}"}); err != nil {
		t.Fatalf("UpsertActivity(b): %v", err)
	}

	if err := db.DeleteUser(ctx, userA); err != nil {
		t.Fatalf("DeleteUser(a): %v", err)
	}

	if _, found, err := db.GetUserBySub(ctx, "sub-b"); err != nil || !found {
		t.Fatalf("expected userB to survive userA's deletion, found=%v err=%v", found, err)
	}
	profileB, err := db.GetProfile(ctx, userB)
	if err != nil {
		t.Fatalf("GetProfile(b) after deleting a: %v", err)
	}
	if profileB.Name != "B" {
		t.Errorf("userB's profile changed after deleting userA: %+v", profileB)
	}
	kindsB, err := db.ListWorkoutKinds(ctx, userB, false)
	if err != nil || len(kindsB) != 8 {
		t.Fatalf("userB's taxonomy affected by deleting userA: len=%d err=%v", len(kindsB), err)
	}
	activitiesB, err := db.ListActivities(ctx, userB, ActivityFilter{})
	if err != nil || len(activitiesB) != 1 {
		t.Fatalf("userB's activities affected by deleting userA: len=%d err=%v", len(activitiesB), err)
	}
}
  • Step 2: Run tests to verify they fail

Run: cd backend && go test ./internal/store/... -run 'TestDeleteUser|TestIsolation_DeleteUser' -v Expected: FAIL — db.DeleteUser undefined (type *DB has no field or method DeleteUser).

  • Step 3: Add ON DELETE CASCADE to schema.sql

In backend/internal/store/schema.sql, change these six lines (each currently ends REFERENCES users(id), or REFERENCES workout_kinds(id),):

Line 29 (profile.user_id), from:

    user_id             INTEGER NOT NULL REFERENCES users(id),

to:

    user_id             INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,

Line 85 (workout_kinds.user_id), from:

    user_id     INTEGER NOT NULL REFERENCES users(id),

to:

    user_id     INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,

Line 103 (workout_type_paces.workout_kind_id), from:

    workout_kind_id     INTEGER PRIMARY KEY REFERENCES workout_kinds(id),

to:

    workout_kind_id     INTEGER PRIMARY KEY REFERENCES workout_kinds(id) ON DELETE CASCADE,

Line 121 (activities.user_id), from:

    user_id                    INTEGER NOT NULL REFERENCES users(id),

to:

    user_id                    INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,

Line 222 (sync_state.user_id), from:

    user_id              INTEGER NOT NULL REFERENCES users(id),

to:

    user_id              INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,

Line 232 (sync_runs.user_id), from:

    user_id            INTEGER NOT NULL REFERENCES users(id),

to:

    user_id            INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,

laps/activity_samples/kind_assignments already cascade off activities(id) — no change needed there. SQLite's foreign_keys pragma is already on for every connection (db.go), so these cascades (including the two-level users → workout_kinds → workout_type_paces chain) take effect immediately, no code change required for the pragma itself.

  • Step 4: Add DeleteUser to backend/internal/store/users.go

Append after ProvisionUser (end of file):


// DeleteUser permanently deletes userID's account. Every row that belongs
// to it -- profile, workout kinds (and their paces), activities (and their
// laps/samples/kind_assignments), sync_state, and sync_runs -- cascades
// away via the ON DELETE CASCADE foreign keys in schema.sql, so this is a
// single statement rather than per-table deletes. Irreversible; the API
// layer gates this behind a UI confirmation (see
// docs/superpowers/specs/2026-07-26-profile-deletion-design.md).
func (db *DB) DeleteUser(ctx context.Context, userID int64) error {
	if _, err := db.ExecContext(ctx, `DELETE FROM users WHERE id = ?`, userID); err != nil {
		return fmt.Errorf("delete user %d: %w", userID, err)
	}
	return nil
}
  • Step 5: Run tests to verify they pass

Run: cd backend && go test ./internal/store/... -run 'TestDeleteUser|TestIsolation_DeleteUser' -v Expected: PASS.

  • Step 6: Run the full store test suite

Run: cd backend && go test ./internal/store/... Expected: PASS (confirms the new ON DELETE CASCADE clauses didn't break ResetAllSyncedData or any other existing behavior).

  • Step 7: Regenerate docs/DATABASE.md

Run: cd backend && go run ./cmd/dumpschema Expected: docs/DATABASE.md updates to show ON DELETE CASCADE on the six changed columns.

  • Step 8: Commit
git add backend/internal/store/schema.sql backend/internal/store/users.go backend/internal/store/users_test.go backend/internal/store/isolation_test.go docs/DATABASE.md
git commit -m "feat(store): add DeleteUser with cascading account deletion"

Task 2: DELETE /api/profile and Garmin client/tokenstore teardown

Files:

  • Modify: backend/internal/api/server.go:5-21 (imports), :95-117 (new removeUserClient after syncFor), :167-170 (route)
  • Modify: backend/internal/api/profile.go (add handleDeleteProfile)
  • Modify: backend/internal/api/api_test.go (imports + 3 new tests)
  • Modify: backend/internal/api/isolation_test.go (1 new test)

Interfaces:

  • Consumes: store.DB.DeleteUser(ctx, userID) error (Task 1); garmin.Client.Close() error and .UpdateCredentials (existing); Server.userGarmin/userSync/userAuthStatus/userAuthMessage/userSyncRunning map[int64]... and Server.mu sync.Mutex (existing fields); Server.GarminBase garmin.Config (existing, has .TokenStorePath string).

  • Produces: func (s *Server) removeGarminClient(userID int64) — used only within this task's handler, not exported further. DELETE /api/profile route → handleDeleteProfile, responding 204 on success, 409 if a sync is running for that user.

  • Step 1: Write the failing tests

Add "os" to backend/internal/api/api_test.go's import block (needed for Step 1's token-store test):

import (
	"bytes"
	"context"
	"encoding/json"
	"fmt"
	"net/http"
	"net/http/httptest"
	"net/url"
	"os"
	"path/filepath"
	"strconv"
	"testing"
	"time"

	"geniusrun/backend/internal/auth"
	authmock "geniusrun/backend/internal/auth/mock"
	"geniusrun/backend/internal/garmin"
	"geniusrun/backend/internal/garmin/mock"
	"geniusrun/backend/internal/store"
	appsync "geniusrun/backend/internal/sync"
)

Append to backend/internal/api/api_test.go:

func TestDeleteProfile_DeletesUserAndTerminatesGarminClient(t *testing.T) {
	s, db, userID := newTestServer(t)
	router := s.Router()

	// Force the per-user Garmin client to be built and cached.
	rec := doJSON(t, router, http.MethodPost, "/api/auth/login", nil)
	if rec.Code != http.StatusOK {
		t.Fatalf("auth/login status = %d, body = %s", rec.Code, rec.Body.String())
	}
	client, err := s.garminFor(context.Background(), userID)
	if err != nil {
		t.Fatalf("garminFor: %v", err)
	}
	mockClient, ok := client.(*mock.Client)
	if !ok {
		t.Fatalf("expected *mock.Client, got %T", client)
	}

	rec = doJSON(t, router, http.MethodDelete, "/api/profile", nil)
	if rec.Code != http.StatusNoContent {
		t.Fatalf("delete status = %d, body = %s", rec.Code, rec.Body.String())
	}

	if _, found, err := db.GetUserBySub(context.Background(), "test-user"); err != nil || found {
		t.Fatalf("expected user gone after delete, found=%v err=%v", found, err)
	}
	if !mockClient.ClosedCalled {
		t.Error("expected the cached garmin client to be Close()d on profile deletion")
	}
}

func TestDeleteProfile_RejectsWhileSyncInProgress(t *testing.T) {
	s, db, userID := newTestServer(t)
	s.mu.Lock()
	s.userSyncRunning[userID] = true
	s.mu.Unlock()

	rec := doJSON(t, s.Router(), http.MethodDelete, "/api/profile", nil)
	if rec.Code != http.StatusConflict {
		t.Fatalf("status = %d, want 409, body = %s", rec.Code, rec.Body.String())
	}
	if _, found, err := db.GetUserBySub(context.Background(), "test-user"); err != nil || !found {
		t.Fatalf("expected user to survive a rejected delete, found=%v err=%v", found, err)
	}
}

func TestDeleteProfile_RemovesTokenStoreDirectory(t *testing.T) {
	db, err := store.Open(filepath.Join(t.TempDir(), "geniusrun_test.db"))
	if err != nil {
		t.Fatalf("store.Open: %v", err)
	}
	t.Cleanup(func() { db.Close() })
	userID, err := db.ProvisionUser(context.Background(), "test-user", "Test User")
	if err != nil {
		t.Fatalf("ProvisionUser: %v", err)
	}

	tokenStoreRoot := t.TempDir()
	userTokenDir := filepath.Join(tokenStoreRoot, strconv.FormatInt(userID, 10))
	if err := os.MkdirAll(userTokenDir, 0o755); err != nil {
		t.Fatalf("MkdirAll: %v", err)
	}
	if err := os.WriteFile(filepath.Join(userTokenDir, "session.json"), []byte("{}"), 0o644); err != nil {
		t.Fatalf("WriteFile: %v", err)
	}

	m := &mock.Client{}
	garminFactory := func(garmin.Config) garmin.Client { return m }
	s := NewServer(db, garminFactory, garmin.Config{TokenStorePath: tokenStoreRoot}, appsync.Config{}, &authmock.Verifier{}, testSessionConfig)

	rec := doJSON(t, s.Router(), http.MethodDelete, "/api/profile", nil)
	if rec.Code != http.StatusNoContent {
		t.Fatalf("delete status = %d, body = %s", rec.Code, rec.Body.String())
	}
	if _, err := os.Stat(userTokenDir); !os.IsNotExist(err) {
		t.Fatalf("expected token store dir %q to be removed, stat err = %v", userTokenDir, err)
	}
}

Append to backend/internal/api/isolation_test.go:

// TestIsolation_DeleteProfileOnlyDeletesOwnAccount confirms one user
// deleting their own profile never touches another user's account, even
// though DeleteUser is keyed purely by the session-resolved userID.
func TestIsolation_DeleteProfileOnlyDeletesOwnAccount(t *testing.T) {
	s, db, userA := newTestServer(t) // provisions "test-user" (userA)
	if _, err := db.ProvisionUser(newCtx(), "user-b", "B"); err != nil {
		t.Fatalf("ProvisionUser(b): %v", err)
	}

	router := s.Router()
	rec := doJSONAs(t, router, "user-b", http.MethodDelete, "/api/profile", nil)
	if rec.Code != http.StatusNoContent {
		t.Fatalf("userB delete status = %d, body = %s", rec.Code, rec.Body.String())
	}

	if _, found, err := db.GetUserBySub(newCtx(), "user-b"); err != nil || found {
		t.Fatalf("expected userB gone after their own delete, found=%v err=%v", found, err)
	}
	u, found, err := db.GetUserBySub(newCtx(), "test-user")
	if err != nil || !found || u.ID != userA {
		t.Fatalf("expected userA to survive userB's deletion, found=%v err=%v id=%d want=%d", found, err, u.ID, userA)
	}
	rec = doJSON(t, router, http.MethodGet, "/api/profile", nil) // as userA
	if rec.Code != http.StatusOK {
		t.Fatalf("userA profile status after userB deleted themselves = %d, body = %s", rec.Code, rec.Body.String())
	}
}
  • Step 2: Run tests to verify they fail

Run: cd backend && go test ./internal/api/... -run 'TestDeleteProfile|TestIsolation_DeleteProfile' -v Expected: FAIL — 404s (no DELETE /api/profile route registered yet).

  • Step 3: Add the os import and removeUserClient to server.go

Change the import block (add "os" between "net/http" and "path/filepath"):

import (
	"context"
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"os"
	"path/filepath"
	"strconv"
	"sync"

	"github.com/go-chi/chi/v5"

	"geniusrun/backend/internal/auth"
	"geniusrun/backend/internal/garmin"
	"geniusrun/backend/internal/store"
	appsync "geniusrun/backend/internal/sync"
)

Insert this new method right after syncFor (i.e. between the existing syncFor closing brace and the RunIncrementalSyncForAllUsers doc comment):


// removeGarminClient drops userID's cached garmin.Client/sync.Service (if
// any) and every other per-user in-memory entry for userID, terminating the
// client's subprocess and best-effort removing its on-disk token-store
// directory. Called when a user's account has just been deleted from the
// DB, so nothing in memory keeps referencing a userID that no longer
// exists.
func (s *Server) removeGarminClient(userID int64) {
	s.mu.Lock()
	client, ok := s.userGarmin[userID]
	delete(s.userGarmin, userID)
	delete(s.userSync, userID)
	delete(s.userAuthStatus, userID)
	delete(s.userAuthMessage, userID)
	delete(s.userSyncRunning, userID)
	s.mu.Unlock()

	if ok {
		if err := client.Close(); err != nil {
			log.Printf("api: close garmin client for deleted user %d: %v", userID, err)
		}
	}
	if s.GarminBase.TokenStorePath == "" {
		return
	}
	tokenStoreDir := filepath.Join(s.GarminBase.TokenStorePath, strconv.FormatInt(userID, 10))
	if err := os.RemoveAll(tokenStoreDir); err != nil {
		log.Printf("api: remove token store dir for deleted user %d: %v", userID, err)
	}
}
  • Step 4: Register the route in Router()

In server.go, change:

				r.Route("/profile", func(r chi.Router) {
					r.Get("/", s.handleGetProfile)
					r.Put("/", s.handleUpdateProfile)
				})

to:

				r.Route("/profile", func(r chi.Router) {
					r.Get("/", s.handleGetProfile)
					r.Put("/", s.handleUpdateProfile)
					r.Delete("/", s.handleDeleteProfile)
				})
  • Step 5: Add handleDeleteProfile to profiles.go

Append to backend/internal/api/profile.go:


// handleDeleteProfile permanently deletes the signed-in user's entire
// geniusrun account (profile, workout kinds/paces, activities and
// everything under them, sync state/runs -- see schema.sql's ON DELETE
// CASCADE from users(id)) and tears down their cached Garmin client and
// token-store directory. It does not touch the session cookie itself --
// the frontend follows a successful call with a real logout navigation
// (see docs/superpowers/specs/2026-07-26-profile-deletion-design.md).
func (s *Server) handleDeleteProfile(w http.ResponseWriter, r *http.Request) {
	userID := userIDFromContext(r.Context())

	s.mu.Lock()
	inProgress := s.userSyncRunning[userID]
	s.mu.Unlock()
	if inProgress {
		writeError(w, http.StatusConflict, "a sync is in progress for this account; wait for it to finish before deleting your profile")
		return
	}

	if err := s.DB.DeleteUser(r.Context(), userID); err != nil {
		writeError(w, http.StatusInternalServerError, err.Error())
		return
	}
	s.removeGarminClient(userID)
	w.WriteHeader(http.StatusNoContent)
}
  • Step 6: Run tests to verify they pass

Run: cd backend && go test ./internal/api/... -run 'TestDeleteProfile|TestIsolation_DeleteProfile' -v Expected: PASS.

  • Step 7: Run the full backend test suite

Run: cd backend && go build ./... && go vet ./... && gofmt -l . && go test ./... Expected: gofmt -l . prints nothing; go build/go vet/go test all succeed.

  • Step 8: Commit
git add backend/internal/api/server.go backend/internal/api/profiles.go backend/internal/api/api_test.go backend/internal/api/isolation_test.go
git commit -m "feat(api): add DELETE /api/profile with Garmin client/tokenstore teardown"

Task 3: Frontend Danger zone UI

Files:

  • Modify: frontend/src/api/client.ts (add deleteProfile)
  • Modify: frontend/src/pages/Profile.tsx (add Danger zone fieldset + confirm flow)
  • Modify: frontend/src/App.css (small .danger-zone-confirm rule)

Interfaces:

  • Consumes: DELETE /api/profile (Task 2, returns 204 or throws via the existing request() helper's non-2xx handling); BASE_URL (already exported from client.ts).

  • Produces: api.deleteProfile(): Promise<void>, used only from Profile.tsx.

  • Step 1: Add deleteProfile to the API client

In frontend/src/api/client.ts, in the // Profile section, change:

  // Profile
  getProfile: () => request<Profile>("/api/profile"),
  updateProfile: (profile: Profile) =>
    request<Profile>("/api/profile", { method: "PUT", body: JSON.stringify(profile) }),

to:

  // Profile
  getProfile: () => request<Profile>("/api/profile"),
  updateProfile: (profile: Profile) =>
    request<Profile>("/api/profile", { method: "PUT", body: JSON.stringify(profile) }),
  // Permanently deletes the signed-in user's entire account. The caller is
  // responsible for following a successful call with a real logout
  // navigation -- this does not touch the session cookie (see Profile.tsx).
  deleteProfile: () => request<void>("/api/profile", { method: "DELETE" }),
  • Step 2: Add the Danger zone section to Profile.tsx

Change the import line:

import { api } from "../api/client";

to:

import { api, BASE_URL } from "../api/client";

Add these three state variables inside Profile, right after the existing saveTimeoutRef declaration:

  const [deleteConfirmOpen, setDeleteConfirmOpen] = useState(false);
  const [deleteConfirmText, setDeleteConfirmText] = useState("");
  const [deleting, setDeleting] = useState(false);

Add this function right after flushPendingSave:

  async function deleteAccount() {
    setDeleting(true);
    setError(null);
    try {
      await api.deleteProfile();
      // Deletion doesn't clear the session cookie -- follow with a real
      // logout navigation (must be a POST, same as the header's Log out
      // button in App.tsx) so Keycloak's own SSO session ends too, not just
      // geniusrun's local one.
      const form = document.createElement("form");
      form.method = "post";
      form.action = `${BASE_URL}/api/session/logout`;
      document.body.appendChild(form);
      form.submit();
    } catch (e) {
      setError(String(e));
      setDeleting(false);
    }
  }

Add this fieldset right after <TrainingTypesCard /> (still inside the closing </div> of .profile-page):

      <fieldset className="kind-editor danger-zone">
        <legend>Danger zone</legend>
        {!deleteConfirmOpen ? (
          <button type="button" className="button-danger" onClick={() => setDeleteConfirmOpen(true)}>
            Delete profile
          </button>
        ) : (
          <div className="danger-zone-confirm">
            <p>
              This permanently deletes your account -- Garmin credentials, every custom rule, and every synced
              activity -- and logs you out. This cannot be undone.
            </p>
            <label>
              Type DELETE to confirm
              <input
                type="text"
                value={deleteConfirmText}
                onChange={(e) => setDeleteConfirmText(e.target.value)}
                disabled={deleting}
              />
            </label>
            <div className="controls">
              <button
                type="button"
                disabled={deleting}
                onClick={() => {
                  setDeleteConfirmOpen(false);
                  setDeleteConfirmText("");
                }}
              >
                Cancel
              </button>
              <button
                type="button"
                className="button-danger"
                disabled={deleting || deleteConfirmText !== "DELETE"}
                onClick={deleteAccount}
              >
                Permanently delete
              </button>
            </div>
          </div>
        )}
      </fieldset>
  • Step 3: Add the confirmation block's CSS

In frontend/src/App.css, add right after the .button-danger:hover:not(:disabled) rule:

.danger-zone-confirm {
  display: flex;
  flex-direction: column;
  gap: 0.5rem;
}

.danger-zone-confirm p {
  margin: 0;
  color: #9aa0ab;
}
  • Step 4: Build and lint

Run: cd frontend && npm run build && npm run lint Expected: build succeeds; lint reports no new warnings (the 3 pre-existing PaceField.tsx only-export-components warnings are unrelated and expected to remain).

  • Step 5: Manual browser verification

With the backend running (cd backend && ./start.sh) and frontend dev server running (cd frontend && ./start.sh), in a browser:

  1. Log in, go to the Profile page, scroll to "Danger zone".
  2. Click "Delete profile" — the confirm block appears; "Permanently delete" is disabled.
  3. Type delete (lowercase) — button stays disabled. Type DELETE — button enables.
  4. Click "Cancel" — block collapses, typed text is cleared if reopened.
  5. Reopen, type DELETE, click "Permanently delete" — expect a full-page navigation ending on the login screen (Keycloak or geniusrun's own login gate, matching what the existing "Log out" button already does).
  6. Log back in with the same account — expect the "Create your profile" screen (CreateProfile.tsx), confirming the account was actually deleted, not just logged out.
  • Step 6: Commit
git add frontend/src/api/client.ts frontend/src/pages/Profile.tsx frontend/src/App.css
git commit -m "feat(profile): add Danger zone account deletion UI"

Task 4: Final verification

Files: none (verification only)

  • Step 1: Full backend check

Run: cd backend && gofmt -l . && go vet ./... && go build ./... && go test ./... Expected: gofmt -l . empty; everything else passes.

  • Step 2: Full frontend check

Run: cd frontend && npm run build && npm run lint Expected: both succeed, no new lint warnings.

  • Step 3: Confirm docs/DATABASE.md is current

Run: cd backend && go run ./cmd/dumpschema && git status --short docs/DATABASE.md Expected: no output from git status (already committed in Task 1, and hasn't drifted since).

  • Step 4: Update docs/IDEAS.md

Remove the now-implemented line from docs/IDEAS.md's Backlog section:

- profile deletion: add a way to delete our profile with a dedicated button on the profile page (which by extension will also logout the user, to be consistent with the logic that login will trigger the profile creation)
  • Step 5: Commit
git add docs/IDEAS.md
git commit -m "docs: remove profile deletion from IDEAS backlog (implemented)"