feat(hub): configurable analysis thumbnail regeneration threshold (0.178.0)

Add kerberospipeline.analysis.thumbnailRegeneration.minSeconds (default
3), passed to pipe-analysis as THUMBNAIL_REGENERATION_MIN_SECONDS. Analysis
only regenerates a thumbnail when the classified object first appears at
least this many seconds into the recording; 0 regenerates for every
object. Requires an analysis image that reads the variable.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

charts/hub/Chart.yaml

@@ -16,7 +16,7 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 0.177.0
+version: 0.178.0
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to

charts/hub/README.md

@@ -1034,7 +1034,8 @@ kerberospipeline:
 | `kerberospipeline.analysis.tag` | The Docker image tag/version. | `"v1.7.8"` |
 | `kerberospipeline.analysis.replicas` | Number of replicas for `kerberospipeline.analysis`. | `1` |
 | `kerberospipeline.analysis.logLevel` | Log verbosity level for `kerberospipeline.analysis`. | `"info"` |
-| `kerberospipeline.analysis.thumbnailRegeneration.enabled` | Regenerate thumbnails from the first frame of a classified moving object (`THUMBNAIL_REGENERATION_ENABLED`). Adds one thumbnail job per classified recording. Requires an analysis image that reads the flag. | `false` |
+| `kerberospipeline.analysis.thumbnailRegeneration.enabled` | Regenerate thumbnails from the first frame of a classified moving object (`THUMBNAIL_REGENERATION_ENABLED`). Adds up to one thumbnail job per classified recording. Requires an analysis image that reads the flag. | `false` |
+| `kerberospipeline.analysis.thumbnailRegeneration.minSeconds` | Only regenerate when the classified object first appears at least this many seconds into the recording (`THUMBNAIL_REGENERATION_MIN_SECONDS`); earlier objects are already in the original thumbnail. `0` regenerates for every object. Requires an analysis image that reads the variable. | `3` |
 | `kerberospipeline.analysis.dbCache.enabled` | Cache hot-path MongoDB lookups (site vault per device) in memory. Site changes apply after at most one TTL. | `false` |
 | `kerberospipeline.analysis.dbCache.ttl` | Lifetime of a cached lookup, as a Go duration (e.g. `"30s"`, `"5m"`). | `"5m"` |
 | `kerberospipeline.analysis.resources.requests.memory` | Memory request for `kerberospipeline.analysis`. | `"10Mi"` |

charts/hub/templates/kerberos-pipeline/pipe-analysis.yaml

@@ -129,6 +129,10 @@ spec:
         # Thumbnail regeneration from classified frames (opt-in)
         - name: THUMBNAIL_REGENERATION_ENABLED
           value: {{ .Values.kerberospipeline.analysis.thumbnailRegeneration.enabled | default false | quote }}
+        # Skip regeneration when the object first appears within this many seconds
+        - name: THUMBNAIL_REGENERATION_MIN_SECONDS
+          {{- $regeneration := .Values.kerberospipeline.analysis.thumbnailRegeneration }}
+          value: {{ ternary $regeneration.minSeconds 3 (hasKey $regeneration "minSeconds") | quote }}
 
         # In-memory cache for hot-path MongoDB lookups
         - name: DB_CACHE_ENABLED

charts/hub/values.yaml

@@ -1413,10 +1413,14 @@ kerberospipeline:
     logLevel: "info" # possible values: trace, debug, info, warn, error
     # Opt-in: after classification, re-enqueue the recording on the thumbnail
     # queue to regenerate its thumbnail from the first frame of a tracked moving
-    # object (THUMBNAIL_REGENERATION_ENABLED). Adds one thumbnail job per
+    # object (THUMBNAIL_REGENERATION_ENABLED). Adds up to one thumbnail job per
     # classified recording; size pipe-thumbnail accordingly before enabling.
+    # minSeconds (THUMBNAIL_REGENERATION_MIN_SECONDS): only regenerate when the
+    # object first appears at least this many seconds into the recording; earlier
+    # objects are already in the original thumbnail. 0 regenerates for every object.
     thumbnailRegeneration:
       enabled: false
+      minSeconds: 3
     # In-memory cache for hot-path MongoDB lookups (site vault per device).
     # Site changes apply after at most one TTL; each replica caches separately.
     dbCache: