From 5759ce4c7aec6ee2b389938650304349f9f87b38 Mon Sep 17 00:00:00 2001
From: flemming-it <stefan.a.flemming@googlemail.com>
Date: Fri, 28 Aug 2026 00:09:13 +0200
Subject: [PATCH] =?UTF-8?q?feat:=20FlowSummary.sample=20=E2=80=94=20regene?=
 =?UTF-8?q?rated=20stubs?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The hub marks bundled sample flows on the wire (field 6, additive);
old hubs decode to false so clients never chip on guesswork.

Signed-off-by: flemming-it <stefan.a.flemming@googlemail.com>
---
 CHANGELOG.md                               |  5 +++++
 lib/src/generated/chain/v1/hub.pb.dart     | 16 ++++++++++++++++
 lib/src/generated/chain/v1/hub.pbjson.dart |  4 +++-
 3 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5de393f..aa66983 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,11 @@ for the authoritative per-release detail.
 
 ## Unreleased
 
+- Regenerated stubs: `FlowSummary.sample` (wire field 6) — true when
+  a saved flow still carries the bundled-sample header. Old hubs
+  without the field decode to false, so clients can mark and group
+  examples honestly.
+
 - `declareService()` — persist a host service into the operator
   config via the new DeclareService RPC (returns restartRequired).
 
diff --git a/lib/src/generated/chain/v1/hub.pb.dart b/lib/src/generated/chain/v1/hub.pb.dart
index 475c67b..a5b8d0f 100644
--- a/lib/src/generated/chain/v1/hub.pb.dart
+++ b/lib/src/generated/chain/v1/hub.pb.dart
@@ -2661,6 +2661,7 @@ class FlowSummary extends $pb.GeneratedMessage {
     $fixnum.Int64? sizeBytes,
     $core.Iterable<$core.String>? requiredCapabilities,
     $core.String? project,
+    $core.bool? sample,
   }) {
     final result = create();
     if (name != null) result.name = name;
@@ -2669,6 +2670,7 @@ class FlowSummary extends $pb.GeneratedMessage {
     if (requiredCapabilities != null)
       result.requiredCapabilities.addAll(requiredCapabilities);
     if (project != null) result.project = project;
+    if (sample != null) result.sample = sample;
     return result;
   }
 
@@ -2690,6 +2692,7 @@ class FlowSummary extends $pb.GeneratedMessage {
     ..aInt64(3, _omitFieldNames ? '' : 'sizeBytes')
     ..pPS(4, _omitFieldNames ? '' : 'requiredCapabilities')
     ..aOS(5, _omitFieldNames ? '' : 'project')
+    ..aOB(6, _omitFieldNames ? '' : 'sample')
     ..hasRequiredFields = false;
 
   @$core.Deprecated('See https://github.com/google/protobuf.dart/issues/998.')
@@ -2759,6 +2762,19 @@ class FlowSummary extends $pb.GeneratedMessage {
   $core.bool hasProject() => $_has(4);
   @$pb.TagNumber(5)
   void clearProject() => $_clearField(5);
+
+  /// True when the file still carries the bundled-sample header —
+  /// it arrived via the hub's sample import, not from an operator.
+  /// Clients mark and group these so examples are never mistaken
+  /// for real work. Deleting the header claims the flow.
+  @$pb.TagNumber(6)
+  $core.bool get sample => $_getBF(5);
+  @$pb.TagNumber(6)
+  set sample($core.bool value) => $_setBool(5, value);
+  @$pb.TagNumber(6)
+  $core.bool hasSample() => $_has(5);
+  @$pb.TagNumber(6)
+  void clearSample() => $_clearField(6);
 }
 
 /// One registered project (shared-hub registry row). Sealed
diff --git a/lib/src/generated/chain/v1/hub.pbjson.dart b/lib/src/generated/chain/v1/hub.pbjson.dart
index 3359860..d1029df 100644
--- a/lib/src/generated/chain/v1/hub.pbjson.dart
+++ b/lib/src/generated/chain/v1/hub.pbjson.dart
@@ -784,6 +784,7 @@ const FlowSummary$json = {
       '10': 'requiredCapabilities'
     },
     {'1': 'project', '3': 5, '4': 1, '5': 9, '10': 'project'},
+    {'1': 'sample', '3': 6, '4': 1, '5': 8, '10': 'sample'},
   ],
 };
 
@@ -791,7 +792,8 @@ const FlowSummary$json = {
 final $typed_data.Uint8List flowSummaryDescriptor = $convert.base64Decode(
     'CgtGbG93U3VtbWFyeRISCgRuYW1lGAEgASgJUgRuYW1lEhIKBHBhdGgYAiABKAlSBHBhdGgSHQ'
     'oKc2l6ZV9ieXRlcxgDIAEoA1IJc2l6ZUJ5dGVzEjMKFXJlcXVpcmVkX2NhcGFiaWxpdGllcxgE'
-    'IAMoCVIUcmVxdWlyZWRDYXBhYmlsaXRpZXMSGAoHcHJvamVjdBgFIAEoCVIHcHJvamVjdA==');
+    'IAMoCVIUcmVxdWlyZWRDYXBhYmlsaXRpZXMSGAoHcHJvamVjdBgFIAEoCVIHcHJvamVjdBIWCg'
+    'ZzYW1wbGUYBiABKAhSBnNhbXBsZQ==');
 
 @$core.Deprecated('Use projectInfoDescriptor instead')
 const ProjectInfo$json = {