02 Features

02. Features & Subsystems

Detailed specification of the 14 core operational modules in PACT OS.

---

📋 1. Task Management & Timeblocking (/app/tasks)

The Task Engine allows users to schedule, prioritize, and track action items:

• Speed-First Sealing: Modal form allowing commitment sealing in under 5 seconds.
• Priority Levels: low, medium, high, urgent.
• Status Lifecycle: pending ➔ in_progress ➔ completed / missed ➔ archived.
• Parent Hierarchy: Optional linking to parent Goals and Projects.
• Timezone Awareness: Localized wall-clock inputs converted to UTC TIMESTAMPTZ.

---

🎯 2. Strategic Goals & Projects (/app/goals, /app/projects)

• Goals Workspace: Define high-leverage quarterly objectives with target completion dates and progress tracking (progress_percentage).
• Projects Hub: Group deliverables under color-coded project cards (color_accent), status tracking (active, completed, paused, archived), and task rollups.

---

🔄 3. Habits & Daily Routines (/app/habits)

• Habit Streaks: Track daily, weekly, or custom recurring habits with streak counters and consistency percentages.
• Daily Routines: Morning and evening routine templates (daily_routines & routine_items) with quick completion toggles.
• Leap-Year Math: Timezone-accurate day-boundary calculations ensuring streak preservation during leap years and timezone transitions.

---

💰 4. Financial Discipline Ledger (/app/finance)

• Integer-Cents Arithmetic: All monetary transactions store amount_cents (bigint) to guarantee precision.
• Category Breakdown: Categorize income and expenses with HSL-tailored color tags (gold, blue, emerald, amber, etc.).
• Budget Envelopes: Set category-specific spending thresholds with real-time budget utilization progress bars.
• Monthly Trends: Multi-month historical cashflow comparison (Income vs. Expense vs. Net Savings).

---

⏱️ 5. Deep Work Focus Engine (/app/focus)

• Session Timer: Customizable Pomodoro and deep work timers with target duration (target_duration_minutes) and actual completion logging.
• Offline Audio Synthesizer: Client-side Web Audio synthesizer (src/lib/focus/sound.ts) providing focus soundscapes without external audio assets or network requests.
• Interruption Logging: Track focus session completion status (completed, interrupted, abandoned).

---

📊 6. Analytics & Velocity Metrics (/app/analytics)

• Discipline Velocity Score: Aggregate scoring computed from task completion rates, habit consistency, and focus minutes.
• Streak Velocity: Historical streak distribution charts.
• Data Visualizations: Glassmorphic charts rendering timeblock efficiency and goal progress metrics.

---

📅 7. Calendar & Time-Blocking (/app/calendar)

• Schedule View: Visual daily calendar displaying timeblocks and scheduled tasks.
• Google Calendar Sync: Bi-directional integration (src/lib/integrations/google-calendar.ts) for syncing PACT tasks with Google Calendar events.

---

📝 8. Weekly Review & Sunday Ritual (/app/review)

• 5-Step Reflection Wizard:
  1. Review past week's task completion and velocity.
  2. Audit habit consistency.
  3. Evaluate financial cashflow.
  4. Perform backlog cleanup and task carryover.
  5. Set next week's top 5 priority commitments.
• Sunday Ritual Automation: Prompts users on their designated review day (weekly_review_day).

---

🛡️ 9. Accountability & Consequence Engine (/app/accountability)

• Consequence Types: written_reflection, public_declaration, emergency_task, financial_pledge.
• Payload Masking: Consequence parameters remain masked in the database until activated upon deadline breach.
• Waiver Requests: Managed grace-period waivers with justification logging (commitment_waivers).

---

🔔 10. Multi-Channel Notification Dispatcher (src/lib/notifications)

• Notification Types: Deadline warnings, consequence activations, habit reminders, weekly review prompts.
• Delivery Channels: In-app popovers (NotificationPopover), mobile push notifications, and browser alerts.

---

🔗 11. External Proof Connectors (src/lib/integrations)

• GitHub Connector: Validates commit hashes and PR URLs via GitHub REST API.
• LeetCode Connector: Validates GraphQL problem submission payloads (recentSubmissionList).
• Codeforces Connector: Validates contest submission status and rating tier badges.

---

🔑 12. WebAuthn & Passkey Authentication (src/lib/auth)

• Passkey Support: Register and authenticate using hardware security keys, Touch ID, or Face ID (20260912000000_passkey_credentials.sql).
• Cryptographic Challenge: Server-generated 32-byte base64url challenge tokens with replay attack protection.

---

⚡ 13. Command Center (/app Overlay)

• Fuzzy Search: Global search overlay (KeyboardShortcutsModal & Command Palette) indexing tasks, goals, habits, projects, and finance items.
• Keyboard Navigation: Full hotkey accessibility (e.g. Cmd+K, Esc).

---

📦 14. Data Portability & Privacy (/api/user/export)

• Full Data Export: Export user data as a sanitized ZIP archive containing JSON/CSV datasets.
• Privacy Sanitization: Strips session tokens, OAuth keys, and password hashes prior to archive generation.