Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

Phases in the verdict, a phase strip in the viewer pane's header

dee3fe3b0e67279
diff --git a/cli/src/dsh/verdict.spec.ts b/cli/src/dsh/verdict.spec.ts
index f21634fa8..707ea5f59 100644
--- a/cli/src/dsh/verdict.spec.ts
+++ b/cli/src/dsh/verdict.spec.ts
@@ -27,10 +27,38 @@ describe('parseVerdict', () => {
errors: 2,
warnings: 1,
artifact: 'boards/main.board.json',
+ phases: [],
updatedAt: '2026-09-14T20:00:00Z',
})
})
+ it('keeps the phases in order, sanitised, and never more than twelve', () => {
+ const verdict = parseVerdict(JSON.stringify({
+ spec: 1,
+ ready: false,
+ phases: [
+ { id: 'build', name: 'Build', state: 'done', artifact: 'model.step' },
+ { name: 'Checks', state: 'active' },
+ { name: ' Fab ', state: 'someday' },
+ { name: '', state: 'done' },
+ 'nope',
+ { id: 'x', state: 'done' },
+ { name: 'Bad path', state: 'done', artifact: '../out.step' },
+ ],
+ }))
+ expect(verdict?.phases).toEqual([
+ { id: 'build', name: 'Build', state: 'done', artifact: 'model.step' },
+ { id: 'checks', name: 'Checks', state: 'active', artifact: null },
+ { id: 'fab', name: 'Fab', state: 'pending', artifact: null },
+ { id: 'bad-path', name: 'Bad path', state: 'done', artifact: null },
+ ])
+ const many = parseVerdict(JSON.stringify({
+ spec: 1, ready: true, phases: Array.from({ length: 20 }, (_, i) => ({ name: `P${i}` })),
+ }))
+ expect(many?.phases).toHaveLength(12)
+ expect(parseVerdict(JSON.stringify({ spec: 1, ready: true, phases: 'later' }))?.phases).toEqual([])
+ })
+
it('refuses what is not a verdict, and scrubs an artifact that leaves the workspace', () => {
expect(parseVerdict('nope')).toBeNull()
expect(parseVerdict('[]')).toBeNull()
diff --git a/cli/src/dsh/verdict.ts b/cli/src/dsh/verdict.ts
index 1d488e129..12956f80f 100644
--- a/cli/src/dsh/verdict.ts
+++ b/cli/src/dsh/verdict.ts
@@ -13,15 +13,53 @@ import chokidar, { type FSWatcher } from 'chokidar'
import { existsSync, mkdirSync, readFileSync } from 'node:fs'
import { basename, dirname } from 'node:path'
+export type DshPhaseState = 'done' | 'active' | 'pending' | 'failed'
+
+/** One entry of the verdict's `phases`: where the work is, for the pane header's strip. */
+export interface DshPhase {
+ id: string
+ name: string
+ state: DshPhaseState
+ artifact: string | null
+}
+
export interface DshVerdict {
ready: boolean
summary: string | null
errors: number
warnings: number
artifact: string | null
+ /** In order, at most 12; empty when the harness names none. */
+ phases: DshPhase[]
updatedAt: string | null
}
+const PHASE_STATES: ReadonlySet<string> = new Set(['done', 'active', 'pending', 'failed'])
+const MAX_PHASES = 12
+
+function cleanLabel(value: unknown, max: number): string | null {
+ if (typeof value !== 'string') return null
+ const text = value.trim().slice(0, max)
+ return text ? text : null
+}
+
+/** The phases a verdict names, sanitised: a name is required, a state defaults to pending. */
+function parsePhases(raw: unknown): DshPhase[] {
+ if (!Array.isArray(raw)) return []
+ const phases: DshPhase[] = []
+ for (const item of raw) {
+ if (phases.length >= MAX_PHASES) break
+ if (!item || typeof item !== 'object' || Array.isArray(item)) continue
+ const entry = item as Record<string, unknown>
+ const name = cleanLabel(entry.name, 40)
+ if (!name) continue
+ const id = cleanLabel(entry.id, 40) ?? name.toLowerCase().replace(/[^a-z0-9]+/g, '-')
+ const state = typeof entry.state === 'string' && PHASE_STATES.has(entry.state) ? entry.state as DshPhaseState : 'pending'
+ phases.push({ id, name, state, artifact: cleanRelative(entry.artifact) })
+ }
+ return phases
+}
+
function cleanRelative(value: unknown): string | null {
if (typeof value !== 'string' || !value || value.length > 1024) return null
if (value.startsWith('/') || value.split(/[\\/]/).some((segment) => segment === '..')) return null
@@ -54,7 +92,9 @@ export function parseVerdict(text: string): DshVerdict | null {
const updatedAt = typeof raw.updatedAt === 'string' && !Number.isNaN(Date.parse(raw.updatedAt))
? raw.updatedAt
: null
- return { ready: raw.ready, summary, errors, warnings, artifact: cleanRelative(raw.artifact), updatedAt }
+ return {
+ ready: raw.ready, summary, errors, warnings, artifact: cleanRelative(raw.artifact), phases: parsePhases(raw.phases), updatedAt,
+ }
}
export function readVerdictFile(file: string): DshVerdict | null {
diff --git a/desktop/lib/core/models.dart b/desktop/lib/core/models.dart
index dce9b715d..82a982c14 100644
--- a/desktop/lib/core/models.dart
+++ b/desktop/lib/core/models.dart
@@ -307,6 +307,42 @@ class Agent {
/// `.harness/verdict.json` (see `dsh/spec/README.md`). Counts rather than the findings
/// themselves: the pane header has room for "3 errors", and the findings live in the
/// harness's own viewer.
+enum AgentPhaseState { done, active, pending, failed }
+
+/// One phase of a harness's work, as its verdict names it: where the agent is.
+class AgentPhase {
+ const AgentPhase({
+ required this.id,
+ required this.name,
+ this.state = AgentPhaseState.pending,
+ this.artifact,
+ });
+
+ final String id;
+ final String name;
+ final AgentPhaseState state;
+ final String? artifact;
+
+ static AgentPhase? fromJson(Object? raw) {
+ if (raw is! Map) return null;
+ final name = AgentVerdict._safeText(raw['name'], 40);
+ if (name == null || name.isEmpty) return null;
+ final id = AgentVerdict._safeText(raw['id'], 40);
+ final state = switch (raw['state']) {
+ 'done' => AgentPhaseState.done,
+ 'active' => AgentPhaseState.active,
+ 'failed' => AgentPhaseState.failed,
+ _ => AgentPhaseState.pending,
+ };
+ return AgentPhase(
+ id: id == null || id.isEmpty ? name.toLowerCase() : id,
+ name: name,
+ state: state,
+ artifact: AgentVerdict._safeText(raw['artifact'], 1024),
+ );
+ }
+}
+
@immutable
class AgentVerdict {
const AgentVerdict({
@@ -315,6 +351,7 @@ class AgentVerdict {
this.errors = 0,
this.warnings = 0,
this.artifact,
+ this.phases = const [],
this.updatedAt,
});
@@ -328,8 +365,16 @@ class AgentVerdict {
/// Workspace-relative path of the primary thing to look at, when the harness named one.
final String? artifact;
+
+ /// Where the work is, in order — at most twelve; empty when the harness
+ /// names no phases, and then the header draws no strip.
+ final List<AgentPhase> phases;
final DateTime? updatedAt;
+ /// The phase under way, when one is.
+ AgentPhase? get activePhase =>
+ phases.where((p) => p.state == AgentPhaseState.active).firstOrNull;
+
static AgentVerdict? fromJson(Object? raw) {
if (raw is! Map) return null;
final ready = raw['ready'];
@@ -341,10 +386,16 @@ class AgentVerdict {
errors: _safeCount(raw['errors']),
warnings: _safeCount(raw['warnings']),
artifact: _safeText(raw['artifact'], 1024),
+ phases: _phases(raw['phases']),
updatedAt: updated is String ? DateTime.tryParse(updated) : null,
);
}
+ static List<AgentPhase> _phases(Object? raw) {
+ if (raw is! List) return const [];
+ return [for (final item in raw.take(12)) ?AgentPhase.fromJson(item)];
+ }
+
static int _safeCount(Object? raw) {
if (raw is! num || raw.isNaN || raw < 0) return 0;
return raw > 9999 ? 9999 : raw.toInt();
diff --git a/desktop/lib/widgets/pane_grid.dart b/desktop/lib/widgets/pane_grid.dart
index cea9d7617..c7cef71b5 100644
--- a/desktop/lib/widgets/pane_grid.dart
+++ b/desktop/lib/widgets/pane_grid.dart
@@ -1278,6 +1278,7 @@ class _PaneContent extends StatelessWidget {
ownerName: owner?.name ?? pane.ownerAgentId ?? 'Viewer',
ownerEngine: owner?.identityEngine,
ownerDisplayName: owner?.identityDisplayName,
+ verdict: owner?.verdict,
onClose: close,
compactHeader: swarmMode,
zoomed: notifier.zoomedPaneId == pane.id,
diff --git a/desktop/lib/widgets/terminal_panel.dart b/desktop/lib/widgets/terminal_panel.dart
index f61534b07..51bcba160 100644
--- a/desktop/lib/widgets/terminal_panel.dart
+++ b/desktop/lib/widgets/terminal_panel.dart
@@ -9,7 +9,6 @@ import 'package:flutter/services.dart';
import 'package:xterm/xterm.dart';
import '../clipboard/native_clipboard.dart';
-import '../core/models.dart';
import '../state/app_state.dart';
import 'agent_drag.dart';
@@ -33,6 +32,7 @@ import '../shared/theme/app_theme.dart' as grid;
import '../theme/app_theme.dart';
import 'engine_identity.dart';
import 'pane_header_actions.dart';
+import 'verdict_marks.dart';
/// The pane header's own horizontal inset.
const double _stripPadding = 14;
@@ -1641,7 +1641,7 @@ class _TerminalHeader extends StatelessWidget {
if (agent?.verdict != null)
Padding(
padding: const EdgeInsets.only(right: 6),
- child: _VerdictChip(verdict: agent!.verdict!),
+ child: VerdictChip(verdict: agent!.verdict!),
),
// Which of the three paths carries this pane's bytes. Absent for a local machine's own
// terminal, which has no such distinction and so gets no badge.
@@ -1755,64 +1755,6 @@ class _TerminalHeader extends StatelessWidget {
/// error count, amber the warning count when nothing blocks, grey "Checked" a clean run that the
/// harness still would not call ready. The summary rides in the tooltip; the findings themselves
/// live in the harness's own viewer, which is the pane beside this one.
-class _VerdictChip extends StatelessWidget {
- const _VerdictChip({required this.verdict});
-
- final AgentVerdict verdict;
-
- @override
- Widget build(BuildContext context) {
- final (label, color, icon) = verdict.ready
- ? ('Ready', AppColors.success, LucideIcons.circleCheck)
- : verdict.errors > 0
- ? (
- '${verdict.errors} ${verdict.errors == 1 ? 'error' : 'errors'}',
- AppColors.danger,
- LucideIcons.circleX,
- )
- : verdict.warnings > 0
- ? (
- '${verdict.warnings} ${verdict.warnings == 1 ? 'warning' : 'warnings'}',
- AppColors.warning,
- LucideIcons.triangleAlert,
- )
- : ('Checked', AppColors.mutedStrong, LucideIcons.circleDashed);
- return Tooltip(
- message: verdict.summary ?? label,
- child: Semantics(
- label: 'Verdict: $label',
- child: Container(
- key: const ValueKey('pane-verdict-chip'),
- padding: const EdgeInsets.symmetric(horizontal: 7, vertical: 3),
- decoration: BoxDecoration(
- color: color.withValues(alpha: .12),
- borderRadius: BorderRadius.circular(999),
- border: Border.all(color: color.withValues(alpha: .35)),
- ),
- child: Row(
- mainAxisSize: MainAxisSize.min,
- children: [
- Icon(icon, size: 12, color: color),
- const SizedBox(width: 5),
- Text(
- label,
- maxLines: 1,
- overflow: TextOverflow.ellipsis,
- style: TextStyle(
- color: color,
- fontFamily: AppFonts.sans,
- fontSize: 11,
- fontWeight: FontWeight.w600,
- ),
- ),
- ],
- ),
- ),
- ),
- );
- }
-}
-
/// The pane header's transport badge: a compact topology for the path carrying terminal bytes.
///
/// The three shapes describe one hop, an intermediate hop, and a central server respectively. That
diff --git a/desktop/lib/widgets/verdict_marks.dart b/desktop/lib/widgets/verdict_marks.dart
new file mode 100644
index 000000000..6fb4a1cba
--- /dev/null
+++ b/desktop/lib/widgets/verdict_marks.dart
@@ -0,0 +1,145 @@
+// The marks a harness's verdict puts in a pane header: the chip (ready, or how
+// far from it) and the phase strip (where the work is). One file, so the
+// terminal pane and the viewer pane draw them the same.
+import 'package:flutter/material.dart';
+import 'package:lucide_icons_flutter/lucide_icons.dart';
+
+import '../core/models.dart';
+import '../theme/app_theme.dart';
+
+class VerdictChip extends StatelessWidget {
+ const VerdictChip({super.key, required this.verdict});
+
+ final AgentVerdict verdict;
+
+ @override
+ Widget build(BuildContext context) {
+ final (label, color, icon) = verdict.ready
+ ? ('Ready', AppColors.success, LucideIcons.circleCheck)
+ : verdict.errors > 0
+ ? (
+ '${verdict.errors} ${verdict.errors == 1 ? 'error' : 'errors'}',
+ AppColors.danger,
+ LucideIcons.circleX,
+ )
+ : verdict.warnings > 0
+ ? (
+ '${verdict.warnings} ${verdict.warnings == 1 ? 'warning' : 'warnings'}',
+ AppColors.warning,
+ LucideIcons.triangleAlert,
+ )
+ : ('Checked', AppColors.mutedStrong, LucideIcons.circleDashed);
+ return Tooltip(
+ message: verdict.summary ?? label,
+ child: Semantics(
+ label: 'Verdict: $label',
+ child: Container(
+ key: const ValueKey('pane-verdict-chip'),
+ padding: const EdgeInsets.symmetric(horizontal: 7, vertical: 3),
+ decoration: BoxDecoration(
+ color: color.withValues(alpha: .12),
+ borderRadius: BorderRadius.circular(999),
+ border: Border.all(color: color.withValues(alpha: .35)),
+ ),
+ child: Row(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ Icon(icon, size: 12, color: color),
+ const SizedBox(width: 5),
+ Text(
+ label,
+ maxLines: 1,
+ overflow: TextOverflow.ellipsis,
+ style: TextStyle(
+ color: color,
+ fontFamily: AppFonts.sans,
+ fontSize: 11,
+ fontWeight: FontWeight.w600,
+ ),
+ ),
+ ],
+ ),
+ ),
+ ),
+ );
+ }
+}
+
+/// Where the work is: every phase the verdict names, in order, with the one
+/// under way emphasised. Read-only — the harness moves it, not the user.
+class PhaseStrip extends StatelessWidget {
+ const PhaseStrip({super.key, required this.phases});
+
+ final List<AgentPhase> phases;
+
+ @override
+ Widget build(BuildContext context) {
+ final active = phases.indexWhere((p) => p.state == AgentPhaseState.active);
+ final label = active < 0
+ ? phases.map((p) => p.name).join(', ')
+ : '${phases[active].name}, ${active + 1} of ${phases.length}';
+ return Semantics(
+ label: 'Phase: $label',
+ child: Row(
+ key: const ValueKey('pane-phase-strip'),
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ for (var i = 0; i < phases.length; i++) ...[
+ if (i > 0)
+ Padding(
+ padding: const EdgeInsets.symmetric(horizontal: 5),
+ child: Text(
+ '·',
+ style: TextStyle(color: AppColors.textSoft, fontSize: 11),
+ ),
+ ),
+ _PhaseMark(phase: phases[i]),
+ ],
+ ],
+ ),
+ );
+ }
+}
+
+class _PhaseMark extends StatelessWidget {
+ const _PhaseMark({required this.phase});
+
+ final AgentPhase phase;
+
+ @override
+ Widget build(BuildContext context) {
+ final (icon, color, weight) = switch (phase.state) {
+ AgentPhaseState.done => (
+ LucideIcons.check,
+ AppColors.success,
+ FontWeight.w500,
+ ),
+ AgentPhaseState.active => (
+ LucideIcons.circleDot,
+ AppColors.text,
+ FontWeight.w700,
+ ),
+ AgentPhaseState.failed => (
+ LucideIcons.x,
+ AppColors.danger,
+ FontWeight.w500,
+ ),
+ AgentPhaseState.pending => (null, AppColors.textSoft, FontWeight.w500),
+ };
+ return Row(
+ mainAxisSize: MainAxisSize.min,
+ children: [
+ if (icon != null) ...[
+ Icon(icon, size: 11, color: color),
+ const SizedBox(width: 3),
+ ],
+ Text(
+ phase.name,
+ maxLines: 1,
+ overflow: TextOverflow.ellipsis,
+ style: TextStyle(fontSize: 11, fontWeight: weight, color: color),
+ ),
+ ],
+ );
+ }
+}
diff --git a/desktop/lib/widgets/web_pane_panel.dart b/desktop/lib/widgets/web_pane_panel.dart
index c9a0e71e3..d4568de38 100644
--- a/desktop/lib/widgets/web_pane_panel.dart
+++ b/desktop/lib/widgets/web_pane_panel.dart
@@ -4,6 +4,7 @@ import 'package:flutter/material.dart';
import 'package:lucide_icons_flutter/lucide_icons.dart';
import 'package:webview_flutter/webview_flutter.dart';
+import '../core/models.dart' show AgentVerdict;
import '../core/test_run.dart';
import '../shared/theme/app_theme.dart' as grid;
import '../state/app_state.dart';
@@ -11,6 +12,7 @@ import '../state/terminal_pane.dart';
import '../theme/app_theme.dart';
import 'engine_identity.dart';
import 'pane_header_actions.dart';
+import 'verdict_marks.dart';
/// A domain harness's viewer, in a tile beside its agent's terminal.
///
@@ -33,6 +35,7 @@ class WebPanePanel extends StatefulWidget {
required this.ownerName,
required this.ownerEngine,
this.ownerDisplayName,
+ this.verdict,
this.onClose,
this.onToggleZoom,
this.zoomed = false,
@@ -46,6 +49,11 @@ class WebPanePanel extends StatefulWidget {
final String ownerName;
final String? ownerEngine;
final String? ownerDisplayName;
+
+ /// The harness's verdict on the workspace this viewer shows, for the phase
+ /// strip and the chip in the header. The viewer IS the product, so this
+ /// header carries them in full where the terminal's shows only the chip.
+ final AgentVerdict? verdict;
final VoidCallback? onClose;
final VoidCallback? onToggleZoom;
final bool zoomed;
@@ -199,6 +207,19 @@ class _WebPanePanelState extends State<WebPanePanel> {
),
),
const SizedBox(width: 8),
+ if (widget.verdict case final verdict?) ...[
+ if (!compact && verdict.phases.isNotEmpty)
+ Flexible(
+ child: Padding(
+ padding: const EdgeInsets.only(right: 10),
+ child: PhaseStrip(phases: verdict.phases),
+ ),
+ ),
+ Padding(
+ padding: const EdgeInsets.only(right: 6),
+ child: VerdictChip(verdict: verdict),
+ ),
+ ],
if (_loading)
const Padding(
padding: EdgeInsets.symmetric(horizontal: 6),
diff --git a/desktop/test/verdict_marks_test.dart b/desktop/test/verdict_marks_test.dart
new file mode 100644
index 000000000..69a33d44f
--- /dev/null
+++ b/desktop/test/verdict_marks_test.dart
@@ -0,0 +1,76 @@
+// The verdict's phases: parsed defensively from the frame, drawn as a strip
+// beside the chip in the viewer pane's header.
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:harness/core/models.dart';
+import 'package:harness/widgets/verdict_marks.dart';
+
+void main() {
+ test('phases parse in order, defaulting and dropping what is malformed', () {
+ final verdict = AgentVerdict.fromJson({
+ 'ready': false,
+ 'phases': [
+ {'id': 'build', 'name': 'Build', 'state': 'done', 'artifact': 'a.step'},
+ {'name': 'Checks', 'state': 'active'},
+ {'name': 'Fab', 'state': 'someday'},
+ {'name': '', 'state': 'done'},
+ 'nope',
+ {'id': 'x', 'state': 'done'},
+ ],
+ })!;
+ expect(verdict.phases.map((p) => p.name), ['Build', 'Checks', 'Fab']);
+ expect(verdict.phases.map((p) => p.state), [
+ AgentPhaseState.done,
+ AgentPhaseState.active,
+ AgentPhaseState.pending,
+ ]);
+ expect(verdict.phases.first.artifact, 'a.step');
+ expect(verdict.phases[1].id, 'checks');
+ expect(verdict.activePhase?.name, 'Checks');
+ expect(AgentVerdict.fromJson({'ready': true})!.phases, isEmpty);
+ expect(
+ AgentVerdict.fromJson({'ready': true, 'phases': 'x'})!.phases,
+ isEmpty,
+ );
+ final many = AgentVerdict.fromJson({
+ 'ready': true,
+ 'phases': [
+ for (var i = 0; i < 20; i++) {'name': 'P$i'},
+ ],
+ })!;
+ expect(many.phases, hasLength(12));
+ });
+
+ testWidgets('the strip names every phase and says which is under way', (
+ tester,
+ ) async {
+ const phases = [
+ AgentPhase(id: 'outline', name: 'Outline', state: AgentPhaseState.done),
+ AgentPhase(id: 'draft', name: 'Draft', state: AgentPhaseState.active),
+ AgentPhase(id: 'polish', name: 'Polish'),
+ ];
+ await tester.pumpWidget(
+ const MaterialApp(
+ home: Scaffold(
+ body: Center(child: PhaseStrip(phases: phases)),
+ ),
+ ),
+ );
+ expect(find.byKey(const ValueKey('pane-phase-strip')), findsOneWidget);
+ expect(find.text('Outline'), findsOneWidget);
+ expect(find.text('Draft'), findsOneWidget);
+ expect(find.text('Polish'), findsOneWidget);
+ });
+
+ testWidgets('the chip reads the verdict in one word', (tester) async {
+ await tester.pumpWidget(
+ const MaterialApp(
+ home: Scaffold(
+ body: VerdictChip(verdict: AgentVerdict(ready: true, summary: 'ok')),
+ ),
+ ),
+ );
+ expect(find.text('Ready'), findsOneWidget);
+ expect(find.byKey(const ValueKey('pane-verdict-chip')), findsOneWidget);
+ });
+}
diff --git a/dsh/spec/CHANGES.md b/dsh/spec/CHANGES.md
index bcb82b2cd..6275497d8 100644
--- a/dsh/spec/CHANGES.md
+++ b/dsh/spec/CHANGES.md
@@ -5,3 +5,12 @@ Append-only. Each entry: Change / Why / Backward compatible / Mechanism.
## 2026-09-14 — spec 1
Initial contract. Lifted from the `.board.json` (Circuit) and `.episode.json` (TV) sidecars and the Vibe viewer's `serve:ensure` handoff.
+
+## 2026-09-15 — phases in the verdict
+- **Change:** `verdict.phases` (optional, ≤ 12): `[{ id, name, state, artifact? }]` with
+ `state ∈ done | active | pending | failed`. The daemon forwards it on `AgentFrame.verdict.phases`;
+ the desktop draws a phase strip in the viewer pane's header beside the verdict chip.
+- **Why:** the pane is progressive — a Workshop run is research, concept, 3D, verify, and the user
+ watching the viewer needs to know which of those is happening. The verdict already moves; this
+ is the one line that says where.
+- **Backward compatible:** yes — absent means no strip; every existing verdict is unchanged.
diff --git a/dsh/spec/README.md b/dsh/spec/README.md
index 342927758..71c59b85e 100644
--- a/dsh/spec/README.md
+++ b/dsh/spec/README.md
@@ -64,10 +64,20 @@ grids and Codex profiles use, on create AND on every relaunch (`buildLaunchOverr
{ "severity": "error", "kind": "source_trace_not_connected", "message": "…", "ref": "U3.pin7" }
], // severity ∈ error | warning | info; kind is open
"artifact": "boards/main.board.json", // optional; primary thing to view, workspace-relative
+ "phases": [ // optional; where the work is, in order, for the pane header
+ { "id": "build", "name": "Build", "state": "done" },
+ { "id": "checks", "name": "Checks", "state": "active" },
+ { "id": "fab", "name": "Fab", "state": "pending" }
+ ], // state ∈ done | active | pending | failed; ≤ 12 phases
"updatedAt": "2026-09-14T20:00:00Z"
}
```
+The verdict is a feed, not a gate: write it at every phase change and every check, not only at the
+end. The pane is the product, and it must move while the agent works — a harness that only writes a
+final verdict is not progressive. `phases` is how the header says "you are here"; `ready` stays the
+one final truth.
+
Lifted from Circuit's `.board.json` and TV's `.episode.json` sidecars (same severity gate). Circuit
writes it beside the sidecar in `circuitpy.generation`; Workshop writes it from `verify_project`.
@@ -76,7 +86,7 @@ writes it beside the sidecar in `circuitpy.generation`; Workshop writes it from
- `agent_create` payload gains `dsh?: string`. Refused with `INVALID_DSH` when not installed on
this machine or when `engine` is not the DSH's base.
- `AgentFrame` gains `dsh: string | null`, `dshName: string | null`, `viewerUrl: string | null`,
- `verdict: { ready, summary, errors, warnings, artifact, updatedAt } | null`. Null is a real answer
+ `verdict: { ready, summary, errors, warnings, artifact, phases, updatedAt } | null`. Null is a real answer
(see `agentFrame.ts`'s doc on erased fields).
- `dsh_list` → `{ dsh: [{ id, name, description, engine, installed, viewer, tier }] }`: installed
DSHs on this machine merged with the bundled registry (`dsh/registry/**/*.json`).
diff --git a/dsh/spec/schema/verdict.schema.json b/dsh/spec/schema/verdict.schema.json
index fd10e25d0..08548318f 100644
--- a/dsh/spec/schema/verdict.schema.json
+++ b/dsh/spec/schema/verdict.schema.json
@@ -4,26 +4,96 @@
"title": "Domain-specific harness verdict (.harness/verdict.json), spec 1",
"type": "object",
"additionalProperties": true,
- "required": ["spec", "ready"],
+ "required": [
+ "spec",
+ "ready"
+ ],
"properties": {
- "spec": { "const": 1 },
- "ready": { "type": "boolean", "description": "The one machine fact: fab.ready, all gates passed, exam passed." },
- "summary": { "type": "string", "maxLength": 200, "description": "One line for the pane header." },
+ "spec": {
+ "const": 1
+ },
+ "ready": {
+ "type": "boolean",
+ "description": "The one machine fact: fab.ready, all gates passed, exam passed."
+ },
+ "summary": {
+ "type": "string",
+ "maxLength": 200,
+ "description": "One line for the pane header."
+ },
"findings": {
"type": "array",
"items": {
"type": "object",
- "required": ["severity", "message"],
+ "required": [
+ "severity",
+ "message"
+ ],
"additionalProperties": true,
"properties": {
- "severity": { "enum": ["error", "warning", "info"] },
- "kind": { "type": "string", "description": "Open set; never switched on by Harness." },
- "message": { "type": "string" },
- "ref": { "type": "string", "description": "What it is about: a part, a gate, a file." }
+ "severity": {
+ "enum": [
+ "error",
+ "warning",
+ "info"
+ ]
+ },
+ "kind": {
+ "type": "string",
+ "description": "Open set; never switched on by Harness."
+ },
+ "message": {
+ "type": "string"
+ },
+ "ref": {
+ "type": "string",
+ "description": "What it is about: a part, a gate, a file."
+ }
}
}
},
- "artifact": { "type": "string", "description": "Workspace-relative path of the primary thing to view." },
- "updatedAt": { "type": "string", "format": "date-time" }
+ "artifact": {
+ "type": "string",
+ "description": "Workspace-relative path of the primary thing to view."
+ },
+ "updatedAt": {
+ "type": "string",
+ "format": "date-time"
+ },
+ "phases": {
+ "type": "array",
+ "maxItems": 12,
+ "description": "Where the work is, for the pane header's phase strip: the phases in order, each with a state. Optional; a harness with one phase writes none.",
+ "items": {
+ "type": "object",
+ "required": [
+ "name"
+ ],
+ "additionalProperties": true,
+ "properties": {
+ "id": {
+ "type": "string",
+ "maxLength": 40
+ },
+ "name": {
+ "type": "string",
+ "maxLength": 40
+ },
+ "state": {
+ "enum": [
+ "done",
+ "active",
+ "pending",
+ "failed"
+ ],
+ "default": "pending"
+ },
+ "artifact": {
+ "type": "string",
+ "description": "Workspace-relative path of what this phase produced, when it has one."
+ }
+ }
+ }
+ }
}
}