AI News Briefing
Comprehensive Project Wiki

flowchart TD
    subgraph Triggers
        A1["macOS launchd"]
        A2["Windows Task Scheduler"]
        A3["Manual make run"]
    end

    A1 --> B1["briefing.sh"]
    A2 --> B2["briefing.ps1"]
    A3 --> B1
    A3 --> B2

    B1 --> C["prompt.md"]
    B2 --> C

    C --> D["AI Engine"]
    D --> E["WebSearch"]
    D --> F["Notion MCP"]
    F --> G["Notion briefing page"]

    D --> CS["logs/covered-stories.txt"]
    D --> H["logs/YYYY-MM-DD.log"]
    D --> I["logs/YYYY-MM-DD-card.json"]

    B1 --> JT{"AI_BRIEFING_TEAMS_WEBHOOK set?"}
    B2 --> JT
    JT -->|"No"| KT["Skip Teams"]
    JT -->|"Yes"| LT["notify-teams script"]
    LT --> MT{"card JSON exists and is valid?"}
    MT -->|"Yes"| NT["POST Adaptive Card to Teams webhooks"]
    MT -->|"No"| OT["Teams notify failed"]

    B1 --> JS{"AI_BRIEFING_SLACK_WEBHOOK set?"}
    B2 --> JS
    JS -->|"No"| KS["Skip Slack"]
    JS -->|"Yes"| LS["notify-slack script"]
    LS --> MS{"card JSON exists and conversion succeeds?"}
    MS -->|"Yes"| NS["Convert to Block Kit and POST to Slack webhooks"]
    MS -->|"No"| OS["Slack notify failed"]
      

sequenceDiagram
    participant S as Scheduler/Manual
    participant E as Entry Script
    participant C as AI Engine
    participant W as WebSearch
    participant N as Notion MCP
    participant T as notify-teams
    participant TW as Teams Webhook(s)
    participant SL as notify-slack
    participant SW as Slack Webhook(s)

    S->>E: Start briefing script
    E->>E: Setup date, logs, env
    E->>E: Refresh webhook env (Windows)
    E->>C: invoke selected engine (fallback chain)

    C->>C: Step 0a read logs/covered-stories.txt
    C->>N: Step 0b fetch most recent briefing
    N-->>C: prior coverage

    loop 9 topic areas
      C->>W: search recent news
      W-->>C: results
    end

    C->>N: Step 3 create today's page
    N-->>C: page URL

    C->>C: Step 5 append to covered-stories.txt

    C-->>E: exit 0 + output
    E->>E: append logs/YYYY-MM-DD.log

    opt Teams webhook configured
      E->>T: call notify-teams --all
      T->>T: validate card.json
      T->>TW: POST payload
      TW-->>T: 2xx
    end

    opt Slack webhook configured
      E->>SL: call notify-slack --all
      SL->>SL: convert card via teams-to-slack.py
      SL->>SW: POST Block Kit payload
      SW-->>SL: 2xx
    end
      

flowchart TD
    subgraph "Entry Points"
        SH["custom-brief.sh"]
        PS["custom-brief.ps1"]
        SK["/custom-brief skill"]
    end

    SH --> PT["prompt-custom-brief.md"]
    PS --> PT
    SK --> CC["AI Engine"]
    PT --> CC

    subgraph "Phase 1: Parallel Discovery"
        CC --> A1["Agent 1: Breaking News"]
        CC --> A2["Agent 2: Technical Analysis"]
        CC --> A3["Agent 3: Industry Impact"]
        CC --> A4["Agent 4: Trend Trajectory"]
        CC --> A5["Agent 5: Policy and Ethics"]
    end

    subgraph "Phase 2-3: Synthesis"
        A1 --> DD["Deep Dive Follow-ups"]
        A2 --> DD
        A3 --> DD
        A4 --> DD
        A5 --> DD
        DD --> SYNTH["Thematic Synthesis"]
    end

    subgraph "Output"
        SYNTH --> STDOUT["Terminal"]
        SYNTH -->|"--notion"| NOTION["Notion Page"]
        SYNTH -->|"--teams/--slack"| CARD["Card JSON"]
        CARD --> NT["notify-teams"]
        CARD --> NS["notify-slack"]
    end