fai/chain-studio
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat(store): advisory-version badge for federated entries
Some checks failed
Security / Security check (push) Failing after 1s
Details

Browse source 
Store cards + detail-sheet now prefix the version pill with
`~` and attach a tooltip for federated entries (MCP / n8n /
Temporal). Upstream services don't honour semver, so the
version pill is a label, not a contract — the tilde says
"this number may change without a version bump."

Three render sites updated to stay visually consistent:
- compact card pill in grid view
- expanded card pill row
- detail-sheet header pill cluster

EN + DE l10n entries added (`storeAdvisoryVersionTooltip`)
and `app_localizations.dart` regenerated.

dart analyze clean; flutter test green (11 tests).

Signed-off-by: flemming-it <stefan.a.flemming@googlemail.com>
This commit is contained in:
flemming-it 2026-05-28 23:26:49 +02:00
parent c5a96bc8d4
commit 327bc0fea2
7 changed files with 55 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

1
lib/l10n/app_de.arb
View file

@ -776,6 +776,7 @@
}
}
},
"storeAdvisoryVersionTooltip": "Föderierter Upstream-Dienst — Version ist Richtwert; der Upstream kann ohne Versionsanhebung Kompatibilität brechen.",
"maintenanceHeader": "HUB-WARTUNG",
"maintenanceResetBlurb": "Operator-Zustand zurücksetzen und mit einem sauberen Hub neu starten. Stoppt jeden laufenden Daemon, sichert ~/.fai/ atomar in ein Backup, legt es dann neu an — Binary, Channel-Pointer, MCP-/n8n-/System-AI-Konfiguration und Registry-Token bleiben erhalten. Wiederherstellen durch Zurückverschieben des Backup-Ordners.",
"maintenanceKeepModulesTitle": "Installierte Module behalten",

1
lib/l10n/app_en.arb
View file

@ -779,6 +779,7 @@
}
}
},
"storeAdvisoryVersionTooltip": "Federated upstream service — version is advisory; the upstream may break compatibility without bumping it.",
"maintenanceHeader": "HUB MAINTENANCE",
"maintenanceResetBlurb": "Wipe operator state and start over with a clean hub. Stops every running daemon, atomically backs ~/.fai/ up, then recreates it with the binary, channel state, MCP / n8n / system-AI config, and registry token preserved. Restore by moving the backup directory back.",
"maintenanceKeepModulesTitle": "Keep installed modules",

6
lib/l10n/app_localizations.dart
View file

@ -2246,6 +2246,12 @@ abstract class AppLocalizations {
/// **'Could not save: {error}'**
String hubAuthTokenSaveFailedToast(String error);
/// No description provided for @storeAdvisoryVersionTooltip.
///
/// In en, this message translates to:
/// **'Federated upstream service — version is advisory; the upstream may break compatibility without bumping it.'**
String get storeAdvisoryVersionTooltip;
/// No description provided for @maintenanceHeader.
///
/// In en, this message translates to:

4
lib/l10n/app_localizations_de.dart
View file

@ -1284,6 +1284,10 @@ class AppLocalizationsDe extends AppLocalizations {
return 'Speichern fehlgeschlagen: $error';
}
@override
String get storeAdvisoryVersionTooltip =>
'Föderierter Upstream-Dienst — Version ist Richtwert; der Upstream kann ohne Versionsanhebung Kompatibilität brechen.';
@override
String get maintenanceHeader => 'HUB-WARTUNG';

4
lib/l10n/app_localizations_en.dart
View file

@ -1299,6 +1299,10 @@ class AppLocalizationsEn extends AppLocalizations {
return 'Could not save: $error';
}
@override
String get storeAdvisoryVersionTooltip =>
'Federated upstream service — version is advisory; the upstream may break compatibility without bumping it.';
@override
String get maintenanceHeader => 'HUB MAINTENANCE';

50
lib/pages/store.dart
View file

@ -1661,10 +1661,22 @@ class _FeaturedTile extends StatelessWidget {
Row(
children: [
if (item.bestVersion.isNotEmpty)
FaiPill(
label: 'v${item.bestVersion}',
tone: FaiPillTone.neutral,
monospace: true,
Tooltip(
// Federated upstream services (MCP, n8n,
// Temporal workflows) don't honour semver,
// so their version pill carries a "~"
// prefix + tooltip noting that the value
// is advisory only.
message: item.isFederated
? l.storeAdvisoryVersionTooltip
: '',
child: FaiPill(
label: item.isFederated
? '~v${item.bestVersion}'
: 'v${item.bestVersion}',
tone: FaiPillTone.neutral,
monospace: true,
),
),
const SizedBox(width: FaiSpace.xs),
if (item.status.isNotEmpty)
@ -1835,10 +1847,17 @@ class _StoreCard extends StatelessWidget {
Row(
children: [
if (item.bestVersion.isNotEmpty) ...[
FaiPill(
label: 'v${item.bestVersion}',
tone: FaiPillTone.neutral,
monospace: true,
Tooltip(
message: item.isFederated
? l.storeAdvisoryVersionTooltip
: '',
child: FaiPill(
label: item.isFederated
? '~v${item.bestVersion}'
: 'v${item.bestVersion}',
tone: FaiPillTone.neutral,
monospace: true,
),
),
const SizedBox(width: FaiSpace.xs),
],
@ -2134,10 +2153,17 @@ class _StoreDetailSheetState extends State<_StoreDetailSheet> {
runSpacing: 4,
children: [
if (item.bestVersion.isNotEmpty)
FaiPill(
label: 'v${item.bestVersion}',
tone: FaiPillTone.neutral,
monospace: true,
Tooltip(
message: item.isFederated
? l.storeAdvisoryVersionTooltip
: '',
child: FaiPill(
label: item.isFederated
? '~v${item.bestVersion}'
: 'v${item.bestVersion}',
tone: FaiPillTone.neutral,
monospace: true,
),
),
if (item.status.isNotEmpty)
FaiPill(