monitor

Resource Monitor — Track What Matters

Manage the feed subscription system (ADR-0127). Inngest cron checks subscriptions hourly, detects changes, summarizes via LLM, and notifies Joel via gateway with approve/dismiss for /cool publishing.

Joel's Interest Profile

Use this to assess whether a discovered resource is worth monitoring. If a resource clearly maps to 2+ of these, recommend monitoring with a brief explanation.

• Agentic AI — agent patterns, agent infrastructure, tool use, MCP, multi-agent systems
• Developer education — course platforms, learning design, course-builder ecosystem
• TypeScript tooling — Effect ecosystem, Bun, type-level programming, compiler work
• Inngest / durable workflows — event-driven systems, step functions, background jobs
• Personal AI systems — local-first AI, semantic memory, knowledge management, RAG
• BEAM / Elixir / OTP — Erlang ecosystem, actor model, fault tolerance
• Video infrastructure — Mux, transcription, media pipelines
• Next.js / React — RSC, App Router, cache components, Vercel platform
• CLI design — agent-first interfaces, HATEOAS, terminal UIs
• Knowledge management — Obsidian, digital gardens, PKM, zettelkasten
• Self-hosted infra — homelab, k8s, Tailscale, NAS, local services
• AT Protocol / Bluesky — decentralized web, PDS, lexicons
• Convex — real-time database, reactive backends

CLI Commands

# List all monitored subscriptions
joelclaw subscribe list

# Add a subscription (auto-detects type from URL)
joelclaw subscribe add <url> --name "Simon Willison" --interval hourly
joelclaw subscribe add <url> --name "json-render" --type github --interval daily

# Remove a subscription
joelclaw subscribe remove <id>

# Force-check a specific subscription now
joelclaw subscribe check --id <id>

# Force-check all subscriptions
joelclaw subscribe check

# Show recent updates across all subscriptions
joelclaw subscribe summary

Direct Inngest Fallback (alternative)

# Add subscription via event
joelclaw send subscription/add -d '{
  "id": "simon-willison-blog",
  "name": "Simon Willison",
  "feedUrl": "https://simonwillison.net/atom/everything/",
  "type": "atom",
  "checkInterval": "hourly",
  "notify": true,
  "summarize": true,
  "publishToCool": false,
  "active": true
}'

# Force check all
joelclaw send subscription/check-feeds

# Check single
joelclaw send subscription/check-single -d '{"subscriptionId": "simon-willison-blog"}'

Subscription Types

Type	Detection	Method	Best For
atom / rss	URL ends in /atom/, /feed/, /rss or has XML content-type	Standard feed parse	Blogs, newsletters
github	github.com/<owner>/<repo>	GitHub API (releases, commits)	Open source projects
page	Any other URL	Content hash diff via defuddle	Living documents, guides
bluesky	bsky.app or AT Protocol handle	AT Protocol feed	Social/microblog

Auto-Detection Heuristics

When adding a subscription, detect the type:

1. GitHub URL → github type, check releases + significant commits
2. URL with /atom/ or /feed/ → atom type
3. URL with /rss → rss type
4. Blog root URL → try {url}/atom/, {url}/feed/, {url}/rss.xml before falling back to page
5. Everything else → page type (content hash diff)

How Updates Flow

Inngest cron (hourly) → subscription/check-feeds
  → fans out: subscription/check-single per subscription
    → fetch feed / API / page hash
    → new entries detected?
      → YES: subscription/summarize → LLM summary
        → gateway notification with [Publish to /cool] [Dismiss]
        → Joel approves → discovery/noted → vault note → /cool
      → NO: log quiet check, move on

Notification Format

Gateway notifications for feed updates include:

• Source name and subscription type
• Brief LLM summary of what changed
• Entry count and links to significant items
• Relevance tag (which interest areas it maps to)
• Action buttons: [Publish to /cool] [Dismiss]

Adding from Discovery

When the discovery skill fires and the agent assesses the resource is monitorable, use MCQ to recommend:

After firing joelclaw discover:

1. Assess: Is this a blog, repo, or living page with ongoing updates?
2. Assess: Does it map to 2+ items in Joel's Interest Profile above?
3. If both yes → recommend monitoring via MCQ with brief reasoning
4. If monitorable but low relevance → mention it's monitorable but don't push
5. If not monitorable (one-shot article, tweet, etc.) → don't mention monitoring

Backend

• Redis storage: joelclaw:subscriptions hash (lib at packages/system-bus/src/lib/subscriptions.ts)
• Inngest functions: packages/system-bus/src/inngest/functions/subscriptions.ts
• Feed checker: packages/system-bus/src/lib/feed-checker.ts
• ADR: ~/Vault/docs/decisions/0127-feed-subscriptions-and-resource-monitoring.md