AI News Briefing
Comprehensive Project Wiki

flowchart LR
    subgraph Schedulers
        A1["macOS launchd"]
        A2["Windows Task Scheduler"]
        A3["Manual / make run"]
    end
    A1 --> B["briefing.sh / .ps1"]
    A2 --> B
    A3 --> B
    B --> C["prompt.md"]
    C --> D["AI Engine (Claude/Codex/Gemini/Copilot)"]
    D --> E["WebSearch (9 topics)"]
    D --> F["Notion MCP"]
    F --> G["Notion Page"]
    D --> H["card.json"]
    D --> OBS["obsidian.md"]
    B --> I{"Teams webhook?"}
    I -->|Yes| J["notify-teams"]
    J --> K["Teams Channel"]
    B --> L{"Slack webhook?"}
    L -->|Yes| M["notify-slack"]
    M --> N["Slack Channel"]
    B --> OC{"Obsidian vault?"}
    OC -->|Yes| OP["publish-obsidian"]
    OP --> OV["Obsidian Vault +\nGraph View"]
    

flowchart TD
    A[Entry script exits success] --> B{card.json exists?}
    B -->|No| B1[Notify paths fail fast]
    B -->|Yes| T{Teams webhook env set?}
    B -->|Yes| S{Slack webhook env set?}

    T -->|No| T0[Skip Teams]
    T -->|Yes| T1[notify-teams]
    T1 --> T2{JSON valid + URL list valid?}
    T2 -->|No| T3[Teams notify failed]
    T2 -->|Yes| T4[POST to first URL or all URLs]

    S -->|No| S0[Skip Slack]
    S -->|Yes| S1[notify-slack]
    S1 --> S2{teams-to-slack conversion OK?}
    S2 -->|No| S3[Slack notify failed]
    S2 -->|Yes| S4[POST Block Kit to first URL or all URLs]

    A --> OB{obsidian.md exists?}
    OB -->|No| OB0[Skip Obsidian]
    OB -->|Yes| OC{Vault env set + writable?}
    OC -->|No| OC0[Obsidian publish skipped]
    OC -->|Yes| OC1[publish-obsidian]
    OC1 --> OC2[Copy to AI-News-Briefings/]
    OC1 --> OC3["Extract [[wikilinks]]"]
    OC3 --> OC4[Create Topics/ stub pages]
    

