OSIT-AE-App-Svelte/TODO.md

One Sky IT's Aether UI/UX Project TODO

This is a list of tasks to be completed before the next event/show/conference.

---

Current Priorities (Jan 8, 2026)

1. Journals Module Audit: Begin Phase 1 (Codebase Audit & Tailwind compliance).
2. Core UI Polish: Finalize Person and Address/Contact management forms using unified types.
3. Svelte 5 / Runes Migration: Continuous refactoring.

---

Frontier Journals Module (Vision 2026-01-08)

Goal: Transform Journals into the platform flagship with premium UI/UX and robust security.

• Phase 1: Codebase Audit & Schema
  • Audit src/lib/ae_journals and src/routes/journals for Tailwind compliance and code quality.
  • Refactor ae_comp__journal_entry_obj_id_view.svelte (Header, Editor, Settings extracted).
  • Fix type safety in [journal_id]/+layout.svelte (Recent entries history view).
  • [/] Verify db_journals.ts schema for metadata and encryption support.
  • Identify and replace non-standard CSS with Tailwind utility classes.
  • Update db_journals.ts types using the new agents_sync exported interfaces.

🛠️ DX & Tooling (MCP)

• Enhance ae_obj_info: Include field types, constraints (NOT NULL), and default values.
• Payload Validation: Create a dry-run tool to check payloads against Pydantic models.
• Error Transparency: Update backend to return specific SQLAlchemy/Pydantic errors in meta.details.
• Automated Source of Truth: Generate V3_OBJECT_MODELS.md automatically in agents_sync/Aether/.
• Phase 2: UI/UX Excellence
  • Implement "Quick Add" for high-velocity entry.
  • Add rapid append/prepend functionality to existing entries.
  • Ensure full cross-platform responsiveness (Mobile -> Workstation).
• Phase 3: Content Portability
  • Implement Structured Markdown import (with metadata).
  • Implement Bulk Export (Markdown, HTML) to file or clipboard.
  • Integrate Outbound Email sharing.
• Phase 4: Security & Privacy
  • Solidify E2EE passcode system for Journals and Entries.
  • Perform security audit on V3 Journal endpoints (including new auto-save).

---

Aether API CRUD V3 Integration

• Foundational Refinement:
  • Refactor core helpers and resolve Bootstrap Paradox.
• Core API Wrappers: ... (Completed)
• Unified Type Migration:
  • Establish src/lib/types/ae_types.ts.
  • Migrate all 42 active Aether modules (Identity, Logistics, Content, Storage).
  • Synchronize triple-ID patterns and hardened Promise return types across the stack.
• Module Migration: ... (Journals, Events, Core, IDAA mostly completed)

---

Core Module Improvements

• Person Management:
  • Create dedicated page/form for creating/editing person records.
  • Finalize Person-User linking.
• Address & Contact Management:
  • Implement full V3 CRUD UI (currently placeholders).
  • Create dynamic detail routes.

---

Development Workflow & Tools

• Backend Integration Tools:
  • Integrate schema_sync(obj_type) for automated TS interface generation.
  • Utilize sql_query(query) for DB state verification during debugging.
  • Use docker_restart / docker_logs for environment control.
• Refactor api.ts God Object:
  • Extract Lookup, Hosted File, Legacy CRUD, and Utility functions to dedicated modules.
  • Convert api.ts into a pure barrel file.

---

Recent Accomplishments (Jan 8, 2026)

• Journal Entry Refactor: Modularized the monolithic ae_comp__journal_entry_obj_id_view.svelte into JournalEntry_Header (w/ Settings) and JournalEntry_Editor components (~1000 lines reduced).
• Unified Type Migration (Phase 1-3): Established src/lib/types/ae_types.ts and migrated Account, Site, SiteDomain, Person, JournalEntry, Event, EventBadge, User, Address, Contact, and ActivityLog.
• API Robustness: Refactored all core helpers (get, post, patch, delete) for SvelteKit SSR parity and resolved the Bootstrap Paradox.
• System Testing Dashboard: Upgraded /testing with deep verification logic and created a CLI test suite.
• Backend Consistency: Confirmed 100% consistency between Pydantic models and V3 search whitelists for all primary AE objects.
• Tooling: Integrated ae_obj_info into the Aether Ops extension for real-time field and whitelist lookups.