Error loading issues. Please refresh or contact us.
'; + } + } + + function setupEventListeners() { + const searchInput = document.getElementById('search-input'); + const statusSelect = document.getElementById('status-select'); + const agencySelect = document.getElementById('agency-select'); + const orgSelect = document.getElementById('org-select'); + const sortSelect = document.getElementById('sort-select'); + const clearButton = document.getElementById('clear-filters'); + + if (searchInput) searchInput.addEventListener('input', debounce(filterAndRender, 300)); + if (statusSelect) statusSelect.addEventListener('change', filterAndRender); + if (agencySelect) agencySelect.addEventListener('change', filterAndRender); + if (orgSelect) orgSelect.addEventListener('change', filterAndRender); + if (sortSelect) sortSelect.addEventListener('change', filterAndRender); + if (clearButton) clearButton.addEventListener('click', clearFilters); + } + + // Debounce function for search input + function debounce(func, wait) { + let timeout; + return function executedFunction(...args) { + const later = () => { + clearTimeout(timeout); + func(...args); + }; + clearTimeout(timeout); + timeout = setTimeout(later, wait); + }; + } + + function filterAndRender() { + applyFilters(); + renderIssues(); + updateResultsCount(); + } + + function applyFilters() { + const searchTerm = document.getElementById('search-input')?.value.toLowerCase().trim() || ''; + const statusFilter = document.getElementById('status-select')?.value || ''; + const agencyFilter = document.getElementById('agency-select')?.value || ''; + const orgFilter = document.getElementById('org-select')?.value || ''; + const sortBy = document.getElementById('sort-select')?.value || 'created-desc'; + + filteredIssues = allIssues.filter(issue => { + if (searchTerm) { + const searchFields = [ + issue.title || '', + issue.owner || '', + issue.repoName || '', + issue.author || '', + (issue.labels || []).join(' ') + ].join(' ').toLowerCase(); + + if (!searchFields.includes(searchTerm)) { + return false; + } + } + + if (statusFilter) { + if (statusFilter === 'Open' && !issue.isOpen) return false; + if (statusFilter === 'Closed' && issue.isOpen) return false; + if (statusFilter === 'Assigned' && !issue.hasAssignee) return false; + if (statusFilter === 'Unassigned' && issue.hasAssignee) return false; + if (statusFilter === 'Bug' && !issue.isBug) return false; + if (statusFilter === 'Feature' && !issue.isFeature) return false; + if (statusFilter === 'Help Wanted' && !issue.needsHelp) return false; + if (statusFilter === 'Good First Issue' && !issue.isBeginner) return false; + } + + if (agencyFilter && issue.owner !== agencyFilter) { + return false; + } + + if (orgFilter && issue.owner !== orgFilter) { + return false; + } + + return true; + }); + + filteredIssues.sort((a, b) => { + switch (sortBy) { + case 'created-desc': + return new Date(b.createdDate) - new Date(a.createdDate); + case 'created-asc': + return new Date(a.createdDate) - new Date(b.createdDate); + case 'modified-desc': + return new Date(b.lastUpdated) - new Date(a.lastUpdated); + case 'modified-asc': + return new Date(a.lastUpdated) - new Date(b.lastUpdated); + case 'name-asc': + return (a.title || '').localeCompare(b.title || ''); + case 'name-desc': + return (b.title || '').localeCompare(a.title || ''); + default: + return 0; + } + }); + } + + function clearFilters() { + const searchInput = document.getElementById('search-input'); + const statusSelect = document.getElementById('status-select'); + const agencySelect = document.getElementById('agency-select'); + const orgSelect = document.getElementById('org-select'); + const sortSelect = document.getElementById('sort-select'); + + if (searchInput) searchInput.value = ''; + if (statusSelect) statusSelect.value = ''; + if (agencySelect) agencySelect.value = ''; + if (orgSelect) orgSelect.value = ''; + if (sortSelect) sortSelect.value = 'created-desc'; + + filterAndRender(); + } + + function updateResultsCount() { + const resultsCount = document.getElementById('results-count'); + if (resultsCount) { + const total = filteredIssues.length; + if (total === 0) { + resultsCount.textContent = 'No results found'; + } else { + resultsCount.textContent = `Showing ${total} issues`; + } + } + } + + function createIssueCard(issue) { + const typeTags = []; + if (issue.isOpen) { + typeTags.push('Open'); + } else { + typeTags.push('Closed'); + } + + if (issue.isBug) typeTags.push('Bug'); + if (issue.isFeature) typeTags.push('Feature'); + if (issue.needsHelp) typeTags.push('Help Wanted'); + if (issue.isBeginner) typeTags.push('Good First Issue'); + + return ` +No issues found matching your filters.
'; + return; + } + + issuesGrid.innerHTML = filteredIssues.map(createIssueCard).join(''); + } + + // Escape HTML to prevent XSS + function escapeHtml(text) { + if (!text) return ''; + const div = document.createElement('div'); + div.textContent = text.toString(); + return div.innerHTML; + } + + function formatDate(dateString) { + if (!dateString) return 'N/A'; + try { + const date = new Date(dateString); + return date.toLocaleDateString(); + } catch (e) { + return 'Invalid Date'; + } + } + + if (document.readyState === 'loading') { + document.addEventListener('DOMContentLoaded', init); + } else { + init(); + } + + })(); \ No newline at end of file diff --git a/config/updateIssuePool.js b/config/updateIssuePool.js new file mode 100644 index 00000000..2dd3fbac --- /dev/null +++ b/config/updateIssuePool.js @@ -0,0 +1,182 @@ +const fs = require("fs").promises +const path = require('path') + +const CONFIG = { + repoFilePath: path.resolve(__dirname, "../codegov.json"), + issueFilePath: path.resolve(__dirname, "../issue-pool.json"), + regex: /https?:\/\/github\.com\/([^\/]+)\/([^\/]+)/, + githubToken: process.env.GITHUB_TOKEN, + requiredLabel: 'code-gov' +} + +// #region - Helper Functions +const getHeaders = () => { + const HEADERS = { + 'Accept': 'application/vnd.github.v3+json', + 'User-Agent': 'CodeGov-Issue-Pool-Updater', + 'Authorization': `token ${CONFIG.githubToken}` + } + return HEADERS +} + +async function getRepoInfo() { // dont know how i feel about this double loop setup... + let repoInfo = [] + + try { + const content = await fs.readFile(CONFIG.repoFilePath, "utf-8") // filter by tier 3 maturity to get the projects that truly want outside help + const jsonData = JSON.parse(content) + + for (const agencyKey in jsonData) { + const agency = jsonData[agencyKey] + + if (agency.releases) { + for (const organization of agency.releases) { + + if (organization.repositoryURL) { + const match = organization.repositoryURL.match(CONFIG.regex) + const [url, owner, repo] = match + + repoInfo.push({ + ownerName: owner, + repoName: repo + }) + } + } + } + } + } catch (error) { + console.error("Error in getting repo information:", error) + } + + // console.log(repoInfo) + return repoInfo +} + +function daysBetween(date1, date2) { + const diffTime = Math.abs(date2 - date1) + return Math.ceil(diffTime / (1000 * 60 * 60 * 24)) +} + +function checkLabelKeywords(labels, keywords) { + return labels.some(label => + keywords.some(keyword => + label.name.toLowerCase().includes(keyword.toLowerCase()) + ) + ) +} + +function transformIssue(issue, repo, repoLanguage) { + const now = new Date() + const createdDate = new Date(issue.created_at) + const updatedDate = new Date(issue.updated_at) + + const labelNames = issue.labels.map(label => label.name) + + return { + id: String(issue.id), + number: issue.number, + url: issue.html_url, + content_title: issue.title || "", + content_description: issue.body || "", + repo_name: repo.repoName, + repo_url: `https://github.com/${repo.ownerName}/${repo.repoName}`, + repo_language: repoLanguage || "", + repo_owner: repo.ownerName, + status_is_open: issue.state === 'open', + status_has_assignee: issue.assignee !== null, + status_is_locked: issue.locked, + time_created_date: issue.created_at, + time_last_updated: issue.updated_at, + time_days_old: daysBetween(createdDate, now), + time_last_activity_days_ago: daysBetween(updatedDate, now), + people_author: issue.user?.login || "", + people_assignee: issue.assignee?.login || null, + people_author_type: issue.user?.type || "", + labels_list: labelNames, + labels_count: labelNames.length, + labels_has_priority: checkLabelKeywords(issue.labels, ['priority', 'p0', 'p1', 'p2', 'urgent']), + labels_has_difficulty: checkLabelKeywords(issue.labels, ['difficulty', 'easy', 'medium', 'hard', 'beginner']), + engagement_comment_count: issue.comments || 0, + engagement_reaction_count: issue.reactions?.total_count || 0, + engagement_score: (issue.comments || 0) + (issue.reactions?.total_count || 0), + flags_is_beginner_friendly: checkLabelKeywords(issue.labels, ['beginner', 'good first issue', 'easy', 'starter']), + flags_needs_help: checkLabelKeywords(issue.labels, ['help wanted', 'needs help', 'assistance']), + flags_is_bug: checkLabelKeywords(issue.labels, ['bug', 'defect', 'error']), + flags_is_feature: checkLabelKeywords(issue.labels, ['feature', 'enhancement', 'feature request']), + flags_is_stale: checkLabelKeywords(issue.labels, ['stale', 'wontfix', 'abandoned']) + } +} + +// #region - Main Function +async function updateIssuePool() { + const issuePool = {} + const repoInfo = await getRepoInfo() + const headers = getHeaders() + + for (let i = 0; i < repoInfo.length; i++) { // switch to a forOf loop here? + const repo = repoInfo[i] + + try { + const repoUrl = `https://api.github.com/repos/${repo.ownerName}/${repo.repoName}` + const repoResponse = await fetch(repoUrl, { headers }) + + if (!repoResponse.ok) { + console.error(`Failed to fetch repo info for ${repo.ownerName}/${repo.repoName}: ${repoResponse.status}`) + continue + } + + const repoData = await repoResponse.json() + const repoLanguage = repoData.language || "" + + let page = 1 + let hasMore = true + + while (hasMore) { + const issuesUrl = `https://api.github.com/repos/${repo.ownerName}/${repo.repoName}/issues?page=${page}&per_page=100&state=open&labels=${CONFIG.requiredLabel}` + const issuesResponse = await fetch(issuesUrl, { headers }) + + if (!issuesResponse.ok) { + console.error(`Failed to fetch issues for ${repo.ownerName}/${repo.repoName}: ${issuesResponse.status}`) + break + } + + const issues = await issuesResponse.json() + + // endpoint always returns both issues and pull requests so we ignore the PRs + for (const issue of issues) { + if (issue.pull_request) { + continue + } + + + const transformedIssue = transformIssue(issue, repo, repoLanguage) + issuePool[transformedIssue.id] = transformedIssue // is having the ID is the best key name? + } + + if (issues.length < 100) { + hasMore = false + } + + page++ + } + + console.log(`✅ Processed ${i + 1}/${repoInfo.length}: ${repo.ownerName}/${repo.repoName}`) + + } catch (error) { + console.error(`❌ Error processing ${repo.ownerName}/${repo.repoName}:`, error) + continue + } + } + + try { + await fs.writeFile(CONFIG.issueFilePath, JSON.stringify(issuePool, null, 2)) + console.log(`Successfully saved issues!`) + } catch (error) { + console.error("Error saving issue pool:", error) + } + + return issuePool +} + +// getRepoInfo() +updateIssuePool() \ No newline at end of file diff --git a/content/issues/index.md b/content/issues/index.md new file mode 100644 index 00000000..272caeee --- /dev/null +++ b/content/issues/index.md @@ -0,0 +1,23 @@ +--- +title: Open Issues +description: 'Browse open source issues from federal government projects' +permalink: /issues/ +layout: layouts/page +tags: codegov +eleventyNavigation: + parent: codegov-issues + key: codegov-issues-main + order: 1 + title: Open Issues +sidenav: false +sticky_sidenav: false +templateEngineOverride: liquid, html +--- + ++ Browse federal open source projects and discover issues where your skills can make a difference +
++ Search through issues from federal repositories, filter by popularity or difficulty, and find ways to contribute to government open source technology +
++ Repository maintainers can include their projects by adding a code-gov label + to GitHub issues, making them discoverable to developers ready to contribute +
+