Files
pipelines/app/lib/features/pipelines/pipeline_format.dart
T
alan a44f31b989 feat(app): add native pipelines list and detail screen
Read-only Pipelines screen for the Flutter client:

- list_pipelines and list_runs with a last-run join, plus get_pipeline
  with an explicit version (0 = latest); no mutation requests.
- Name, run-presence, last-run-status and schedule filters; six sort
  orders; clear filters; truthful loading, empty and error states.
- Detail Summary, selectable Source and version history with selection
  and return to latest.
- Sequenced list/detail requests so stale replies cannot replace a newer
  selection or open a cleared one; refresh keeps the selected pipeline
  and version.
- Material controls on Android/desktop and Cupertino on iOS; a
  per-label segmented tab row at narrow widths and scaled text, with the
  native control kept wherever an equal share fits.
- Fixture probe entry and Chrome scripts for the rendered evidence;
  widget tests cover filters, sorting, formatting, sequencing, layout
  and the tab row.

Graph rendering remains P2: the Graph tab states that it is pending and
exposes a host hook. PipelinesScreen is not yet registered in the shell.

Evidence and limits: app/notes/P1.md.
2026-10-21 19:09:29 +01:00

106 lines
3.3 KiB
Dart

/// Formatting shared by the pipeline list and detail.
///
/// The wording mirrors the web client (`src/pipelines.js`), which in turn
/// mirrors the Android app: one date shape, one duration shape, one status
/// vocabulary and one singular/plural rule.
library;
const _monthNames = <String>[
'Jan',
'Feb',
'Mar',
'Apr',
'May',
'Jun',
'Jul',
'Aug',
'Sep',
'Oct',
'Nov',
'Dec',
];
/// Parses an RFC3339 timestamp, or null when blank or unparseable.
DateTime? parseInstant(String? text) {
final trimmed = text?.trim() ?? '';
if (trimmed.isEmpty) return null;
return DateTime.tryParse(trimmed);
}
/// `d MMM HH:mm` in local time, e.g. `17 Oct 21:26`, or null when the
/// timestamp is unusable so callers omit the value instead of printing blank.
String? formatLocalTimestamp(String? text) {
final instant = parseInstant(text);
if (instant == null) return null;
final local = instant.toLocal();
final hour = local.hour.toString().padLeft(2, '0');
final minute = local.minute.toString().padLeft(2, '0');
return '${local.day} ${_monthNames[local.month - 1]} $hour:$minute';
}
/// `45s`, `2m 5s`, `1h 2m`. Negative values clamp to `0s`.
String formatDuration(int totalSeconds) {
final seconds = totalSeconds < 0 ? 0 : totalSeconds;
if (seconds < 60) return '${seconds}s';
if (seconds < 3600) return '${seconds ~/ 60}m ${seconds % 60}s';
return '${seconds ~/ 3600}h ${(seconds % 3600) ~/ 60}m';
}
/// Whole non-negative seconds between two timestamps, or null when either is
/// unusable or the end precedes the start.
int? durationSeconds(String? start, String? end) {
final from = parseInstant(start);
final to = parseInstant(end);
if (from == null || to == null) return null;
final seconds = to.difference(from).inSeconds;
return seconds >= 0 ? seconds : null;
}
/// `just now`, `Nm ago`, `Nh ago`, `Nd ago`; a future timestamp reads as
/// `just now`, never a negative age.
String? formatRanAgo(String? createdAt, DateTime now) {
final start = parseInstant(createdAt);
if (start == null) return null;
final seconds = now.difference(start).inSeconds;
if (seconds < 60) return 'just now';
if (seconds < 3600) return '${seconds ~/ 60}m ago';
if (seconds < 86400) return '${seconds ~/ 3600}h ago';
return '${seconds ~/ 86400}d ago';
}
/// `1 stage` / `n stages`.
String stageCountText(int count) => '$count ${count == 1 ? 'stage' : 'stages'}';
const _runStateAliases = <String, String>{
'running': 'running',
'queued': 'queued',
'waiting': 'waiting',
'active': 'active',
'succeeded': 'succeeded',
'success': 'succeeded',
'completed': 'succeeded',
'done': 'succeeded',
'failed': 'failed',
'error': 'failed',
'canceled': 'canceled',
'cancelled': 'canceled',
'interrupted': 'interrupted',
'blocked': 'blocked',
'skipped': 'skipped',
};
/// Maps a server status word to the shared run-state vocabulary. Unknown or
/// blank values become `unknown` rather than crashing a row.
String runStateOf(String? status) {
final key = (status ?? '').trim().toLowerCase();
return _runStateAliases[key] ?? 'unknown';
}
/// `Running`-style title for a run state.
String runStateLabel(String? status) {
final state = runStateOf(status);
return state.isEmpty
? state
: '${state[0].toUpperCase()}${state.substring(1)}';
}