Your AI News.
Automated. Daily.

flowchart TD
    subgraph Schedulers
        A1[macOS launchd]
        A2[Windows Task Scheduler]
    end

    A1 -->|8:00 AM daily| B1[briefing.sh]
    A2 -->|8:00 AM daily| B2[briefing.ps1]

    B1 -->|Reads| C[prompt.md]
    B2 -->|Reads| C

    B1 -->|Invokes| D[Claude Code CLI]
    B2 -->|Invokes| D

    D -->|Step 0: Dedup| N0[Notion MCP - Read Previous]
    N0 -->|Already covered stories| D
    D -->|Step 1: Search| E[WebSearch Tool]
    E -->|9 topics x multiple queries| F[Web Results]
    F -->|Step 2: Compile| G[Two-Tier Briefing]
    G -->|Step 3: Write| H[Notion MCP - Create Page]
    H -->|Creates page| I[(Notion Database)]

    B1 -->|Logs output| J[logs/YYYY-MM-DD.log]
    B2 -->|Logs output| J

    B1 -->|If webhook set| T1[notify-teams.sh]
    B2 -->|If webhook set| T2[notify-teams.ps1]
    T1 & T2 --> PY[build-teams-card.py]
    PY --> TW[Teams Webhook]
    TW --> TC[Teams Channel]
      

sequenceDiagram
    participant S as Scheduler
    participant E as Entry Script
    participant C as Claude Code
    participant NR as Notion (Read)
    participant W as WebSearch
    participant NW as Notion (Write)
    participant TW as Teams Webhook

    Note over S: 08:00 AM or manual trigger
    S->>E: Execute entry script
    E->>E: Setup env, create log dir
    E->>E: Read prompt.md
    E->>C: claude -p --model sonnet

    C->>NR: Fetch previous briefing
    NR-->>C: Yesterday's stories

    loop For each of 9 topics
        C->>W: Search query
        W-->>C: Results
    end

    C->>C: Filter duplicates
    C->>C: Compile TLDR tier
    C->>C: Compile Full Briefing
    C->>C: Build Key Takeaways

    C->>NW: Create page with briefing
    NW-->>C: Page URL
    C-->>E: Done
    E->>E: Log result

    opt Teams webhook configured
        E->>E: notify-teams.sh / .ps1
        E->>E: build-teams-card.py (parse log)
        E->>TW: POST Adaptive Card to webhook
        TW-->>E: 202 Accepted
    end
      

flowchart TD
    A[Entry script starts] --> B{Log dir exists?}
    B -->|No| C[Create it]
    B -->|Yes| D[Continue]
    C --> D
    D --> E{CLAUDECODE env set?}
    E -->|Yes| F[Clear it]
    E -->|No| G[Continue]
    F --> G
    G --> H[Invoke Claude Code]
    H --> I{Budget exceeded?}
    I -->|Yes| J[Exit with error]
    H --> K{Search failures?}
    K -->|Partial| L[Note: No updates for topic]
    K -->|Total| M[Empty briefing]
    H --> N{Notion API error?}
    N -->|Yes| O[Report in output]
    H --> P{Success}
    J --> Q[Log: FAILED]
    M --> Q
    O --> Q
    L --> P
    P --> R[Log: Complete]
    Q --> S[Cleanup old logs]
    R --> S
      

flowchart LR
    A[Briefing Log] --> B[build-teams-card.py]
    B --> C[Adaptive Card JSON]
    C --> D[Power Automate Webhook]
    D --> E[Teams Channel]