OSIT-AE-App-Svelte/documentation/TODO__Agents.md

Frontend Agent Task List

Use this file to track steps for complex features or bug fixes. Status: <20> Stable — ongoing development.

📋 Open: Security

• PUBLIC_AE_API_SECRET_KEY Audit: Conduct full audit of usage. Determine if it can be moved to server-side only.

🚧 Upcoming High Priority

[Launcher] Active features (identified 2026-03-06)

• Font size cycler (Launcher sidebar): Staff onsite may not have access to the system menu, so the launcher sidebar needs its own font size cycler. Add font_size_step: number to $events_loc.launcher store. Add a cycle button in launcher_menu.svelte alongside the "All Files"/"All Sessions" show/hide buttons. Three steps: compact (text-xs) → default (text-sm) → large (text-base). Apply the class to the launcher sidebar root container <div>.

• Minor Svelte warning: slct_event_location_id prop in menu_location_list.svelte is not $bindable() but bind:value={slct_event_location_id} is used. Functionally fine since onchange writes directly to $events_slct.event_location_id.

[Svelte] State reference warnings

• 42 state_referenced_locally warnings remain in recovery_meetings/ae_idaa_comp__event_obj_id_edit.svelte and ..._v2.svelte. Same pattern as the 10 fixed on 2026-03-09 — move reactive reads into onMount.

[Badges] Remaining badge work before first live event

• Badge print controls UX polish: Scott has improvements in mind — TBD next session. File: ae_comp__badge_print_controls.svelte.

[Leads] Exhibitor Lead Scanning — NEXT MAJOR FEATURE

QR code scan at exhibitor booth → capture attendee badge data. Gated by allow_tracking on the badge. Check if documentation/MODULE__AE_Events_Leads.md exists for full spec. Key questions before starting: which routes, does the Electron app scan, what does the lead record look like in the DB?

[DevOps] Remaining deployment items

• Wire AE_APP_REPLICAS: docker-compose.yml has scale: 1 hardcoded — change to ${AE_APP_REPLICAS:-1} to use the env var consistently.
• Archive ae_env_node_app: The old Red/Green/Blue node env has been superseded by the unified aether_container_env. Archive or move that directory once confirmed nothing depends on it.
• Build Optimization: Explore using a private container registry to separate build from deploy (build once, deploy anywhere).

[General]

• Temp Cleanup: Auto-removal of native .tmp files older than 24h.
• window.print() for badge print button: Wire the existing handle_print_badge() to trigger window.print(). Browser print works well across Chrome/Chromium/Firefox — no Electron needed.
• Input Field Audit: Several input fields are missing name/id attributes or data-testid. Known examples: badge override fields in ae_comp__badge_obj_view.svelte; template name input in ae_comp__badge_template_form.svelte. Matters for: accessibility, autofill, label associations, and test targeting. (For tests, use getByLabel() rather than input[value*=...] which only checks the HTML attribute, not the Svelte-bound DOM property.)

[UX] Session Expired & Access Denied (identified 2026-03-10)

Two related UX gaps to handle together:

1. Session Expired banner (API 401/403 mid-session):

• flag_expired in root +layout.svelte is declared but never set — it was always intended for this
• Add a small writable store or custom event (e.g., ae_auth_error in ae_stores) that API helpers (api_get_object.ts, api_post_object.ts, api_patch_object.ts) can fire when they get a 401 or 403
• Root layout watches the store and sets flag_expired = true
• Render a non-blocking dismissible banner (not full-screen): "Session expired. Please sign in again." with a link to the sign-in control
• Especially relevant for Launcher (event staff on tablets may not notice silent failures)

2. Standardize Access Denied UI (non-IDAA routes only — IDAA layout is intentionally custom):

• Currently inconsistent across the app:
  • Root layout: full-screen flag_denied (site access key gate — keep this, it's correct)
  • /core layout: silent redirect to home — should show a brief message instead
  • /events/[event_id]/settings: inline raw text string — should use a consistent banner component
  • /events/.../badges/.../review: inline <h3>Access Denied</h3> with no context or action
• Create a reusable element_access_denied.svelte component (small: icon + message + optional action button)
• Swap the ad-hoc patterns to use it consistently

✅ Completed (2026-03)

• [DevOps] Frontend + Backend unified into single aether_container_env Docker Compose. ae_app service live with healthcheck, single exposed port (AE_APP_NODE_PORT), internal ae_api networking. Deploy scripts in package.json both target ../aether_container_env/docker-compose.yml. (2026-03-10)
• [DevOps] /health endpoint live at src/routes/health/+server.ts. Docker HEALTHCHECK uses it. (2026-03-10)
• [UI] Dark mode color-scheme fix — html.dark/light { color-scheme } in app.css; all native browser controls now sync to app dark mode. (2026-03-10)
• [Launcher] Location select → session auto-load bug fixed via $derived.by() liveQuery pattern. (2026-03-10)
• [Svelte] state_referenced_locally warning fixes — 10 warnings resolved in IDAA archives/BB. (2026-03-09)
• [TypeScript] Sign In/Out TS errors fixed — user_id / person_id typed as string | null. (2026-03-09)
• [Tests] All badge data integrity and attendee workflow Playwright tests passing. Root causes documented in tests/README.md. (2026-03)
• [Badges] Badge print controls panel, QR code, duplex wiring, review form, print button, multi-word fulltext search, data-testid attributes. (2026-03)
• [UI] Firefly Theme + Pres Mgmt Visual Redesign (5 files). (2026-03-06)
• [Docs] UI Style Guidelines + Component Patterns docs created. (2026-03-06)
• [API] V3 Lookup system integration; Event File V3 mapping; event_session search 400-error fix. (2026-02/03)
• [API] All CRUD helpers on V3 /v3/crud/... paths. (2026-02)
• [Security] Purged x-aether-api-token; fixed misplaced CORS headers; Account ID Scavenging. (2026-02)
• [Security] Playwright integration tests replace verify_jwt_logic.js simulation tests. (2026-03)
• [Framework] AE_Obj_Field_Editor_V3 with Svelte 5 Runes. CRUD v2 fully retired. (2026-03-05)
• [IDAA] Bulletin Board and Recovery Meetings functionality verified. (2026-02)