SciDEX — Task: [Artifacts] Demo notebook registry filters and sho

Add demo-focused filtering/sorting on /notebooks so Allen/SEA-AD/aging showcase artifacts are easier to discover; include metadata chips and a spotlight section for top demo notebooks. ## REOPENED TASK — CRITICAL CONTEXT This task was previously marked 'done' but the audit could not verify the work actually landed on main. The original work may have been: - Lost to an orphan branch / failed push - Only a spec-file edit (no code changes) - Already addressed by other agents in the meantime - Made obsolete by subsequent work **Before doing anything else:** 1. **Re-evaluate the task in light of CURRENT main state.** Read the spec and the relevant files on origin/main NOW. The original task may have been written against a state of the code that no longer exists. 2. **Verify the task still advances SciDEX's aims.** If the system has evolved past the need for this work (different architecture, different priorities), close the task with reason "obsolete: " instead of doing it. 3. **Check if it's already done.** Run `git log --grep=''` and read the related commits. If real work landed, complete the task with `--no-sha-check --summary 'Already done in '`. 4. **Make sure your changes don't regress recent functionality.** Many agents have been working on this codebase. Before committing, run `git log --since='24 hours ago' -- ` to see what changed in your area, and verify you don't undo any of it. 5. **Stay scoped.** Only do what this specific task asks for. Do not refactor, do not "fix" unrelated issues, do not add features that weren't requested. Scope creep at this point is regression risk. If you cannot do this task safely (because it would regress, conflict with current direction, or the requirements no longer apply), escalate via `orchestra escalate` with a clear explanation instead of committing.

Git Commits (1)

[Artifacts] Add demo notebook registry filters and showcase highlighting2026-04-04

Spec File

Goal

Enhance the /notebooks page to better showcase SciDEX's demo artifacts — particularly Allen Institute data analyses, SEA-AD cohort studies, and aging research notebooks. Add filtering, sorting, metadata chips, and a spotlight section to make high-value demo notebooks immediately discoverable. This supports Quest 16 (Demo Showcase) and Quest 17 (Rich Artifacts) by making the most impressive notebooks easier to find.

Acceptance Criteria

☐ /notebooks page has filter controls (by tags: Allen Institute, SEA-AD, aging, protein structure, etc.)

☐ Sort options (by creation date, analysis link count, title alphabetically)

☐ Each notebook card shows metadata chips (tags, creation date, linked analyses)

☐ Spotlight section at top highlights 3-5 top demo notebooks with rich descriptions

☐ Page renders in <2s, no broken links

☐ Mobile-responsive design maintains readability

Approach

Read current api.py notebook registry implementation (/notebooks route)

Query notebooks table to understand available metadata fields

Add filter/sort query parameters to notebook route handler

Enhance notebook metadata with tags (Allen Institute, SEA-AD, aging, etc.) — add to DB if needed

Build HTML filter controls and sort dropdown in f-string template

Create spotlight section with hand-picked top notebooks (hardcoded or from DB flag)

Style with existing SciDEX design language (dark theme, blue accents)

Test rendering, verify all links work

Commit and push

Dependencies

None (standalone enhancement to existing /notebooks page)

Dependents

Demo showcase improvements benefit from better notebook discoverability

Work Log

2026-04-04 — Slot 11

Started task: reading spec requirements
Examined current /notebooks implementation in api.py (line 22216)
Applied notebooks table migration (001_create_notebooks_table.py)
Added tags column to notebooks table (ALTER TABLE)
Added is_spotlight column to notebooks table (ALTER TABLE)
Enhanced notebooks_page() function with:

- Tag filtering via query parameter
- Sort options (date/title/analyses) via query parameter
- Filter controls UI with tag chips
- Sort dropdown
- Spotlight section for featured notebooks
- Metadata chips on each card (tags and entities)
- Better empty states

Verified Python syntax: valid
Next: test page rendering, commit, merge to main, restart API

Payload JSON

{
  "_stall_skip_providers": [],
  "_stall_requeued_by": "minimax",
  "_stall_requeued_at": "2026-04-14 00:34:41",
  "_stall_skip_at": {},
  "_stall_skip_pruned_at": "2026-04-14T10:37:14.022390+00:00"
}