Hashtag Rotator Service
🧬 Project Overview
Repository: pmmutiti/hashtag-rotator-service
Latest Commit: fa27f8e · Verified & Signed · 2 Days Ago
This commit refined diagnostics for webhook payload traceability — switching terminology from “Event routing” to “JSON snapshots” for public clarity.
📁 Diagnostics Directory
| Filename | Description |
|---|---|
delivery-log-*.txt | GitHub webhook delivery logs |
webhook-payloads/ | Event JSON snapshots (traceable) |
errors/ | Signature mismatches, malformed payloads |
📄 Line-by-Line Tree
| Line | Path | Purpose |
|---|---|---|
| 8585 | webhook-events.json | Event-to-handler routing map |
| 8686 | diagnostics/ | Webhook logs and error capture |
| 8787 | delivery-log-*.txt | Headers, timestamps, delivery metadata |
| 8888 | webhook-payloads/ | Archived JSON from GitHub events |
| 8989 | errors/ | Signature verification failures |
| 9090 | civic-preview.html | Live dashboard rendering testbed |
| 9191 | test.sh | Script for endpoint & uptime validation |
🧾 README Segment Snapshot
8585 └── webhook-events.json ← Event routing definitions 8686 ├── diagnostics/ 8787 │ ├── delivery-log-*.txt ← GitHub delivery traces (headers, IPs, timestamps) 8888 │ ├── webhook-payloads/ ← Raw JSON snapshots from incoming events 8989 │ └── errors/ ← Signature validation errors + tracebacks 9090 ├── civic-preview.html ← Visual template for headline rotation 9191 ├── test.sh ← Endpoint validation & uptime script
This structure gives remixers and civic technologists the full blueprint for debugging webhook behavior, tracing malformed requests, and inspecting output through both JSON logs and browser previews.
“A webhook that logs what it receives is more reliable than one that only reacts.”
🧪 Validation Tools
Use test.sh to manually confirm that endpoints like /api/webhook respond correctly.
Payload snapshots are recorded under
diagnostics/webhook-payloads. If they’re timestamped and growing, your webhook is live.