camp-activity

Daily campaign activity dashboards as a standalone camp plugin.

camp-activity reads git history across the campaign root and linked submodules, joins that activity with existing event streams, and renders a daily report with evidence pointers.

Install

cd projects/camp-activity
just install

# or install directly with Go
go install github.com/Obedience-Corp/camp-activity/cmd/camp-activity@latest

Once the binary is on your PATH, core camp discovers it automatically:

camp activity version
camp-activity version

Usage

• camp-activity today renders today's activity in Markdown or JSON
• camp-activity yesterday renders the previous calendar day
• camp-activity date --date YYYY-MM-DD renders one day
• camp-activity date --since ... --until ... renders a custom window
• camp-activity workitem <key> renders a workitem-focused window
• camp-activity workitem --stale <duration> lists stale workitems
• camp-activity workitem --hot lists the busiest workitems for today
• camp-activity export --json <path> writes the current day's report as JSON
• camp-activity version prints version metadata and the detected campaign root

Examples:

camp activity today --tz America/Denver
camp activity today --format json
camp activity workitem festival:festivals/active/foo-CA0001 --format json

Development

cd projects/camp-activity
just build
just test
just test-integration
just test-e2e
just install

Run against a real campaign after installing:

cd /path/to/campaign
camp activity today

Older campaigns should ignore plugin-managed local activity state if they enable cache-backed stages later:

.campaign/activity/

Architecture

Internal architecture, source adapters, and merge rules are documented in:

• workflow/explore/activity-dashboard/ARCHITECTURE.md
• workflow/explore/activity-dashboard/PLUGIN_DESIGN.md

Design source of truth: workflow/explore/activity-dashboard/

Implementation festival: festivals/active/camp-activity-plugin-CA0001/

Development Status

MVP features shipped:

• root detection through CAMP_ROOT or walk-up fallback
• aggregation across git history, intents, fest progress, nav history, and workitems
• Markdown and JSON renderers
• daily, windowed, and workitem-focused CLI commands
• plugin dispatch through camp activity ...
• seeded fixture and end-to-end integration coverage

Deferred stage 2 items:

• interactive TUI rendering
• HTML export
• day cache under .campaign/activity/
• live event writers / incremental updates

Release distribution through projects/festival/ is tracked as a follow-up festival. The current supported install path is just install or go install.

Plugin Boundary

camp-activity does not import core camp or fest as Go modules. It integrates through filesystem reads, environment conventions such as CAMP_ROOT, and the camp workitem --json subprocess contract.