Add --activity type filter to stitch command

Allow filtering seekpoints by activity type (Human, Vehicle, Animal, etc.)
with user-friendly aliases that map to ActivityEnum values.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Brandon Salzberg

cmd/analyze.go

@@ -321,7 +321,7 @@ func runAnalyzeFootage(cmd *cobra.Command, args []string) error {
 		os.MkdirAll(camDir, 0755)
 
 		// Get seekpoints for activity-aware frame selection
-		activityTimes := getActivityTimes(cfg, camUUID, startMs, endMs, includeMotion)
+		activityTimes := getActivityTimes(cfg, camUUID, startMs, endMs, includeMotion, nil)
 
 		// Select frames: prioritize activity, optionally fill remainder evenly
 		frameTimes := selectFrameTimes(startMs, endMs, interval, activityTimes, fill)
@@ -380,7 +380,35 @@ func runAnalyzeFootage(cmd *cobra.Command, args []string) error {
 
 // ─── Frame Selection ────────────────────────────────────────────────
 
-func getActivityTimes(cfg config.Config, cameraUUID string, startMs, endMs int64, includeMotion bool) []int64 {
+// activityAliases maps user-friendly names to ActivityEnum values.
+var activityAliases = map[string]string{
+	"human":        "MOTION_HUMAN",
+	"vehicle":      "MOTION_CAR",
+	"car":          "MOTION_CAR",
+	"animal":       "MOTION_ANIMAL",
+	"face":         "FACE",
+	"licenseplate": "LICENSEPLATE",
+	"motion":       "MOTION",
+	"tamper":       "TAMPER",
+	"sound":        "SOUND_LOUD",
+	"gunshot":      "SOUND_GUN_SHOT",
+}
+
+// resolveActivityTypes converts user-friendly names to ActivityEnum values.
+// Unrecognized values are passed through as-is (assumed to be raw enum values).
+func resolveActivityTypes(types []string) []string {
+	var resolved []string
+	for _, t := range types {
+		if mapped, ok := activityAliases[strings.ToLower(strings.TrimSpace(t))]; ok {
+			resolved = append(resolved, mapped)
+		} else {
+			resolved = append(resolved, strings.TrimSpace(t))
+		}
+	}
+	return resolved
+}
+
+func getActivityTimes(cfg config.Config, cameraUUID string, startMs, endMs int64, includeMotion bool, activityTypes []string) []int64 {
 	startSec := startMs / 1000
 	durationSec := (endMs - startMs) / 1000
 
@@ -389,7 +417,7 @@ func getActivityTimes(cfg config.Config, cameraUUID string, startMs, endMs int64
 		"startTime":  startSec,
 		"duration":   durationSec,
 	}
-	if includeMotion {
+	if includeMotion || len(activityTypes) > 0 {
 		params["includeAnyMotion"] = "true"
 	}
 
@@ -401,12 +429,26 @@ func getActivityTimes(cfg config.Config, cameraUUID string, startMs, endMs int64
 
 	seekpoints, _ := resp["footageSeekPoints"].([]any)
 	fmt.Fprintf(os.Stderr, "  Seekpoints found: %d\n", len(seekpoints))
+
+	// Build filter set
+	filterSet := make(map[string]bool, len(activityTypes))
+	for _, at := range activityTypes {
+		filterSet[at] = true
+	}
+
 	var times []int64
 	for _, sp := range seekpoints {
 		s, ok := sp.(map[string]any)
 		if !ok {
 			continue
 		}
+		// Filter by activity type if specified
+		if len(filterSet) > 0 {
+			activity, _ := s["a"].(string)
+			if !filterSet[activity] {
+				continue
+			}
+		}
 		ts, _ := s["ts"].(float64)
 		if ts > 0 {
 			times = append(times, int64(ts))

cmd/context.go

@@ -467,7 +467,7 @@ func runContextCamera(cmd *cobra.Command, args []string) error {
 
 	// Recent activity summary
 	nowMs := time.Now().UnixMilli()
-	activity := getActivityTimes(cfg, camUUID, nowMs-3600*1000, nowMs, false)
+	activity := getActivityTimes(cfg, camUUID, nowMs-3600*1000, nowMs, false, nil)
 	fmt.Printf("\nActivity (last hour): %d events\n", len(activity))
 
 	return nil

cmd/stitch.go

@@ -51,6 +51,7 @@ in a grid layout. Timestamps are overlaid on each clip.`,
 	stitchCmd.Flags().String("period", "", "Natural language time window (e.g., 'yesterday between 6am and 7am')")
 	stitchCmd.Flags().Int("buffer", 5, "Seconds of buffer around each event")
 	stitchCmd.Flags().Bool("include-motion", false, "Include motion seekpoints (default: only human/vehicle/object activity)")
+	stitchCmd.Flags().StringSlice("activity", nil, "Filter by activity type (Human, Vehicle, Animal, Face, LicensePlate, Motion, or raw enum)")
 	stitchCmd.Flags().String("output", "", "Output file path (default: auto-generated)")
 	rootCmd.AddCommand(stitchCmd)
 }
@@ -64,8 +65,12 @@ func runStitch(cmd *cobra.Command, args []string) error {
 	periodStr, _ := cmd.Flags().GetString("period")
 	buffer, _ := cmd.Flags().GetInt("buffer")
 	includeMotion, _ := cmd.Flags().GetBool("include-motion")
+	activityFilter, _ := cmd.Flags().GetStringSlice("activity")
 	outputPath, _ := cmd.Flags().GetString("output")
 
+	// Resolve user-friendly activity type names to enum values
+	activityTypes := resolveActivityTypes(activityFilter)
+
 	// Check ffmpeg
 	if _, err := exec.LookPath("ffmpeg"); err != nil {
 		return fmt.Errorf("ffmpeg is required. Install with: brew install ffmpeg")
@@ -178,7 +183,7 @@ func runStitch(cmd *cobra.Command, args []string) error {
 			camName = camUUID
 		}
 
-		activityTimes := getActivityTimes(cfg, camUUID, startMs, endMs, includeMotion)
+		activityTimes := getActivityTimes(cfg, camUUID, startMs, endMs, includeMotion, activityTypes)
 		if len(activityTimes) == 0 {
 			continue
 		}