Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite) - #404

Merged
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev
Jul 22, 2026
Merged

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite)#404
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Promotes the local-Supabase follow-ups (merged via #377 into feat/local-supabase-dev) onto main. Since #372 already landed on main, this diff is just the follow-up work — the rich seed and the opt-in integration suite.

What lands on main

What does NOT land

Risk

Backend dev-tooling + docs + an opt-in (non-default) test suite + a manual-only CI workflow. No app runtime behavior changes; the frontend is unchanged. Merging deploys the staging environment (main = staging).

Verified on the source branch: hermetic suite 965 passed / 5 skipped; RUN_INTEGRATION=1 pytest -m integration → 4 passed live; frontend tsc/vitest clean; frontend-staging Workers build green.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added an opt-in rich local dataset for testing courses, enrollments, gradebooks, study content, chat, and related features.
    • Added end-to-end integration testing against a real local Supabase environment.
    • Added an optional rich-data seeding step to local database reloads.
  • Documentation

    • Added setup instructions for the rich local dataset and integration tests.
  • Tests

    • Added coverage for database operations, encryption, authentication, gradebook responses, and idempotent data seeding.
    • Added automated integration test workflow support.

AndresL230and others added 14 commits July 21, 2026 16:05
Design for the rich local seed, the opt-in integration suite, and the
Next.js middleware->proxy migration. Base: feat/local-supabase-dev (PR #372).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
, #365)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…rs (#363)
Moves the private _upsert/_insert_if_absent/_exists_by/_print_summary
machinery out of seed_staging.py into db/seed_helpers.py so the upcoming
seed_local_rich.py (#363) can reuse the exact same upsert-on-UNIQUE /
insert-if-absent / summary logic. seed_staging.py's dataset and behavior
are unchanged — only the call sites now go through db.seed_helpers (h.*).
Also repoints test_seed_staging.py's FakeTable patch from
db.seed_staging.table (removed — no longer referenced now that all DB
access is delegated to seed_helpers) to db.seed_helpers.table, which is
the new seam.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds backend/db/seed_local_rich.py: a LOCAL-ONLY, idempotent, rich-*
namespaced dataset covering schools/courses/offerings, all 5 user
states (full/minimal profile, pending, admin), multi-term enrollments
(incl. one curved), a 13-node/7-edge knowledge graph across 3 courses
with mastery events, gradebook categories + assignments spanning every
assignment_type/source and graded/ungraded/past/upcoming combos, study
rooms with messages, notes/documents/flashcards, quiz attempts across
all 3 difficulties, and tutoring sessions with messages.
Reuses db.seed_helpers for upsert-on-UNIQUE / insert-if-absent
idempotency; 🔒 columns go through services.encryption. Guarded by
_guard_local() (SystemExit on a non-local SUPABASE_URL), verified via
two live runs against the local Supabase stack (113 created, then 0).
migrate_reload_seed is invoked bare under 'set -uo pipefail' (no set -e), so a
'return 1' was swallowed and local-db-reset.sh still printed success with exit 0.
Match the sibling db.migrate/db.seed_staging 'exit 1' handlers. (Task 3 review.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…est cleanup, curved-grade coverage)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Local-Supabase follow-ups: rich seed + integration suite (#363, #362; #365 reverted)
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontend-staging01afb0cCommit Preview URL

Branch Preview URL
Jul 22 2026, 07:25 AM

@coderabbitai

coderabbitaiBot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Free

Run ID: e4d44a8a-4221-4486-8643-0bfa6e4e384c

📥 Commits

Reviewing files that changed from the base of the PR and between 8465e40 and 01afb0c.

📒 Files selected for processing (15)
  • .github/workflows/integration.yml
  • backend/db/seed_helpers.py
  • backend/db/seed_local_rich.py
  • backend/db/seed_staging.py
  • backend/tests/conftest.py
  • backend/tests/integration/__init__.py
  • backend/tests/integration/conftest.py
  • backend/tests/integration/test_local_stack.py
  • backend/tests/test_seed_helpers.py
  • backend/tests/test_seed_local_rich.py
  • backend/tests/test_seed_staging.py
  • docs/local-supabase.md
  • docs/superpowers/plans/2026-07-21-local-supabase-followups.md
  • docs/superpowers/specs/2026-07-21-local-supabase-followups-design.md
  • scripts/lib/local-common.sh

📝 Walkthrough

Walkthrough

A shared seed-helper module, guarded rich local dataset seed, opt-in Supabase integration suite, CI workflow, local reset hook, and supporting documentation were added. Staging seeding now delegates idempotency and summary handling to the shared helpers.

Changes

Local Supabase seeding

Layer / File(s)Summary
Shared seed idempotency and staging integration
backend/db/seed_helpers.py, backend/db/seed_staging.py, backend/tests/test_seed_helpers.py, backend/tests/test_seed_staging.py
Centralizes existence checks, conditional writes, created/skipped counters, and summaries, then routes staging seed operations and tests through those helpers.
Rich local dataset seed
backend/db/seed_local_rich.py, backend/tests/test_seed_local_rich.py, scripts/lib/local-common.sh, docs/local-supabase.md
Adds a local-only, deterministic, encrypted dataset seed and an opt-in SEED_RICH=1 reset step with usage documentation.
Local-stack integration suite
backend/tests/conftest.py, backend/tests/integration/*, .github/workflows/integration.yml
Adds integration marker handling, real local-stack fixtures, session minting, database/encryption/route tests, and a manually triggered CI workflow.
Follow-up design and verification records
docs/superpowers/plans/*, docs/superpowers/specs/*
Documents the seed, integration, CI, frontend migration, and verification plans represented by the follow-up work.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
participant Developer
participant GitHubActions
participant SupabaseCLI
participant seed_local_rich
participant pytest
participant FastAPI
Developer->>GitHubActions: dispatch integration workflow
GitHubActions->>SupabaseCLI: start local Supabase
GitHubActions->>seed_local_rich: migrate and seed database
GitHubActions->>pytest: run integration-marked tests
pytest->>FastAPI: call authenticated and anonymous routes
FastAPI-->>pytest: return database-backed decrypted responses
Loading

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

Comment @coderabbitai help to get the list of available commands.

@AndresL230
AndresL230 merged commit 6b2ceed into mainJul 22, 2026
6 checks passed
@AndresL230
AndresL230 deleted the feat/local-supabase-dev branch August 2, 2026 18:30
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite) - #404

Merged
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev
Jul 22, 2026
Merged

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite)#404
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Promotes the local-Supabase follow-ups (merged via #377 into feat/local-supabase-dev) onto main. Since #372 already landed on main, this diff is just the follow-up work — the rich seed and the opt-in integration suite.

What lands on main

What does NOT land

Risk

Backend dev-tooling + docs + an opt-in (non-default) test suite + a manual-only CI workflow. No app runtime behavior changes; the frontend is unchanged. Merging deploys the staging environment (main = staging).

Verified on the source branch: hermetic suite 965 passed / 5 skipped; RUN_INTEGRATION=1 pytest -m integration → 4 passed live; frontend tsc/vitest clean; frontend-staging Workers build green.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added an opt-in rich local dataset for testing courses, enrollments, gradebooks, study content, chat, and related features.
    • Added end-to-end integration testing against a real local Supabase environment.
    • Added an optional rich-data seeding step to local database reloads.
  • Documentation

    • Added setup instructions for the rich local dataset and integration tests.
  • Tests

    • Added coverage for database operations, encryption, authentication, gradebook responses, and idempotent data seeding.
    • Added automated integration test workflow support.

AndresL230and others added 14 commits July 21, 2026 16:05
Design for the rich local seed, the opt-in integration suite, and the
Next.js middleware->proxy migration. Base: feat/local-supabase-dev (PR #372).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
, #365)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…rs (#363)
Moves the private _upsert/_insert_if_absent/_exists_by/_print_summary
machinery out of seed_staging.py into db/seed_helpers.py so the upcoming
seed_local_rich.py (#363) can reuse the exact same upsert-on-UNIQUE /
insert-if-absent / summary logic. seed_staging.py's dataset and behavior
are unchanged — only the call sites now go through db.seed_helpers (h.*).
Also repoints test_seed_staging.py's FakeTable patch from
db.seed_staging.table (removed — no longer referenced now that all DB
access is delegated to seed_helpers) to db.seed_helpers.table, which is
the new seam.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds backend/db/seed_local_rich.py: a LOCAL-ONLY, idempotent, rich-*
namespaced dataset covering schools/courses/offerings, all 5 user
states (full/minimal profile, pending, admin), multi-term enrollments
(incl. one curved), a 13-node/7-edge knowledge graph across 3 courses
with mastery events, gradebook categories + assignments spanning every
assignment_type/source and graded/ungraded/past/upcoming combos, study
rooms with messages, notes/documents/flashcards, quiz attempts across
all 3 difficulties, and tutoring sessions with messages.
Reuses db.seed_helpers for upsert-on-UNIQUE / insert-if-absent
idempotency; 🔒 columns go through services.encryption. Guarded by
_guard_local() (SystemExit on a non-local SUPABASE_URL), verified via
two live runs against the local Supabase stack (113 created, then 0).
migrate_reload_seed is invoked bare under 'set -uo pipefail' (no set -e), so a
'return 1' was swallowed and local-db-reset.sh still printed success with exit 0.
Match the sibling db.migrate/db.seed_staging 'exit 1' handlers. (Task 3 review.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…est cleanup, curved-grade coverage)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Local-Supabase follow-ups: rich seed + integration suite (#363, #362; #365 reverted)
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontend-staging01afb0cCommit Preview URL

Branch Preview URL
Jul 22 2026, 07:25 AM

@coderabbitai

coderabbitaiBot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Free

Run ID: e4d44a8a-4221-4486-8643-0bfa6e4e384c

📥 Commits

Reviewing files that changed from the base of the PR and between 8465e40 and 01afb0c.

📒 Files selected for processing (15)
  • .github/workflows/integration.yml
  • backend/db/seed_helpers.py
  • backend/db/seed_local_rich.py
  • backend/db/seed_staging.py
  • backend/tests/conftest.py
  • backend/tests/integration/__init__.py
  • backend/tests/integration/conftest.py
  • backend/tests/integration/test_local_stack.py
  • backend/tests/test_seed_helpers.py
  • backend/tests/test_seed_local_rich.py
  • backend/tests/test_seed_staging.py
  • docs/local-supabase.md
  • docs/superpowers/plans/2026-07-21-local-supabase-followups.md
  • docs/superpowers/specs/2026-07-21-local-supabase-followups-design.md
  • scripts/lib/local-common.sh

📝 Walkthrough

Walkthrough

A shared seed-helper module, guarded rich local dataset seed, opt-in Supabase integration suite, CI workflow, local reset hook, and supporting documentation were added. Staging seeding now delegates idempotency and summary handling to the shared helpers.

Changes

Local Supabase seeding

Layer / File(s)Summary
Shared seed idempotency and staging integration
backend/db/seed_helpers.py, backend/db/seed_staging.py, backend/tests/test_seed_helpers.py, backend/tests/test_seed_staging.py
Centralizes existence checks, conditional writes, created/skipped counters, and summaries, then routes staging seed operations and tests through those helpers.
Rich local dataset seed
backend/db/seed_local_rich.py, backend/tests/test_seed_local_rich.py, scripts/lib/local-common.sh, docs/local-supabase.md
Adds a local-only, deterministic, encrypted dataset seed and an opt-in SEED_RICH=1 reset step with usage documentation.
Local-stack integration suite
backend/tests/conftest.py, backend/tests/integration/*, .github/workflows/integration.yml
Adds integration marker handling, real local-stack fixtures, session minting, database/encryption/route tests, and a manually triggered CI workflow.
Follow-up design and verification records
docs/superpowers/plans/*, docs/superpowers/specs/*
Documents the seed, integration, CI, frontend migration, and verification plans represented by the follow-up work.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
participant Developer
participant GitHubActions
participant SupabaseCLI
participant seed_local_rich
participant pytest
participant FastAPI
Developer->>GitHubActions: dispatch integration workflow
GitHubActions->>SupabaseCLI: start local Supabase
GitHubActions->>seed_local_rich: migrate and seed database
GitHubActions->>pytest: run integration-marked tests
pytest->>FastAPI: call authenticated and anonymous routes
FastAPI-->>pytest: return database-backed decrypted responses
Loading

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

Comment @coderabbitai help to get the list of available commands.

@AndresL230
AndresL230 merged commit 6b2ceed into mainJul 22, 2026
6 checks passed
@AndresL230
AndresL230 deleted the feat/local-supabase-dev branch August 2, 2026 18:30
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite) - #404

Merged
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev
Jul 22, 2026
Merged

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite)#404
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Promotes the local-Supabase follow-ups (merged via #377 into feat/local-supabase-dev) onto main. Since #372 already landed on main, this diff is just the follow-up work — the rich seed and the opt-in integration suite.

What lands on main

What does NOT land

Risk

Backend dev-tooling + docs + an opt-in (non-default) test suite + a manual-only CI workflow. No app runtime behavior changes; the frontend is unchanged. Merging deploys the staging environment (main = staging).

Verified on the source branch: hermetic suite 965 passed / 5 skipped; RUN_INTEGRATION=1 pytest -m integration → 4 passed live; frontend tsc/vitest clean; frontend-staging Workers build green.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added an opt-in rich local dataset for testing courses, enrollments, gradebooks, study content, chat, and related features.
    • Added end-to-end integration testing against a real local Supabase environment.
    • Added an optional rich-data seeding step to local database reloads.
  • Documentation

    • Added setup instructions for the rich local dataset and integration tests.
  • Tests

    • Added coverage for database operations, encryption, authentication, gradebook responses, and idempotent data seeding.
    • Added automated integration test workflow support.

AndresL230and others added 14 commits July 21, 2026 16:05
Design for the rich local seed, the opt-in integration suite, and the
Next.js middleware->proxy migration. Base: feat/local-supabase-dev (PR #372).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
, #365)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…rs (#363)
Moves the private _upsert/_insert_if_absent/_exists_by/_print_summary
machinery out of seed_staging.py into db/seed_helpers.py so the upcoming
seed_local_rich.py (#363) can reuse the exact same upsert-on-UNIQUE /
insert-if-absent / summary logic. seed_staging.py's dataset and behavior
are unchanged — only the call sites now go through db.seed_helpers (h.*).
Also repoints test_seed_staging.py's FakeTable patch from
db.seed_staging.table (removed — no longer referenced now that all DB
access is delegated to seed_helpers) to db.seed_helpers.table, which is
the new seam.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds backend/db/seed_local_rich.py: a LOCAL-ONLY, idempotent, rich-*
namespaced dataset covering schools/courses/offerings, all 5 user
states (full/minimal profile, pending, admin), multi-term enrollments
(incl. one curved), a 13-node/7-edge knowledge graph across 3 courses
with mastery events, gradebook categories + assignments spanning every
assignment_type/source and graded/ungraded/past/upcoming combos, study
rooms with messages, notes/documents/flashcards, quiz attempts across
all 3 difficulties, and tutoring sessions with messages.
Reuses db.seed_helpers for upsert-on-UNIQUE / insert-if-absent
idempotency; 🔒 columns go through services.encryption. Guarded by
_guard_local() (SystemExit on a non-local SUPABASE_URL), verified via
two live runs against the local Supabase stack (113 created, then 0).
migrate_reload_seed is invoked bare under 'set -uo pipefail' (no set -e), so a
'return 1' was swallowed and local-db-reset.sh still printed success with exit 0.
Match the sibling db.migrate/db.seed_staging 'exit 1' handlers. (Task 3 review.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…est cleanup, curved-grade coverage)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Local-Supabase follow-ups: rich seed + integration suite (#363, #362; #365 reverted)
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontend-staging01afb0cCommit Preview URL

Branch Preview URL
Jul 22 2026, 07:25 AM

@coderabbitai

coderabbitaiBot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Free

Run ID: e4d44a8a-4221-4486-8643-0bfa6e4e384c

📥 Commits

Reviewing files that changed from the base of the PR and between 8465e40 and 01afb0c.

📒 Files selected for processing (15)
  • .github/workflows/integration.yml
  • backend/db/seed_helpers.py
  • backend/db/seed_local_rich.py
  • backend/db/seed_staging.py
  • backend/tests/conftest.py
  • backend/tests/integration/__init__.py
  • backend/tests/integration/conftest.py
  • backend/tests/integration/test_local_stack.py
  • backend/tests/test_seed_helpers.py
  • backend/tests/test_seed_local_rich.py
  • backend/tests/test_seed_staging.py
  • docs/local-supabase.md
  • docs/superpowers/plans/2026-07-21-local-supabase-followups.md
  • docs/superpowers/specs/2026-07-21-local-supabase-followups-design.md
  • scripts/lib/local-common.sh

📝 Walkthrough

Walkthrough

A shared seed-helper module, guarded rich local dataset seed, opt-in Supabase integration suite, CI workflow, local reset hook, and supporting documentation were added. Staging seeding now delegates idempotency and summary handling to the shared helpers.

Changes

Local Supabase seeding

Layer / File(s)Summary
Shared seed idempotency and staging integration
backend/db/seed_helpers.py, backend/db/seed_staging.py, backend/tests/test_seed_helpers.py, backend/tests/test_seed_staging.py
Centralizes existence checks, conditional writes, created/skipped counters, and summaries, then routes staging seed operations and tests through those helpers.
Rich local dataset seed
backend/db/seed_local_rich.py, backend/tests/test_seed_local_rich.py, scripts/lib/local-common.sh, docs/local-supabase.md
Adds a local-only, deterministic, encrypted dataset seed and an opt-in SEED_RICH=1 reset step with usage documentation.
Local-stack integration suite
backend/tests/conftest.py, backend/tests/integration/*, .github/workflows/integration.yml
Adds integration marker handling, real local-stack fixtures, session minting, database/encryption/route tests, and a manually triggered CI workflow.
Follow-up design and verification records
docs/superpowers/plans/*, docs/superpowers/specs/*
Documents the seed, integration, CI, frontend migration, and verification plans represented by the follow-up work.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
participant Developer
participant GitHubActions
participant SupabaseCLI
participant seed_local_rich
participant pytest
participant FastAPI
Developer->>GitHubActions: dispatch integration workflow
GitHubActions->>SupabaseCLI: start local Supabase
GitHubActions->>seed_local_rich: migrate and seed database
GitHubActions->>pytest: run integration-marked tests
pytest->>FastAPI: call authenticated and anonymous routes
FastAPI-->>pytest: return database-backed decrypted responses
Loading

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

Comment @coderabbitai help to get the list of available commands.

@AndresL230
AndresL230 merged commit 6b2ceed into mainJul 22, 2026
6 checks passed
@AndresL230
AndresL230 deleted the feat/local-supabase-dev branch August 2, 2026 18:30
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite) - #404

Merged
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev
Jul 22, 2026
Merged

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite)#404
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Promotes the local-Supabase follow-ups (merged via #377 into feat/local-supabase-dev) onto main. Since #372 already landed on main, this diff is just the follow-up work — the rich seed and the opt-in integration suite.

What lands on main

What does NOT land

Risk

Backend dev-tooling + docs + an opt-in (non-default) test suite + a manual-only CI workflow. No app runtime behavior changes; the frontend is unchanged. Merging deploys the staging environment (main = staging).

Verified on the source branch: hermetic suite 965 passed / 5 skipped; RUN_INTEGRATION=1 pytest -m integration → 4 passed live; frontend tsc/vitest clean; frontend-staging Workers build green.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added an opt-in rich local dataset for testing courses, enrollments, gradebooks, study content, chat, and related features.
    • Added end-to-end integration testing against a real local Supabase environment.
    • Added an optional rich-data seeding step to local database reloads.
  • Documentation

    • Added setup instructions for the rich local dataset and integration tests.
  • Tests

    • Added coverage for database operations, encryption, authentication, gradebook responses, and idempotent data seeding.
    • Added automated integration test workflow support.

AndresL230and others added 14 commits July 21, 2026 16:05
Design for the rich local seed, the opt-in integration suite, and the
Next.js middleware->proxy migration. Base: feat/local-supabase-dev (PR #372).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
, #365)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…rs (#363)
Moves the private _upsert/_insert_if_absent/_exists_by/_print_summary
machinery out of seed_staging.py into db/seed_helpers.py so the upcoming
seed_local_rich.py (#363) can reuse the exact same upsert-on-UNIQUE /
insert-if-absent / summary logic. seed_staging.py's dataset and behavior
are unchanged — only the call sites now go through db.seed_helpers (h.*).
Also repoints test_seed_staging.py's FakeTable patch from
db.seed_staging.table (removed — no longer referenced now that all DB
access is delegated to seed_helpers) to db.seed_helpers.table, which is
the new seam.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds backend/db/seed_local_rich.py: a LOCAL-ONLY, idempotent, rich-*
namespaced dataset covering schools/courses/offerings, all 5 user
states (full/minimal profile, pending, admin), multi-term enrollments
(incl. one curved), a 13-node/7-edge knowledge graph across 3 courses
with mastery events, gradebook categories + assignments spanning every
assignment_type/source and graded/ungraded/past/upcoming combos, study
rooms with messages, notes/documents/flashcards, quiz attempts across
all 3 difficulties, and tutoring sessions with messages.
Reuses db.seed_helpers for upsert-on-UNIQUE / insert-if-absent
idempotency; 🔒 columns go through services.encryption. Guarded by
_guard_local() (SystemExit on a non-local SUPABASE_URL), verified via
two live runs against the local Supabase stack (113 created, then 0).
migrate_reload_seed is invoked bare under 'set -uo pipefail' (no set -e), so a
'return 1' was swallowed and local-db-reset.sh still printed success with exit 0.
Match the sibling db.migrate/db.seed_staging 'exit 1' handlers. (Task 3 review.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…est cleanup, curved-grade coverage)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Local-Supabase follow-ups: rich seed + integration suite (#363, #362; #365 reverted)
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontend-staging01afb0cCommit Preview URL

Branch Preview URL
Jul 22 2026, 07:25 AM

@coderabbitai

coderabbitaiBot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Free

Run ID: e4d44a8a-4221-4486-8643-0bfa6e4e384c

📥 Commits

Reviewing files that changed from the base of the PR and between 8465e40 and 01afb0c.

📒 Files selected for processing (15)
  • .github/workflows/integration.yml
  • backend/db/seed_helpers.py
  • backend/db/seed_local_rich.py
  • backend/db/seed_staging.py
  • backend/tests/conftest.py
  • backend/tests/integration/__init__.py
  • backend/tests/integration/conftest.py
  • backend/tests/integration/test_local_stack.py
  • backend/tests/test_seed_helpers.py
  • backend/tests/test_seed_local_rich.py
  • backend/tests/test_seed_staging.py
  • docs/local-supabase.md
  • docs/superpowers/plans/2026-07-21-local-supabase-followups.md
  • docs/superpowers/specs/2026-07-21-local-supabase-followups-design.md
  • scripts/lib/local-common.sh

📝 Walkthrough

Walkthrough

A shared seed-helper module, guarded rich local dataset seed, opt-in Supabase integration suite, CI workflow, local reset hook, and supporting documentation were added. Staging seeding now delegates idempotency and summary handling to the shared helpers.

Changes

Local Supabase seeding

Layer / File(s)Summary
Shared seed idempotency and staging integration
backend/db/seed_helpers.py, backend/db/seed_staging.py, backend/tests/test_seed_helpers.py, backend/tests/test_seed_staging.py
Centralizes existence checks, conditional writes, created/skipped counters, and summaries, then routes staging seed operations and tests through those helpers.
Rich local dataset seed
backend/db/seed_local_rich.py, backend/tests/test_seed_local_rich.py, scripts/lib/local-common.sh, docs/local-supabase.md
Adds a local-only, deterministic, encrypted dataset seed and an opt-in SEED_RICH=1 reset step with usage documentation.
Local-stack integration suite
backend/tests/conftest.py, backend/tests/integration/*, .github/workflows/integration.yml
Adds integration marker handling, real local-stack fixtures, session minting, database/encryption/route tests, and a manually triggered CI workflow.
Follow-up design and verification records
docs/superpowers/plans/*, docs/superpowers/specs/*
Documents the seed, integration, CI, frontend migration, and verification plans represented by the follow-up work.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
participant Developer
participant GitHubActions
participant SupabaseCLI
participant seed_local_rich
participant pytest
participant FastAPI
Developer->>GitHubActions: dispatch integration workflow
GitHubActions->>SupabaseCLI: start local Supabase
GitHubActions->>seed_local_rich: migrate and seed database
GitHubActions->>pytest: run integration-marked tests
pytest->>FastAPI: call authenticated and anonymous routes
FastAPI-->>pytest: return database-backed decrypted responses
Loading

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

Comment @coderabbitai help to get the list of available commands.

@AndresL230
AndresL230 merged commit 6b2ceed into mainJul 22, 2026
6 checks passed
@AndresL230
AndresL230 deleted the feat/local-supabase-dev branch August 2, 2026 18:30
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite) - #404

Merged
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev
Jul 22, 2026
Merged

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite)#404
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Promotes the local-Supabase follow-ups (merged via #377 into feat/local-supabase-dev) onto main. Since #372 already landed on main, this diff is just the follow-up work — the rich seed and the opt-in integration suite.

What lands on main

What does NOT land

Risk

Backend dev-tooling + docs + an opt-in (non-default) test suite + a manual-only CI workflow. No app runtime behavior changes; the frontend is unchanged. Merging deploys the staging environment (main = staging).

Verified on the source branch: hermetic suite 965 passed / 5 skipped; RUN_INTEGRATION=1 pytest -m integration → 4 passed live; frontend tsc/vitest clean; frontend-staging Workers build green.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added an opt-in rich local dataset for testing courses, enrollments, gradebooks, study content, chat, and related features.
    • Added end-to-end integration testing against a real local Supabase environment.
    • Added an optional rich-data seeding step to local database reloads.
  • Documentation

    • Added setup instructions for the rich local dataset and integration tests.
  • Tests

    • Added coverage for database operations, encryption, authentication, gradebook responses, and idempotent data seeding.
    • Added automated integration test workflow support.

AndresL230and others added 14 commits July 21, 2026 16:05
Design for the rich local seed, the opt-in integration suite, and the
Next.js middleware->proxy migration. Base: feat/local-supabase-dev (PR #372).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
, #365)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…rs (#363)
Moves the private _upsert/_insert_if_absent/_exists_by/_print_summary
machinery out of seed_staging.py into db/seed_helpers.py so the upcoming
seed_local_rich.py (#363) can reuse the exact same upsert-on-UNIQUE /
insert-if-absent / summary logic. seed_staging.py's dataset and behavior
are unchanged — only the call sites now go through db.seed_helpers (h.*).
Also repoints test_seed_staging.py's FakeTable patch from
db.seed_staging.table (removed — no longer referenced now that all DB
access is delegated to seed_helpers) to db.seed_helpers.table, which is
the new seam.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds backend/db/seed_local_rich.py: a LOCAL-ONLY, idempotent, rich-*
namespaced dataset covering schools/courses/offerings, all 5 user
states (full/minimal profile, pending, admin), multi-term enrollments
(incl. one curved), a 13-node/7-edge knowledge graph across 3 courses
with mastery events, gradebook categories + assignments spanning every
assignment_type/source and graded/ungraded/past/upcoming combos, study
rooms with messages, notes/documents/flashcards, quiz attempts across
all 3 difficulties, and tutoring sessions with messages.
Reuses db.seed_helpers for upsert-on-UNIQUE / insert-if-absent
idempotency; 🔒 columns go through services.encryption. Guarded by
_guard_local() (SystemExit on a non-local SUPABASE_URL), verified via
two live runs against the local Supabase stack (113 created, then 0).
migrate_reload_seed is invoked bare under 'set -uo pipefail' (no set -e), so a
'return 1' was swallowed and local-db-reset.sh still printed success with exit 0.
Match the sibling db.migrate/db.seed_staging 'exit 1' handlers. (Task 3 review.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…est cleanup, curved-grade coverage)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Local-Supabase follow-ups: rich seed + integration suite (#363, #362; #365 reverted)
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontend-staging01afb0cCommit Preview URL

Branch Preview URL
Jul 22 2026, 07:25 AM

@coderabbitai

coderabbitaiBot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Free

Run ID: e4d44a8a-4221-4486-8643-0bfa6e4e384c

📥 Commits

Reviewing files that changed from the base of the PR and between 8465e40 and 01afb0c.

📒 Files selected for processing (15)
  • .github/workflows/integration.yml
  • backend/db/seed_helpers.py
  • backend/db/seed_local_rich.py
  • backend/db/seed_staging.py
  • backend/tests/conftest.py
  • backend/tests/integration/__init__.py
  • backend/tests/integration/conftest.py
  • backend/tests/integration/test_local_stack.py
  • backend/tests/test_seed_helpers.py
  • backend/tests/test_seed_local_rich.py
  • backend/tests/test_seed_staging.py
  • docs/local-supabase.md
  • docs/superpowers/plans/2026-07-21-local-supabase-followups.md
  • docs/superpowers/specs/2026-07-21-local-supabase-followups-design.md
  • scripts/lib/local-common.sh

📝 Walkthrough

Walkthrough

A shared seed-helper module, guarded rich local dataset seed, opt-in Supabase integration suite, CI workflow, local reset hook, and supporting documentation were added. Staging seeding now delegates idempotency and summary handling to the shared helpers.

Changes

Local Supabase seeding

Layer / File(s)Summary
Shared seed idempotency and staging integration
backend/db/seed_helpers.py, backend/db/seed_staging.py, backend/tests/test_seed_helpers.py, backend/tests/test_seed_staging.py
Centralizes existence checks, conditional writes, created/skipped counters, and summaries, then routes staging seed operations and tests through those helpers.
Rich local dataset seed
backend/db/seed_local_rich.py, backend/tests/test_seed_local_rich.py, scripts/lib/local-common.sh, docs/local-supabase.md
Adds a local-only, deterministic, encrypted dataset seed and an opt-in SEED_RICH=1 reset step with usage documentation.
Local-stack integration suite
backend/tests/conftest.py, backend/tests/integration/*, .github/workflows/integration.yml
Adds integration marker handling, real local-stack fixtures, session minting, database/encryption/route tests, and a manually triggered CI workflow.
Follow-up design and verification records
docs/superpowers/plans/*, docs/superpowers/specs/*
Documents the seed, integration, CI, frontend migration, and verification plans represented by the follow-up work.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
participant Developer
participant GitHubActions
participant SupabaseCLI
participant seed_local_rich
participant pytest
participant FastAPI
Developer->>GitHubActions: dispatch integration workflow
GitHubActions->>SupabaseCLI: start local Supabase
GitHubActions->>seed_local_rich: migrate and seed database
GitHubActions->>pytest: run integration-marked tests
pytest->>FastAPI: call authenticated and anonymous routes
FastAPI-->>pytest: return database-backed decrypted responses
Loading

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

Comment @coderabbitai help to get the list of available commands.

@AndresL230
AndresL230 merged commit 6b2ceed into mainJul 22, 2026
6 checks passed
@AndresL230
AndresL230 deleted the feat/local-supabase-dev branch August 2, 2026 18:30
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite) - #404

Merged
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev
Jul 22, 2026
Merged

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite)#404
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Promotes the local-Supabase follow-ups (merged via #377 into feat/local-supabase-dev) onto main. Since #372 already landed on main, this diff is just the follow-up work — the rich seed and the opt-in integration suite.

What lands on main

What does NOT land

Risk

Backend dev-tooling + docs + an opt-in (non-default) test suite + a manual-only CI workflow. No app runtime behavior changes; the frontend is unchanged. Merging deploys the staging environment (main = staging).

Verified on the source branch: hermetic suite 965 passed / 5 skipped; RUN_INTEGRATION=1 pytest -m integration → 4 passed live; frontend tsc/vitest clean; frontend-staging Workers build green.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added an opt-in rich local dataset for testing courses, enrollments, gradebooks, study content, chat, and related features.
    • Added end-to-end integration testing against a real local Supabase environment.
    • Added an optional rich-data seeding step to local database reloads.
  • Documentation

    • Added setup instructions for the rich local dataset and integration tests.
  • Tests

    • Added coverage for database operations, encryption, authentication, gradebook responses, and idempotent data seeding.
    • Added automated integration test workflow support.

AndresL230and others added 14 commits July 21, 2026 16:05
Design for the rich local seed, the opt-in integration suite, and the
Next.js middleware->proxy migration. Base: feat/local-supabase-dev (PR #372).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
, #365)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…rs (#363)
Moves the private _upsert/_insert_if_absent/_exists_by/_print_summary
machinery out of seed_staging.py into db/seed_helpers.py so the upcoming
seed_local_rich.py (#363) can reuse the exact same upsert-on-UNIQUE /
insert-if-absent / summary logic. seed_staging.py's dataset and behavior
are unchanged — only the call sites now go through db.seed_helpers (h.*).
Also repoints test_seed_staging.py's FakeTable patch from
db.seed_staging.table (removed — no longer referenced now that all DB
access is delegated to seed_helpers) to db.seed_helpers.table, which is
the new seam.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds backend/db/seed_local_rich.py: a LOCAL-ONLY, idempotent, rich-*
namespaced dataset covering schools/courses/offerings, all 5 user
states (full/minimal profile, pending, admin), multi-term enrollments
(incl. one curved), a 13-node/7-edge knowledge graph across 3 courses
with mastery events, gradebook categories + assignments spanning every
assignment_type/source and graded/ungraded/past/upcoming combos, study
rooms with messages, notes/documents/flashcards, quiz attempts across
all 3 difficulties, and tutoring sessions with messages.
Reuses db.seed_helpers for upsert-on-UNIQUE / insert-if-absent
idempotency; 🔒 columns go through services.encryption. Guarded by
_guard_local() (SystemExit on a non-local SUPABASE_URL), verified via
two live runs against the local Supabase stack (113 created, then 0).
migrate_reload_seed is invoked bare under 'set -uo pipefail' (no set -e), so a
'return 1' was swallowed and local-db-reset.sh still printed success with exit 0.
Match the sibling db.migrate/db.seed_staging 'exit 1' handlers. (Task 3 review.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…est cleanup, curved-grade coverage)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Local-Supabase follow-ups: rich seed + integration suite (#363, #362; #365 reverted)
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontend-staging01afb0cCommit Preview URL

Branch Preview URL
Jul 22 2026, 07:25 AM

@coderabbitai

coderabbitaiBot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Free

Run ID: e4d44a8a-4221-4486-8643-0bfa6e4e384c

📥 Commits

Reviewing files that changed from the base of the PR and between 8465e40 and 01afb0c.

📒 Files selected for processing (15)
  • .github/workflows/integration.yml
  • backend/db/seed_helpers.py
  • backend/db/seed_local_rich.py
  • backend/db/seed_staging.py
  • backend/tests/conftest.py
  • backend/tests/integration/__init__.py
  • backend/tests/integration/conftest.py
  • backend/tests/integration/test_local_stack.py
  • backend/tests/test_seed_helpers.py
  • backend/tests/test_seed_local_rich.py
  • backend/tests/test_seed_staging.py
  • docs/local-supabase.md
  • docs/superpowers/plans/2026-07-21-local-supabase-followups.md
  • docs/superpowers/specs/2026-07-21-local-supabase-followups-design.md
  • scripts/lib/local-common.sh

📝 Walkthrough

Walkthrough

A shared seed-helper module, guarded rich local dataset seed, opt-in Supabase integration suite, CI workflow, local reset hook, and supporting documentation were added. Staging seeding now delegates idempotency and summary handling to the shared helpers.

Changes

Local Supabase seeding

Layer / File(s)Summary
Shared seed idempotency and staging integration
backend/db/seed_helpers.py, backend/db/seed_staging.py, backend/tests/test_seed_helpers.py, backend/tests/test_seed_staging.py
Centralizes existence checks, conditional writes, created/skipped counters, and summaries, then routes staging seed operations and tests through those helpers.
Rich local dataset seed
backend/db/seed_local_rich.py, backend/tests/test_seed_local_rich.py, scripts/lib/local-common.sh, docs/local-supabase.md
Adds a local-only, deterministic, encrypted dataset seed and an opt-in SEED_RICH=1 reset step with usage documentation.
Local-stack integration suite
backend/tests/conftest.py, backend/tests/integration/*, .github/workflows/integration.yml
Adds integration marker handling, real local-stack fixtures, session minting, database/encryption/route tests, and a manually triggered CI workflow.
Follow-up design and verification records
docs/superpowers/plans/*, docs/superpowers/specs/*
Documents the seed, integration, CI, frontend migration, and verification plans represented by the follow-up work.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
participant Developer
participant GitHubActions
participant SupabaseCLI
participant seed_local_rich
participant pytest
participant FastAPI
Developer->>GitHubActions: dispatch integration workflow
GitHubActions->>SupabaseCLI: start local Supabase
GitHubActions->>seed_local_rich: migrate and seed database
GitHubActions->>pytest: run integration-marked tests
pytest->>FastAPI: call authenticated and anonymous routes
FastAPI-->>pytest: return database-backed decrypted responses
Loading

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

Comment @coderabbitai help to get the list of available commands.

@AndresL230
AndresL230 merged commit 6b2ceed into mainJul 22, 2026
6 checks passed
@AndresL230
AndresL230 deleted the feat/local-supabase-dev branch August 2, 2026 18:30
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite) - #404

Merged
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev
Jul 22, 2026
Merged

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite)#404
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Promotes the local-Supabase follow-ups (merged via #377 into feat/local-supabase-dev) onto main. Since #372 already landed on main, this diff is just the follow-up work — the rich seed and the opt-in integration suite.

What lands on main

What does NOT land

Risk

Backend dev-tooling + docs + an opt-in (non-default) test suite + a manual-only CI workflow. No app runtime behavior changes; the frontend is unchanged. Merging deploys the staging environment (main = staging).

Verified on the source branch: hermetic suite 965 passed / 5 skipped; RUN_INTEGRATION=1 pytest -m integration → 4 passed live; frontend tsc/vitest clean; frontend-staging Workers build green.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added an opt-in rich local dataset for testing courses, enrollments, gradebooks, study content, chat, and related features.
    • Added end-to-end integration testing against a real local Supabase environment.
    • Added an optional rich-data seeding step to local database reloads.
  • Documentation

    • Added setup instructions for the rich local dataset and integration tests.
  • Tests

    • Added coverage for database operations, encryption, authentication, gradebook responses, and idempotent data seeding.
    • Added automated integration test workflow support.

AndresL230and others added 14 commits July 21, 2026 16:05
Design for the rich local seed, the opt-in integration suite, and the
Next.js middleware->proxy migration. Base: feat/local-supabase-dev (PR #372).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
, #365)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…rs (#363)
Moves the private _upsert/_insert_if_absent/_exists_by/_print_summary
machinery out of seed_staging.py into db/seed_helpers.py so the upcoming
seed_local_rich.py (#363) can reuse the exact same upsert-on-UNIQUE /
insert-if-absent / summary logic. seed_staging.py's dataset and behavior
are unchanged — only the call sites now go through db.seed_helpers (h.*).
Also repoints test_seed_staging.py's FakeTable patch from
db.seed_staging.table (removed — no longer referenced now that all DB
access is delegated to seed_helpers) to db.seed_helpers.table, which is
the new seam.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds backend/db/seed_local_rich.py: a LOCAL-ONLY, idempotent, rich-*
namespaced dataset covering schools/courses/offerings, all 5 user
states (full/minimal profile, pending, admin), multi-term enrollments
(incl. one curved), a 13-node/7-edge knowledge graph across 3 courses
with mastery events, gradebook categories + assignments spanning every
assignment_type/source and graded/ungraded/past/upcoming combos, study
rooms with messages, notes/documents/flashcards, quiz attempts across
all 3 difficulties, and tutoring sessions with messages.
Reuses db.seed_helpers for upsert-on-UNIQUE / insert-if-absent
idempotency; 🔒 columns go through services.encryption. Guarded by
_guard_local() (SystemExit on a non-local SUPABASE_URL), verified via
two live runs against the local Supabase stack (113 created, then 0).
migrate_reload_seed is invoked bare under 'set -uo pipefail' (no set -e), so a
'return 1' was swallowed and local-db-reset.sh still printed success with exit 0.
Match the sibling db.migrate/db.seed_staging 'exit 1' handlers. (Task 3 review.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…est cleanup, curved-grade coverage)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Local-Supabase follow-ups: rich seed + integration suite (#363, #362; #365 reverted)
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontend-staging01afb0cCommit Preview URL

Branch Preview URL
Jul 22 2026, 07:25 AM

@coderabbitai

coderabbitaiBot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Free

Run ID: e4d44a8a-4221-4486-8643-0bfa6e4e384c

📥 Commits

Reviewing files that changed from the base of the PR and between 8465e40 and 01afb0c.

📒 Files selected for processing (15)
  • .github/workflows/integration.yml
  • backend/db/seed_helpers.py
  • backend/db/seed_local_rich.py
  • backend/db/seed_staging.py
  • backend/tests/conftest.py
  • backend/tests/integration/__init__.py
  • backend/tests/integration/conftest.py
  • backend/tests/integration/test_local_stack.py
  • backend/tests/test_seed_helpers.py
  • backend/tests/test_seed_local_rich.py
  • backend/tests/test_seed_staging.py
  • docs/local-supabase.md
  • docs/superpowers/plans/2026-07-21-local-supabase-followups.md
  • docs/superpowers/specs/2026-07-21-local-supabase-followups-design.md
  • scripts/lib/local-common.sh

📝 Walkthrough

Walkthrough

A shared seed-helper module, guarded rich local dataset seed, opt-in Supabase integration suite, CI workflow, local reset hook, and supporting documentation were added. Staging seeding now delegates idempotency and summary handling to the shared helpers.

Changes

Local Supabase seeding

Layer / File(s)Summary
Shared seed idempotency and staging integration
backend/db/seed_helpers.py, backend/db/seed_staging.py, backend/tests/test_seed_helpers.py, backend/tests/test_seed_staging.py
Centralizes existence checks, conditional writes, created/skipped counters, and summaries, then routes staging seed operations and tests through those helpers.
Rich local dataset seed
backend/db/seed_local_rich.py, backend/tests/test_seed_local_rich.py, scripts/lib/local-common.sh, docs/local-supabase.md
Adds a local-only, deterministic, encrypted dataset seed and an opt-in SEED_RICH=1 reset step with usage documentation.
Local-stack integration suite
backend/tests/conftest.py, backend/tests/integration/*, .github/workflows/integration.yml
Adds integration marker handling, real local-stack fixtures, session minting, database/encryption/route tests, and a manually triggered CI workflow.
Follow-up design and verification records
docs/superpowers/plans/*, docs/superpowers/specs/*
Documents the seed, integration, CI, frontend migration, and verification plans represented by the follow-up work.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
participant Developer
participant GitHubActions
participant SupabaseCLI
participant seed_local_rich
participant pytest
participant FastAPI
Developer->>GitHubActions: dispatch integration workflow
GitHubActions->>SupabaseCLI: start local Supabase
GitHubActions->>seed_local_rich: migrate and seed database
GitHubActions->>pytest: run integration-marked tests
pytest->>FastAPI: call authenticated and anonymous routes
FastAPI-->>pytest: return database-backed decrypted responses
Loading

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

Comment @coderabbitai help to get the list of available commands.

@AndresL230
AndresL230 merged commit 6b2ceed into mainJul 22, 2026
6 checks passed
@AndresL230
AndresL230 deleted the feat/local-supabase-dev branch August 2, 2026 18:30
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite) - #404

Merged
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev
Jul 22, 2026
Merged

Promote local-Supabase follow-ups to main (#363 rich seed, #362 integration suite)#404
AndresL230 merged 14 commits into
mainfrom
feat/local-supabase-dev

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 22, 2026

Copy link
Copy Markdown
Collaborator

Promotes the local-Supabase follow-ups (merged via #377 into feat/local-supabase-dev) onto main. Since #372 already landed on main, this diff is just the follow-up work — the rich seed and the opt-in integration suite.

What lands on main

What does NOT land

Risk

Backend dev-tooling + docs + an opt-in (non-default) test suite + a manual-only CI workflow. No app runtime behavior changes; the frontend is unchanged. Merging deploys the staging environment (main = staging).

Verified on the source branch: hermetic suite 965 passed / 5 skipped; RUN_INTEGRATION=1 pytest -m integration → 4 passed live; frontend tsc/vitest clean; frontend-staging Workers build green.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added an opt-in rich local dataset for testing courses, enrollments, gradebooks, study content, chat, and related features.
    • Added end-to-end integration testing against a real local Supabase environment.
    • Added an optional rich-data seeding step to local database reloads.
  • Documentation

    • Added setup instructions for the rich local dataset and integration tests.
  • Tests

    • Added coverage for database operations, encryption, authentication, gradebook responses, and idempotent data seeding.
    • Added automated integration test workflow support.

AndresL230and others added 14 commits July 21, 2026 16:05
Design for the rich local seed, the opt-in integration suite, and the
Next.js middleware->proxy migration. Base: feat/local-supabase-dev (PR #372).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
, #365)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…rs (#363)
Moves the private _upsert/_insert_if_absent/_exists_by/_print_summary
machinery out of seed_staging.py into db/seed_helpers.py so the upcoming
seed_local_rich.py (#363) can reuse the exact same upsert-on-UNIQUE /
insert-if-absent / summary logic. seed_staging.py's dataset and behavior
are unchanged — only the call sites now go through db.seed_helpers (h.*).
Also repoints test_seed_staging.py's FakeTable patch from
db.seed_staging.table (removed — no longer referenced now that all DB
access is delegated to seed_helpers) to db.seed_helpers.table, which is
the new seam.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds backend/db/seed_local_rich.py: a LOCAL-ONLY, idempotent, rich-*
namespaced dataset covering schools/courses/offerings, all 5 user
states (full/minimal profile, pending, admin), multi-term enrollments
(incl. one curved), a 13-node/7-edge knowledge graph across 3 courses
with mastery events, gradebook categories + assignments spanning every
assignment_type/source and graded/ungraded/past/upcoming combos, study
rooms with messages, notes/documents/flashcards, quiz attempts across
all 3 difficulties, and tutoring sessions with messages.
Reuses db.seed_helpers for upsert-on-UNIQUE / insert-if-absent
idempotency; 🔒 columns go through services.encryption. Guarded by
_guard_local() (SystemExit on a non-local SUPABASE_URL), verified via
two live runs against the local Supabase stack (113 created, then 0).
migrate_reload_seed is invoked bare under 'set -uo pipefail' (no set -e), so a
'return 1' was swallowed and local-db-reset.sh still printed success with exit 0.
Match the sibling db.migrate/db.seed_staging 'exit 1' handlers. (Task 3 review.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…est cleanup, curved-grade coverage)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Local-Supabase follow-ups: rich seed + integration suite (#363, #362; #365 reverted)
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontend-staging01afb0cCommit Preview URL

Branch Preview URL
Jul 22 2026, 07:25 AM

@coderabbitai

coderabbitaiBot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Free

Run ID: e4d44a8a-4221-4486-8643-0bfa6e4e384c

📥 Commits

Reviewing files that changed from the base of the PR and between 8465e40 and 01afb0c.

📒 Files selected for processing (15)
  • .github/workflows/integration.yml
  • backend/db/seed_helpers.py
  • backend/db/seed_local_rich.py
  • backend/db/seed_staging.py
  • backend/tests/conftest.py
  • backend/tests/integration/__init__.py
  • backend/tests/integration/conftest.py
  • backend/tests/integration/test_local_stack.py
  • backend/tests/test_seed_helpers.py
  • backend/tests/test_seed_local_rich.py
  • backend/tests/test_seed_staging.py
  • docs/local-supabase.md
  • docs/superpowers/plans/2026-07-21-local-supabase-followups.md
  • docs/superpowers/specs/2026-07-21-local-supabase-followups-design.md
  • scripts/lib/local-common.sh

📝 Walkthrough

Walkthrough

A shared seed-helper module, guarded rich local dataset seed, opt-in Supabase integration suite, CI workflow, local reset hook, and supporting documentation were added. Staging seeding now delegates idempotency and summary handling to the shared helpers.

Changes

Local Supabase seeding

Layer / File(s)Summary
Shared seed idempotency and staging integration
backend/db/seed_helpers.py, backend/db/seed_staging.py, backend/tests/test_seed_helpers.py, backend/tests/test_seed_staging.py
Centralizes existence checks, conditional writes, created/skipped counters, and summaries, then routes staging seed operations and tests through those helpers.
Rich local dataset seed
backend/db/seed_local_rich.py, backend/tests/test_seed_local_rich.py, scripts/lib/local-common.sh, docs/local-supabase.md
Adds a local-only, deterministic, encrypted dataset seed and an opt-in SEED_RICH=1 reset step with usage documentation.
Local-stack integration suite
backend/tests/conftest.py, backend/tests/integration/*, .github/workflows/integration.yml
Adds integration marker handling, real local-stack fixtures, session minting, database/encryption/route tests, and a manually triggered CI workflow.
Follow-up design and verification records
docs/superpowers/plans/*, docs/superpowers/specs/*
Documents the seed, integration, CI, frontend migration, and verification plans represented by the follow-up work.

Estimated code review effort: 4 (Complex) | ~60 minutes

Sequence Diagram(s)

sequenceDiagram
participant Developer
participant GitHubActions
participant SupabaseCLI
participant seed_local_rich
participant pytest
participant FastAPI
Developer->>GitHubActions: dispatch integration workflow
GitHubActions->>SupabaseCLI: start local Supabase
GitHubActions->>seed_local_rich: migrate and seed database
GitHubActions->>pytest: run integration-marked tests
pytest->>FastAPI: call authenticated and anonymous routes
FastAPI-->>pytest: return database-backed decrypted responses
Loading

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

Comment @coderabbitai help to get the list of available commands.

@AndresL230
AndresL230 merged commit 6b2ceed into mainJul 22, 2026
6 checks passed
@AndresL230
AndresL230 deleted the feat/local-supabase-dev branch August 2, 2026 18:30
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@AndresL230