Github Project Activity
Swamp-backed GitHub project activity database and maintainer briefing reports: repository/issue/PR/CI snapshots, chronological public/private activity events, artifacts, PR dossiers, and private/manual/agent maintainer notes.
2026.07.05.1
Changed: PR detail sync now always fetches PR files. The includeFiles input has been removed so PR snapshots and PR-file snapshots cannot drift apart when a PR is later merged.
Changed: PR-file snapshots now explicitly record whether the file was part of a merged PR with merged: true / merged: false, separately from the PR lifecycle state stored as prState: "open" / prState: "closed".
Changed: Codebase heatmap now trusts only explicit merged PR-file snapshots. Older markerless PR-file rows are ignored instead of guessed.
Upgrade note: This is a breaking data-interpretation change for existing heatmap ingestions. Re-run sync_github_prs or sync_github_backfill for the history window you want represented.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| githubToken? | string | GitHub token with read access to the repository; required by sync_github_* methods |
| owner? | string | Repository owner, e.g. external-secrets; required by sync_github_* methods |
| repo? | string | Repository name, e.g. external-secrets; required by sync_github_* methods |
| projectName? | string | Human-readable project name |
| knownForks | array | Known forks as owner/repo; indexed as metadata only |
| includePrivateEvents | boolean | Whether reports include private/manual/agent events by default |
| defaultBackfillWindowDays | number | |
| staleInactivityDays | number | Number of days without conversation or code changes before an open PR/issue becomes a stale candidate |
| personalGithubHandles | array | GitHub handles that represent the maintainer/operator using this ledger; reports and agent workflows can use them to distinguish your own comments, reviews, and follow-up obligations from external contributor activity |
| Argument | Type | Description |
|---|---|---|
| includeForkIndex | boolean |
| Argument | Type | Description |
|---|---|---|
| limit? | number | |
| includeConfiguredKnownForks | boolean |
| Argument | Type | Description |
|---|---|---|
| since? | string | |
| limit? | number | |
| includeComments | boolean | |
| includeTimeline | boolean |
| Argument | Type | Description |
|---|---|---|
| includePatchArtifacts | boolean | |
| includeReviews | boolean | |
| includeReviewComments | boolean | |
| includeIssueComments | boolean | |
| includeChecks | boolean | |
| includeTimeline | boolean |
| Argument | Type | Description |
|---|---|---|
| includePatchArtifacts | boolean | |
| includeReviews | boolean | |
| includeReviewComments | boolean | |
| includeIssueComments | boolean | |
| includeChecks | boolean | |
| includeTimeline | boolean |
| Argument | Type | Description |
|---|---|---|
| lookbackMinutes | number | |
| includeOpenPrs | boolean | |
| includeRecentlyUpdatedIssues | boolean |
| Argument | Type | Description |
|---|---|---|
| since? | string | |
| until? | string | |
| includeClosed | boolean | |
| limit? | number | |
| includeForkIndex | boolean |
| Argument | Type | Description |
|---|---|---|
| includePrs | boolean | |
| includeIssues | boolean | |
| staleLabel | string | |
| maxCandidates? | number | |
| dryRun | boolean |
| Argument | Type | Description |
|---|---|---|
| includePrs | boolean | |
| includeIssues | boolean | |
| staleLabel | string | |
| maxCandidates? | number | |
| dryRun | boolean |
| Argument | Type | Description |
|---|---|---|
| id? | string |
| Argument | Type | Description |
|---|---|---|
| name | string | |
| contentType | string | |
| content | string | |
| repo? | string | |
| subjectType? | string | |
| subjectNumber? | number | |
| description? | string |
| Argument | Type | Description |
|---|---|---|
| prNumber | number | |
| includePrivate? | boolean | |
| since? | string | |
| until? | string |
Resources
Files
Heatmap of current repository files by recent GitHub PR-file activity
Daily maintainer briefing from Swamp project activity snapshots and events
2026.07.03.5
Fixed: Codebase heatmap now filters PR-file touches, landed PR-file summary counts, and PR-file snapshot totals using the scoped repository plus PR number, avoiding cross-repository PR number collisions and mismatched totals.
Fixed: Codebase heatmap preserves legacy PR-file history with or without a retained merged PR snapshot. When only the PR-file row remains, it keeps the touch count but leaves the touch date unknown instead of treating the snapshot sync time as the last code touch time.
Fixed: Codebase heatmap ignores stale retained PR-file rows that are explicitly marked as not landed, avoiding false landed touches for files removed from a PR before merge or after PR snapshot retention cleanup.
Fixed: Codebase heatmap JSON keeps the existing counts.currentFilesWithTouches key as an alias of the new landed-touch count for dashboard compatibility.
Changed: PR-file snapshots now record landedAt when syncing merged PRs so future reports can classify retained file history without needing the PR snapshot. Open PR file snapshots leave landedAt unset, closed-unmerged snapshots use null, and merged PR syncs mark previously retained files that are no longer in the final PR file list as not landed.
Modified 1 models. Added 1 reports. updated labels
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned