docs: add missing package doc comments to 20 internal files

internal/agents/claude.go

@@ -1,3 +1,5 @@
+// Package agents provides interfaces and implementations for spawning AI agents.
+//
 // claude.go implements the Agent interface for Claude Code CLI.
 package agents
 

internal/agents/codex.go

@@ -1,3 +1,5 @@
+// Package agents provides interfaces and implementations for spawning AI agents.
+//
 // codex.go implements the Agent interface for OpenAI Codex CLI.
 package agents
 

internal/agents/copilot.go

@@ -1,3 +1,5 @@
+// Package agents provides interfaces and implementations for spawning AI agents.
+//
 // copilot.go implements the Agent interface for GitHub Copilot CLI.
 package agents
 

internal/analysis/db.go

@@ -1,3 +1,4 @@
+// Package analysis provides code ownership and bus-factor analysis tools.
 package analysis
 
 import (

internal/analysis/metrics.go

@@ -1,3 +1,4 @@
+// Package analysis provides code ownership and bus-factor analysis tools.
 package analysis
 
 import (

internal/analysis/report.go

@@ -1,3 +1,4 @@
+// Package analysis provides code ownership and bus-factor analysis tools.
 package analysis
 
 import (

internal/db/import.go

@@ -1,3 +1,4 @@
+// Package db provides SQLite-backed storage for nightshift state and snapshots.
 package db
 
 import (

internal/db/migrations.go

@@ -1,3 +1,4 @@
+// Package db provides SQLite-backed storage for nightshift state and snapshots.
 package db
 
 import (

internal/integrations/agentsmd.go

@@ -1,3 +1,4 @@
+// Package integrations provides readers for external configuration and task sources.
 package integrations
 
 import (

internal/integrations/claudemd.go

@@ -1,3 +1,4 @@
+// Package integrations provides readers for external configuration and task sources.
 package integrations
 
 import (

internal/integrations/github.go

@@ -1,3 +1,4 @@
+// Package integrations provides readers for external configuration and task sources.
 package integrations
 
 import (

internal/integrations/td.go

@@ -1,3 +1,4 @@
+// Package integrations provides readers for external configuration and task sources.
 package integrations
 
 import (

internal/orchestrator/events.go

@@ -1,3 +1,4 @@
+// Package orchestrator coordinates AI agents working on tasks.
 package orchestrator
 
 import "time"

internal/providers/claude.go

@@ -1,3 +1,5 @@
+// Package providers defines interfaces and implementations for AI coding agents.
+//
 // claude.go implements the Provider interface for Claude Code CLI.
 package providers
 

internal/providers/codex.go

@@ -1,3 +1,5 @@
+// Package providers defines interfaces and implementations for AI coding agents.
+//
 // codex.go implements the Provider interface for OpenAI Codex CLI.
 package providers
 

internal/providers/copilot.go

@@ -1,3 +1,5 @@
+// Package providers defines interfaces and implementations for AI coding agents.
+//
 // copilot.go implements the Provider interface for GitHub Copilot CLI.
 package providers
 

internal/reporting/run_report.go

@@ -1,3 +1,4 @@
+// Package reporting generates morning summary reports for nightshift runs.
 package reporting
 
 import (

internal/reporting/run_results.go

@@ -1,3 +1,4 @@
+// Package reporting generates morning summary reports for nightshift runs.
 package reporting
 
 import (

internal/tasks/register.go

@@ -1,3 +1,4 @@
+// Package tasks defines task structures and loading from various sources.
 package tasks
 
 import (

internal/tmux/scraper.go

@@ -1,3 +1,4 @@
+// Package tmux scrapes tmux sessions to detect running AI agent processes and their usage.
 package tmux
 
 import (