nexus_github_check

A Val Town microservice that monitors the Ryizome GitHub repository and reports commit activity to the DDCT Nexus monitoring system.

This service fetches commit data from the GitHub API and tracks:

• Last commit timestamp
• Number of commits in the last 24 hours
• Number of commits in the last 48 hours
• Number of commits in the last 7 days
• Last commit author, message, and SHA

The data is reported to the nexus service and appears in the daily status report sent via Telegram.

GITHUB_PAT (required): GitHub Personal Access Token with repository read access

To create a GitHub PAT:

1. Go to GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
2. Generate new token with repo scope (or use fine-grained token with Contents: Read-only)
3. Add the token to Val Town environment variables

Recommended: Daily execution (e.g., midnight UTC)

Set in Val Town dashboard when creating the interval val.

1. Create a new Val in Val Town
2. Set as interval type
3. Add GITHUB_PAT environment variable
4. Copy code from main.tsx
5. Set schedule to daily
6. Save and test

Or use vt CLI:

cd nexus_github_check
vt push

The service reports to nexus with service name RyizomeGitHub.

Check the daily report in Telegram for status:

RyizomeGitHub: 🟩 (OK)
  📊 3/5/18 commits (24h/48h/7d)
  ⏱️  Last: 2h ago by aeone
  💬 "Update nexus tracking system"

If the GitHub API check fails:

• Error is logged to console
• ERROR status is reported to nexus
• Daily report shows: RyizomeGitHub: 🟥 (ERROR)

Common errors:

• Missing or invalid GITHUB_PAT
• GitHub API rate limit (unlikely with daily checks)
• Network connectivity issues
• Repository access issues

• node:crypto - For checksum generation
• Val Town SQLite - Used by nexus for data storage
• GitHub REST API v3