# crackercat/feed architecture

> Architecture diagram of the GitHub repository crackercat/feed, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/crackercat/feed
- Repository: https://github.com/crackercat/feed

## Overview

This is a small scheduled GitHub activity-report generator. Its workflow is to authenticate as the configured repository owner, collect today’s public events from users they follow, format qualifying events as Markdown, archive a prior-day README when applicable, and write the refreshed report. The script excerpt supports these calls and file operations; the scheduler configuration was not inspected, so no trigger relationship is shown.

Main entry points: [`daily_digest_high_freq.py`](https://github.com/crackercat/feed/blob/main/daily_digest_high_freq.py) (Report orchestrator), [`README.md`](https://github.com/crackercat/feed/blob/main/README.md) (Current report), [`archive`](https://github.com/crackercat/feed/tree/main/archive) (Archived reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_owner(("Repository owner"))
node_runner["Report orchestrator"]
node_collector["Event collector"]
node_formatter["Markdown formatter"]
node_archiver["Prior-day archiver"]
node_github["GitHub API"]
node_readme["Current report<br/>[README.md]"]
node_archive["Archived reports"]

node_owner -->|"configures"| node_runner
node_runner -->|"fetches events"| node_collector
node_collector -->|"requests events"| node_github
node_runner -->|"formats events"| node_formatter
node_formatter -->|"formats event data"| node_collector
node_runner -->|"checks prior report"| node_archiver
node_archiver -->|"reads report"| node_readme
node_archiver -->|"writes dated copy"| node_archive
node_runner -->|"writes report"| node_readme

click node_runner "https://github.com/crackercat/feed/blob/main/daily_digest_high_freq.py"
click node_collector "https://github.com/crackercat/feed/blob/main/daily_digest_high_freq.py"
click node_formatter "https://github.com/crackercat/feed/blob/main/daily_digest_high_freq.py"
click node_archiver "https://github.com/crackercat/feed/blob/main/daily_digest_high_freq.py"
click node_readme "https://github.com/crackercat/feed/blob/main/README.md"
click node_archive "https://github.com/crackercat/feed/tree/main/archive"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_owner toneIndigo
class node_runner,node_collector,node_formatter,node_archiver,node_readme,node_archive toneTeal
class node_github toneMint
```

## Components

### Other components

- **Repository owner**
- [Report orchestrator](https://github.com/crackercat/feed/blob/main/daily_digest_high_freq.py): `daily_digest_high_freq.py`
- [Event collector](https://github.com/crackercat/feed/blob/main/daily_digest_high_freq.py): `daily_digest_high_freq.py`
- [Markdown formatter](https://github.com/crackercat/feed/blob/main/daily_digest_high_freq.py): `daily_digest_high_freq.py`
- [Prior-day archiver](https://github.com/crackercat/feed/blob/main/daily_digest_high_freq.py): `daily_digest_high_freq.py`
- **GitHub API**
- [Current report](https://github.com/crackercat/feed/blob/main/README.md): `README.md`
- [Archived reports](https://github.com/crackercat/feed/tree/main/archive): `archive`

## Connections

- Repository owner → Report orchestrator: configures (evidence: `daily_digest_high_freq.py`)
- Report orchestrator → Event collector: fetches events (evidence: `daily_digest_high_freq.py`)
- Event collector → GitHub API: requests events (evidence: `daily_digest_high_freq.py`)
- Report orchestrator → Markdown formatter: formats events (evidence: `daily_digest_high_freq.py`)
- Markdown formatter → Event collector: formats event data (evidence: `daily_digest_high_freq.py`)
- Report orchestrator → Prior-day archiver: checks prior report (evidence: `daily_digest_high_freq.py`)
- Prior-day archiver → Current report: reads report (evidence: `daily_digest_high_freq.py`)
- Prior-day archiver → Archived reports: writes dated copy (evidence: `daily_digest_high_freq.py`)
- Report orchestrator → Current report: writes report (evidence: `daily_digest_high_freq.py`)