flowchart LR
    A["Topic Input
(CLI flags or REPL)"] --> B["custom-brief.sh / .ps1"]
    B --> C["prompt-custom-brief.md"]
    C --> D["AI Engine"]
    subgraph "Phase 1: Parallel Discovery"
        D --> A1["Agent 1: Breaking News"]
        D --> A2["Agent 2: Technical Analysis"]
        D --> A3["Agent 3: Industry Impact"]
        D --> A4["Agent 4: Trends"]
        D --> A5["Agent 5: Policy"]
        D --> A6["Agent 6+: Topic-specific"]
    end
    A1 --> DD["Phase 2: Deep Dive"]
    A2 --> DD
    A3 --> DD
    A4 --> DD
    A5 --> DD
    A6 --> DD
    DD --> S["Phase 3: Synthesis"]
    S --> OUT["Terminal Output"]
    S -->|"--notion"| N["Notion Page"]
    S -->|"--teams/--slack"| CARD["Card JSON"]
    S -->|"--obsidian"| OBS["Obsidian Vault +\nGraph View"]
    CARD --> T["Teams"]
    CARD --> SL["Slack"]
    

graph TD
    subgraph "CLI Environments"
        CC[Claude Code]
        CX[OpenAI Codex]
        GM[Gemini CLI]
    end

    subgraph "Marketplace Catalogs"
        CMP[.claude-plugin/marketplace.json]
        CXMP[.agents/plugins/marketplace.json]
    end

    subgraph "Plugin Types (10 Available)"
        News[News & Media: ai-news, last30days, podcast-summarizer]
        Dev[Tech & Dev: trend-spotter, paper-reader, repo-auditor]
        Biz[Business: earnings, competitor-intel, startup-scout, crypto]
    end

    CC -->|/plugin install| CMP
    CX -->|Local UI| CXMP
    GM -->|extensions link| News
    GM -->|extensions link| Dev
    GM -->|extensions link| Biz

    CMP --> News
    CMP --> Dev
    CMP --> Biz

    CXMP --> News
    CXMP --> Dev
    CXMP --> Biz
    

flowchart LR
    A["Claude writes logs/YYYY-MM-DD-card.json"] --> B{"Channel notifier"}
    B --> C["notify-teams.sh / notify-teams.ps1"]
    B --> D["notify-slack.sh / notify-slack.ps1"]
    C --> E["POST Adaptive Card JSON to Teams webhooks"]
    D --> F["teams-to-slack.py conversion"]
    F --> G["POST Block Kit JSON to Slack webhooks"]

    H["Claude writes logs/YYYY-MM-DD-obsidian.md"] --> I["publish-obsidian.sh / .ps1"]
    I --> J["Copy to vault/AI-News-Briefings/"]
    I --> K["Extract [[wikilinks]]"]
    K --> L["Create Topics/ stub pages"]
    L --> M["Obsidian Graph View\nvisualizes topic connections"]
    

flowchart TD
    subgraph "Claude CLI Output"
        A["logs/YYYY-MM-DD-obsidian.md"]
    end

    subgraph "publish-obsidian.sh"
        B["Copy briefing to vault"]
        C["Extract all [[wikilinks]]"]
        D{"Topic stub exists?"}
        D -->|No| E["Create Topics/Name.md\nwith YAML frontmatter"]
        D -->|Yes| F["Skip (idempotent)"]
    end

    subgraph "Obsidian Vault"
        G["AI-News-Briefings/\n2026-04-11.md"]
        H["Topics/Claude Code.md"]
        I["Topics/OpenAI.md"]
        J["Topics/AI Coding IDEs.md"]
        K["Topics/..."]
    end

    A --> B --> G
    A --> C --> D
    G -.->|"[[Claude Code]]"| H
    G -.->|"[[OpenAI]]"| I
    G -.->|"[[AI Coding IDEs]]"| J
    H -.->|"graph edges"| I
    I -.->|"graph edges"| J
    

Graph View Concept

graph LR
    B1["2026-04-11\nDaily Briefing"] --> CC["Claude Code"]
    B1 --> OA["OpenAI"]
    B1 --> ACI["AI Coding IDEs"]
    B1 --> AG["Agentic AI"]
    B2["2026-04-10\nDaily Briefing"] --> CC
    B2 --> OA
    B2 --> MS["Mistral"]
    B2 --> HF["Hugging Face"]
    B3["2026-04-11\nCustom: AI Regulation"] --> POL["AI Policy"]
    B3 --> OA
    B3 --> EU["EU AI Act"]
    CC --> ANT["Anthropic"]
    ACI --> CUR["Cursor"]
    ACI --> WS["Windsurf"]
    style CC fill:#7c3aed,stroke:#a78bfa,color:#fff
    style OA fill:#7c3aed,stroke:#a78bfa,color:#fff
    style ACI fill:#7c3aed,stroke:#a78bfa,color:#fff
    style AG fill:#7c3aed,stroke:#a78bfa,color:#fff
    style MS fill:#7c3aed,stroke:#a78bfa,color:#fff
    style HF fill:#7c3aed,stroke:#a78bfa,color:#fff
    style POL fill:#7c3aed,stroke:#a78bfa,color:#fff
    style EU fill:#7c3aed,stroke:#a78bfa,color:#fff
    style ANT fill:#7c3aed,stroke:#a78bfa,color:#fff
    style CUR fill:#7c3aed,stroke:#a78bfa,color:#fff
    style WS fill:#7c3aed,stroke:#a78bfa,color:#fff
    style B1 fill:#1e3a5f,stroke:#3b82f6,color:#fff
    style B2 fill:#1e3a5f,stroke:#3b82f6,color:#fff
    style B3 fill:#1e3a5f,stroke:#3b82f6,color:#fff
    

flowchart TD
    subgraph "Bash (macOS / Linux / Git Bash)"
        R["tests/run-all.sh"] --> T1["test-custom-brief.sh\n48 tests"]
        R --> T2["test-daily-brief.sh\n80 tests"]
        R --> T3["test-notifications.sh\n17 tests"]
        R --> T4["test-portability.sh\n26 tests"]
        R --> T5["test-obsidian.sh\n30 tests"]
    end
    subgraph "PowerShell (Windows)"
        PS["tests/test-all.ps1\n91 tests"]
    end
    T1 --> X["Args, templates,\nprompts, skills, Obsidian flag"]
    T2 --> Y["Steps, topics,\nchangelogs, scripts, Obsidian"]
    T3 --> Z["Card JSON, converter,\nerror handling"]
    T4 --> W["Bash 3.2, awk, date,\nANSI safety"]
    T5 --> V["Vault structure, topic stubs,\nfrontmatter, idempotency"]
    PS --> X
    PS --> Y
    PS --> Z