index.md

ThreeDoors Architecture Document

Table of Contents

• ThreeDoors Architecture Document
  • Table of Contents
  • Introduction
    • Starter Template or Existing Project
    • Change Log
  • High Level Architecture
    • Technical Summary
    • High Level Overview
      • Phase 1: Tech Demo
      • Phase 2–3: Post-MVP Layered Architecture
    • High Level Project Diagrams
    • Architectural and Design Patterns
  • Tech Stack
    • Cloud Infrastructure
    • Technology Stack Table
    • Post-MVP Technology Additions
    • Makefile Targets
  • Data Models
    • TaskStatus (Enum)
    • Task
    • TaskNote
    • Config
    • TaskPool
    • DoorSelection
    • Data Model Diagram
  • Components
    • Component Overview
    • TUI Layer Components
      • Component: DoorsView (Three Doors Display)
      • Component: TaskDetailView
      • Component: StatusUpdateMenu
      • Component: NotesInputView
      • Component: MainModel (Root Bubbletea Model)
    • Domain Layer Components
      • Component: FileManager
      • Component: TaskPool
      • Component: StatusManager
      • Component: DoorSelector
    • Component Interaction Diagram
    • Post-MVP Components (Phase 2–3)
      • TUI: OnboardingView
      • TUI: SyncStatusBar
      • TUI: SourceBadge
      • Adapter: AdapterRegistry
      • Adapter: TaskProvider Interface
      • Adapter: AppleNotesAdapter
      • Adapter: ObsidianAdapter
      • Adapter: PluginSDK
      • Sync: SyncEngine
      • Sync: OfflineQueue
      • Sync: ConflictResolver
      • Intelligence: CalendarReader
      • Intelligence: LLMTaskDecomposer
      • Intelligence: LearningEngine
      • Aggregation: MultiSourceAggregator
      • Aggregation: DuplicateDetector
    • Post-MVP Component Interaction Diagram
  • Core Workflows
    • Workflow 1: Application Startup & Three Doors Display
    • Workflow 2: Select Door & Enter Task Detail View
    • Workflow 3: Update Task Status
    • Workflow 4: Add Progress Note
    • Workflow 5: Complete Task & Return to Doors
    • Workflow 6: Mark Task as Blocked
    • Post-MVP Workflows (Phase 2–3)
      • Workflow 7: Multi-Provider Startup & Aggregation
      • Workflow 8: Sync with Conflict Detection
      • Workflow 9: LLM Task Decomposition
      • Workflow 10: Calendar-Aware Door Selection
  • External APIs
  • REST API Spec
  • Data Models
    • Post-MVP Data Models
  • Data Storage Schema
    • tasks.yaml Schema
    • completed.txt Schema
    • Post-MVP Storage
      • config.yaml Schema
      • enrichment.db Schema (SQLite)
      • sync-state/ Directory
  • Source Tree
    • Post-MVP Source Tree
  • Infrastructure and Deployment
    • Infrastructure as Code
    • Deployment Strategy
    • Environments
    • Rollback Strategy
  • Error Handling Strategy
    • General Approach
    • Logging Standards
    • Error Handling Patterns
      • File I/O Errors
      • YAML Parsing Errors
      • Status Transition Errors
      • Atomic Write Failures
    • Error Message Guidelines
  • Coding Standards
    • Core Standards
    • Naming Conventions
    • Critical Rules
    • Atomic Write Pattern Checklist
  • Test Strategy and Standards
    • Testing Philosophy
    • Test Types
      • Unit Tests
      • Integration Tests
      • Manual Testing (TUI)
    • Test Data Management
  • PR Submission Standards
    • Rationale
    • Standards (NFR-CQ1 through NFR-CQ5)
    • Pre-PR Submission Checklist
    • Relationship to CI/CD
  • Security
    • Input Validation
    • Authentication & Authorization
    • Secrets Management
    • Data Protection
    • Dependency Security
    • Security Checklist
  • Agent Governance
    • Agent Interaction Architecture
    • Communication Protocol
    • Authority Boundaries
    • Anti-Patterns and Safeguards
    • Resource Budget and Scaling
    • Lifecycle Management
  • Checklist Results Report
    • Executive Summary
    • Section Pass Rates
    • Key Strengths
    • Improvements Made (v1.1)
    • Recommendations
    • Final Verdict
  • Next Steps
    • Immediate Next Steps: Begin Technical Demo Implementation
    • Updated Epic 1 Story Breakdown
      • Story 1.1: Project Setup & Basic Bubbletea App
      • Story 1.2: Data Models & YAML Schema
      • Story 1.3: File I/O & YAML Parsing
      • Story 1.4: Task Pool & Door Selection
      • Story 1.5: Three Doors Display (DoorsView)
      • Story 1.6: Door Refresh Mechanism
      • Story 1.7: Task Detail View
      • Story 1.8: Status Update Menu
      • Story 1.9: Notes Input
      • Story 1.10: Blocker Input
      • Story 1.11: Task Completion Flow
      • Story 1.12: Integration & Polish
    • Updated Time Estimate
    • Development Approach
    • Post-Validation Decision Gate
    • Quick Start Commands