How dst03106/issue-collector works
Project Type and Purpose
• This is an open-source, automated newsletter service (“IssueCollector”) that curates GitHub issues for contributor-friendly projects and delivers a periodic email.
• It can run interactively via an n8n workflow (Option 1) or fully automated on GitHub Actions (Option 2), using Node.js scripts, a Dockerized “lambda” package, and external APIs (GitHub, OpenRouter AI, DeepWiki, Gmail SMTP).
File Structure
Top level:
• .github/workflows/
– CI/CD pipelines to build/deploy the Docker image and to schedule/trigger the newsletter run via n8n CLI.
• lambda/
– A Docker context holding index.js (the entrypoint), cli.sh (wrapper), Dockerfile and Dockerfile.local. This packages the Node.js “function” that n8n uses.
• n8n.json
– The exported n8n workflow definition (graph of nodes).
• resources/
– A collection of JS modules, each implementing a function or LangChain agent (e.g., fetch issues, analyze root cause, generate titles, convert MJML to HTML, etc.).
• scripts/
– Tooling to import the workflow (import-workflow.js), build temp dirs, and shell entrypoints for local development.
README for Additional Insights
• Describes two execution modes, required secrets (GitHub token, OpenRouter key, Google App password), and high-level flow: load repo info → fetch issues → analyze with AI agents → assemble HTML newsletter → send email.
• Mentions use of GitHub Actions to schedule runs and AWS ECR as the Docker registry (inferred from deploy-to-aws-ecr.yml).