Skip to content

Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.

fix(deck): the sweep turns about the ring, one ghost leaves the stage, the board latches, and the cue is big

Harald4badfae85eee
diff --git a/jarvis/ui/web/frontend/src/App.tsx b/jarvis/ui/web/frontend/src/App.tsx
index 6b41b03482..bc9c9c7268 100644
--- a/jarvis/ui/web/frontend/src/App.tsx
+++ b/jarvis/ui/web/frontend/src/App.tsx
@@ -46,9 +46,11 @@ const NAV_COLLAPSED_KEY = "jarvis.sidebar.collapsed.v1";
* Which artwork is shown belongs to the user — see the Wallpaper section. The
* picture that ships with the app remains the default, and the one every
* failure path returns to. Gigi is a separate live layer on that ground, not
- * painted into the picture.
+ * painted into the picture — and he steps off it while the mission deck is on
+ * stage (`hideMascot`): the deck's ring and console own that corner, and a
+ * second ghost next to the orb was one too many (maintainer, 2026-08-19).
*/
-function DesktopWallpaper() {
+function DesktopWallpaper({ hideMascot = false }: { hideMascot?: boolean }) {
const wallpaperUrl = useDesktopWallpaper();
const mascotOn = useWallpaperStore((state) => state.mascotOn);
return (
@@ -61,7 +63,7 @@ function DesktopWallpaper() {
className="jarvis-desktop-wallpaper absolute inset-0"
style={{ backgroundImage: `url(${wallpaperUrl})` }}
/>
- {mascotOn ? (
+ {mascotOn && !hideMascot ? (
<div
className="jarvis-desktop-wallpaper-mascot"
data-testid="jarvis-desktop-wallpaper-mascot"
@@ -286,7 +288,7 @@ export default function App() {
if (solo) {
return (
<div className="relative isolate flex h-screen w-screen overflow-hidden bg-background text-foreground">
- <DesktopWallpaper />
+ <DesktopWallpaper hideMascot={deckOnStage} />
{brokerMounted && <SubscriptionRealtimeTransportBroker />}
<main className="relative z-10 flex min-w-0 flex-1 flex-col">
<SectionStage visualization={visualizationActive}>
@@ -303,7 +305,7 @@ export default function App() {
return (
<div className="relative isolate flex h-screen w-screen overflow-hidden bg-background text-foreground">
{brokerMounted && <SubscriptionRealtimeTransportBroker />}
- <DesktopWallpaper />
+ <DesktopWallpaper hideMascot={deckOnStage} />
{!deckOnStage && (
<>
diff --git a/jarvis/ui/web/frontend/src/components/deck/DeckOrb.test.tsx b/jarvis/ui/web/frontend/src/components/deck/DeckOrb.test.tsx
index 4b770b7cc3..2fc173fac9 100644
--- a/jarvis/ui/web/frontend/src/components/deck/DeckOrb.test.tsx
+++ b/jarvis/ui/web/frontend/src/components/deck/DeckOrb.test.tsx
@@ -16,9 +16,10 @@ import { DeckOrb } from "@/components/deck/DeckOrb";
* The orb is the click-shaped wake word (maintainer, 2026-08-18): pressing
* the orb in the centre does what saying the phrase does. Display-only
* callers get no button at all. The orb is the product's own artwork — the
- * sphere cut out of `hero-orb.png` — with the mascot in its core (maintainer's
- * pick, 2026-08-18, replacing the dark mask), and it carries the live voice
- * state so it can breathe with it.
+ * sphere cut out of `hero-orb.png` — and nothing else in its core: the mascot
+ * that rode there for a day made two ghosts on one stage next to the live
+ * wallpaper mascot (maintainer, 2026-08-19). It carries the live voice state
+ * so it can breathe with it.
*/
describe("DeckOrb", () => {
afterEach(() => cleanup());
@@ -29,17 +30,15 @@ describe("DeckOrb", () => {
expect(screen.getByTestId("jarvis-orb")).toBeTruthy();
});
- test("the centre is the Jarvis orb artwork with the mascot in its core", () => {
+ test("the centre is the Jarvis orb artwork, and nothing rides in its core", () => {
render(<DeckOrb steps={[]} busy={false} />);
const orb = screen.getByTestId("jarvis-orb");
expect(orb.getAttribute("data-voice")).toBe("idle");
const images = orb.querySelectorAll("img");
- expect(images).toHaveLength(2);
+ expect(images).toHaveLength(1);
expect(images[0].getAttribute("src")).toBe("/deck-orb.png");
- expect(images[1].getAttribute("src")).toBe("/jarvis-gigi-256.png");
// Artwork, not content: nothing here is read out.
expect(images[0].getAttribute("alt")).toBe("");
- expect(images[1].getAttribute("alt")).toBe("");
});
test("a press on the orb fires the handler and carries its label", () => {
diff --git a/jarvis/ui/web/frontend/src/components/deck/DeckStandby.test.tsx b/jarvis/ui/web/frontend/src/components/deck/DeckStandby.test.tsx
index dbd3586d38..fae415a46e 100644
--- a/jarvis/ui/web/frontend/src/components/deck/DeckStandby.test.tsx
+++ b/jarvis/ui/web/frontend/src/components/deck/DeckStandby.test.tsx
@@ -153,7 +153,9 @@ describe("DeckStandby — standby", () => {
renderStage("standby");
expect(screen.getByTestId("deck-standby").getAttribute("data-phase")).toBe("standby");
expect(screen.getByText("standby")).toBeTruthy();
- expect(screen.getByText("Say “Hey Nova” — or click the orb.")).toBeTruthy();
+ // The cue: big, and it names the phrase.
+ expect(screen.getByTestId("deck-standby-cue").textContent).toBe("Say “Hey Nova”");
+ expect(screen.getByText(/or click the orb\. The board opens the moment you speak\./)).toBeTruthy();
// The wake word is on and the voice is idle: the ring sweeps.
expect(screen.getByTestId("deck-standby-ring").getAttribute("data-sweep")).toBe("true");
expect(screen.getByTestId("deck-ring-sweep")).toBeTruthy();
@@ -166,9 +168,11 @@ describe("DeckStandby — standby", () => {
expect(c.queryByText(/ ms$| s$/)).toBeNull();
});
- test("a wake word that is off is said so, and the ring stays still", () => {
+ test("a wake word that is off is said so, the cue points at the orb, and the ring stays still", () => {
renderStage("standby", { wakeConfig: { ...WAKE, enabled: false } });
expect(console_().getByText(/wake word off/)).toBeTruthy();
+ expect(screen.getByTestId("deck-standby-cue").textContent).toBe("Click the orb");
+ expect(screen.getByText(/or press the hotkey/)).toBeTruthy();
expect(screen.getByTestId("deck-standby-ring").getAttribute("data-sweep")).toBe("false");
expect(screen.queryByTestId("deck-ring-sweep")).toBeNull();
expect(console_().getByText("voice idle")).toBeTruthy();
diff --git a/jarvis/ui/web/frontend/src/components/deck/DeckStandby.tsx b/jarvis/ui/web/frontend/src/components/deck/DeckStandby.tsx
index 104b067616..e676feafe0 100644
--- a/jarvis/ui/web/frontend/src/components/deck/DeckStandby.tsx
+++ b/jarvis/ui/web/frontend/src/components/deck/DeckStandby.tsx
@@ -45,8 +45,9 @@ import { useT } from "@/i18n";
* Standby: the sweep turns on the ring while the wake word is actually being
* listened for (and stays still when it is not — hotkey-only setups, a link
* that dropped), the clock and the "quiet for" figure tick, the orb breathes.
- * The headline names the phrase to say. Nothing else moves: the standby has
- * to be calm enough to sit next to for an hour.
+ * The cue under the orb names the phrase to say — big, breathing slowly,
+ * because it is the one thing a newcomer must read. Nothing else moves: the
+ * standby has to be calm enough to sit next to for an hour.
*
* The board is one press away at all times (`onOpenBoard`), and takes over
* on its own the moment a turn opens — that hand-off is MissionDeckView's,
@@ -56,7 +57,7 @@ import { useT } from "@/i18n";
/** How the orb travels between this ring and its place on the board. */
export const ORB_TRAVEL = { layout: { duration: 0.62, ease: [0.2, 0.8, 0.2, 1] } } as const;
/** The ring is labelled at the compass points only when there is room. */
-const LABELS_MIN_RING = 480;
+const LABELS_MIN_RING = 520;
/** The corner blocks leave the ring's sides alone from this stage width. */
const WIDE_STAGE = 1040;
@@ -196,8 +197,10 @@ export function DeckStandby({
return out;
}, [gates]);
- const headline =
- phase === "boot" ? null : t("deck.idle_headline").replace("{0}", wakePhrase);
+ // The cue under the orb: what to do so something happens. Big, because a
+ // person who has never used the app must read it from across the room
+ // (maintainer, 2026-08-19: "you have to see that you must say something").
+ const wakeOn = gates.find((g) => g.id === "wake")?.state === "ok";
const corner = (extra: string, children: ReactNode) => (
<div className={cn("absolute z-10", extra)}>{children}</div>
@@ -258,7 +261,7 @@ export function DeckStandby({
</motion.div>
</div>
- {/* Under the reticle, inside the ring: the boot title, then the phrase to say. */}
+ {/* Under the reticle, inside the ring: the boot title, then the cue. */}
<div
className="absolute inset-x-0 flex justify-center px-6 text-center"
style={{ top: ring / 2 + reticle / 2 + 12 }}
@@ -266,17 +269,28 @@ export function DeckStandby({
{phase === "boot" ? (
<BootTitle text={t("deck.boot_title")} animate={!reduced} />
) : (
- <motion.p
- key="idle"
+ <motion.div
+ key="cue"
variants={{
hidden: { opacity: 0, y: 6 },
show: { opacity: 1, y: 0, transition: { duration: 0.5, delay: 0.3 } },
exit: { opacity: 0, y: 6, transition: { duration: 0.2 } },
}}
- className="max-w-[40ch] text-pretty text-sm leading-relaxed text-muted-foreground"
+ className="flex flex-col items-center gap-1"
>
- {headline}
- </motion.p>
+ <p
+ className={cn(
+ "font-display text-lg font-bold uppercase tracking-[0.26em] text-primary sm:text-xl",
+ !reduced && "deck-standby-cue",
+ )}
+ data-testid="deck-standby-cue"
+ >
+ {wakeOn ? t("deck.standby_cue").replace("{0}", wakePhrase) : t("deck.standby_cue_off")}
+ </p>
+ <p className="max-w-[62ch] text-pretty text-xs leading-relaxed text-muted-foreground">
+ {t(wakeOn ? "deck.standby_cue_sub" : "deck.standby_cue_sub_off")}
+ </p>
+ </motion.div>
)}
</div>
</div>
@@ -392,11 +406,6 @@ export function DeckStandby({
variants={{ exit: { opacity: 0, x: 14, transition: { duration: 0.25 } } }}
className="flex flex-col items-end gap-1.5"
>
- {wide && (
- <span className="max-w-[28ch] text-pretty text-[11px] leading-snug text-muted-foreground">
- {t("deck.standby_hint")}
- </span>
- )}
<button
type="button"
onClick={onOpenBoard}
diff --git a/jarvis/ui/web/frontend/src/components/deck/JarvisOrb.tsx b/jarvis/ui/web/frontend/src/components/deck/JarvisOrb.tsx
index e8ac3e1ded..db5ade5eb4 100644
--- a/jarvis/ui/web/frontend/src/components/deck/JarvisOrb.tsx
+++ b/jarvis/ui/web/frontend/src/components/deck/JarvisOrb.tsx
@@ -11,9 +11,9 @@ import { cn } from "@/lib/utils";
* on the wallpaper as a thing, not as a picture of a thing. The maintainer
* asked for exactly this on 2026-08-18: the orb IS a PNG, so bring the PNG.
*
- * The mascot rides in the plasma core as a silhouette — the same language as
- * the wallpaper's black ghost on gold, and readable at any size because the
- * core is the brightest thing on the screen.
+ * The core carries NO mascot. It did for a day (a silhouette on the gold,
+ * 2026-08-18); with the live mascot on the wallpaper that made two ghosts on
+ * one stage, and the maintainer took it out (2026-08-19): the orb is the orb.
*
* Voice state moves it a little, honestly and cheaply: a slow breath at rest,
* a brighter, quicker pulse while listening, quicker still while it speaks, a
@@ -52,10 +52,6 @@ const MOTION: Record<VoiceState, { animate: TargetAndTransition; duration: numbe
},
};
-/** Where the plasma core sits inside the cut-out (fractions of the image). */
-const CORE_CENTRE_Y = 0.547;
-const MASCOT_OF_ORB = 0.24;
-
export function JarvisOrb({
size,
voiceState,
@@ -90,15 +86,6 @@ export function JarvisOrb({
: { duration: 0.4 }
}
/>
- {/* The mascot in the core. A silhouette on gold, like the wallpaper. */}
- <img
- src="/jarvis-gigi-256.png"
- alt=""
- draggable={false}
- aria-hidden
- className="pointer-events-none absolute left-1/2 -translate-x-1/2 -translate-y-1/2"
- style={{ top: `${CORE_CENTRE_Y * 100}%`, width: size * MASCOT_OF_ORB, height: size * MASCOT_OF_ORB }}
- />
</div>
);
}
diff --git a/jarvis/ui/web/frontend/src/i18n/locales/de.json b/jarvis/ui/web/frontend/src/i18n/locales/de.json
index 7a1c63b869..591b0fb5e1 100644
--- a/jarvis/ui/web/frontend/src/i18n/locales/de.json
+++ b/jarvis/ui/web/frontend/src/i18n/locales/de.json
@@ -4505,7 +4505,10 @@
"standby_since": "seit {0}",
"standby_still": "Stimme ruht",
"standby_error": "Stimme meldet einen Fehler – siehe Log",
- "standby_hint": "Das Board öffnet sich, sobald du sprichst.",
+ "standby_cue": "Sag „{0}“",
+ "standby_cue_off": "Klick auf den Orb",
+ "standby_cue_sub": "– oder klick auf den Orb. Das Board öffnet sich, sobald du sprichst.",
+ "standby_cue_sub_off": "– oder drück den Hotkey. Das Board öffnet sich, sobald du sprichst.",
"open_board": "Board öffnen"
},
"modes_view": {
diff --git a/jarvis/ui/web/frontend/src/i18n/locales/en.json b/jarvis/ui/web/frontend/src/i18n/locales/en.json
index 4ec8667266..908744279d 100644
--- a/jarvis/ui/web/frontend/src/i18n/locales/en.json
+++ b/jarvis/ui/web/frontend/src/i18n/locales/en.json
@@ -4505,7 +4505,10 @@
"standby_since": "since {0}",
"standby_still": "voice idle",
"standby_error": "voice reported an error — see the log",
- "standby_hint": "The board opens the moment you speak.",
+ "standby_cue": "Say “{0}”",
+ "standby_cue_off": "Click the orb",
+ "standby_cue_sub": "— or click the orb. The board opens the moment you speak.",
+ "standby_cue_sub_off": "— or press the hotkey. The board opens the moment you speak.",
"open_board": "Open the board"
},
"modes_view": {
diff --git a/jarvis/ui/web/frontend/src/i18n/locales/es.json b/jarvis/ui/web/frontend/src/i18n/locales/es.json
index c241d1180b..d09587343f 100644
--- a/jarvis/ui/web/frontend/src/i18n/locales/es.json
+++ b/jarvis/ui/web/frontend/src/i18n/locales/es.json
@@ -4505,7 +4505,10 @@
"standby_since": "desde {0}",
"standby_still": "voz en reposo",
"standby_error": "la voz reportó un error — mira el registro",
- "standby_hint": "El tablero se abre en cuanto hables.",
+ "standby_cue": "Di «{0}»",
+ "standby_cue_off": "Haz clic en el orbe",
+ "standby_cue_sub": "— o haz clic en el orbe. El tablero se abre en cuanto hables.",
+ "standby_cue_sub_off": "— o pulsa el atajo. El tablero se abre en cuanto hables.",
"open_board": "Abrir el tablero"
},
"modes_view": {
diff --git a/jarvis/ui/web/frontend/src/index.css b/jarvis/ui/web/frontend/src/index.css
index 0d51344434..1703d6d0fc 100644
--- a/jarvis/ui/web/frontend/src/index.css
+++ b/jarvis/ui/web/frontend/src/index.css
@@ -2229,8 +2229,10 @@
}
/* the sweep: one turn every 14 s — the wake-word listener made visible */
.deck-ring-sweep {
- transform-box: fill-box;
- transform-origin: center;
+ /* view-box, not fill-box: the sweep is a short arc, and its own box's
+ centre is nowhere near the ring's — it must turn about the ring. */
+ transform-box: view-box;
+ transform-origin: 50% 50%;
animation: deck-ring-sweep 14s linear infinite;
}
@keyframes deck-ring-sweep {
@@ -2240,10 +2242,23 @@
}
/* the ping: once, when the boot completes — a ring leaves the orb and dies at the bezel */
.deck-ring-ping {
- transform-box: fill-box;
- transform-origin: center;
+ transform-box: view-box;
+ transform-origin: 50% 50%;
animation: deck-ring-ping 1100ms cubic-bezier(0.1, 0.6, 0.3, 1) forwards;
}
+ /* the cue under the orb breathes slowly: it is waiting for the person */
+ .deck-standby-cue {
+ animation: deck-standby-cue 3.2s ease-in-out infinite;
+ }
+ @keyframes deck-standby-cue {
+ 0%,
+ 100% {
+ opacity: 1;
+ }
+ 50% {
+ opacity: 0.62;
+ }
+ }
@keyframes deck-ring-ping {
0% {
transform: scale(0.35);
@@ -2334,6 +2349,7 @@
.deck-gate-arc,
.deck-ring-sweep,
.deck-ring-ping,
+ .deck-standby-cue,
.deck-boot-line,
.deck-boot-caret,
.deck-boot-dots span,
diff --git a/jarvis/ui/web/frontend/src/views/MissionDeckView.phases.test.tsx b/jarvis/ui/web/frontend/src/views/MissionDeckView.phases.test.tsx
index feb2f40555..bac673fc99 100644
--- a/jarvis/ui/web/frontend/src/views/MissionDeckView.phases.test.tsx
+++ b/jarvis/ui/web/frontend/src/views/MissionDeckView.phases.test.tsx
@@ -96,7 +96,20 @@ describe("MissionDeckView — the three acts", () => {
render(<MissionDeckView />);
expect(screen.getByTestId("deck-standby").getAttribute("data-phase")).toBe("standby");
expect(screen.queryByTestId("deck-board")).toBeNull();
- expect(screen.getByText("Say “Hey Nova” — or click the orb.")).toBeTruthy();
+ expect(screen.getByTestId("deck-standby-cue").textContent).toBe("Say “Hey Nova”");
+ });
+
+ test("a reason for the board that comes and goes still leaves the board open", async () => {
+ render(<MissionDeckView />);
+ // The transport negotiates: the board takes over …
+ act(() => useEventStore.setState({ voiceState: "connecting" }));
+ expect(screen.getByTestId("deck-board")).toBeTruthy();
+ // … and the reason vanishes without a turn. The board stays: an
+ // interrupted hand-off left the ring back with nothing in it (2026-08-19).
+ act(() => useEventStore.setState({ voiceState: "idle" }));
+ expect(useDeckStore.getState().boardOpen).toBe(true);
+ expect(screen.getByTestId("deck-board")).toBeTruthy();
+ await waitFor(() => expect(screen.queryByTestId("deck-standby")).toBeNull(), { timeout: 3000 });
});
test("the first turn opens the board, and the board powers on around the orb", async () => {
diff --git a/jarvis/ui/web/frontend/src/views/MissionDeckView.tsx b/jarvis/ui/web/frontend/src/views/MissionDeckView.tsx
index afbcd82fe9..f842ba5882 100644
--- a/jarvis/ui/web/frontend/src/views/MissionDeckView.tsx
+++ b/jarvis/ui/web/frontend/src/views/MissionDeckView.tsx
@@ -1,4 +1,4 @@
-import { useMemo, useRef, type ReactNode } from "react";
+import { useEffect, useMemo, useRef, type ReactNode } from "react";
import { AnimatePresence, MotionConfig, motion } from "framer-motion";
import { useEventStore, type VoiceState } from "@/store/events";
import { useDeckStore } from "@/store/deck";
@@ -115,6 +115,15 @@ export function MissionDeckView({
messageCount: messages.length,
voiceEngaged: callActive || connecting,
});
+ // Forward only, for real: a transient reason for the board (a call being
+ // set up, a voice state that came and went without a turn) must not let the
+ // standby come back over a stage that already handed off — an interrupted
+ // hand-off leaves the orb's shared-layout crossfade half-way, with the ring
+ // back and nothing in it (seen 2026-08-19). So the first board render
+ // latches the store's sticky flag.
+ useEffect(() => {
+ if (phase === "board") openBoard();
+ }, [phase, openBoard]);
// The board powers on with its choreography ONLY when it takes over from
// the standby on this very screen. A deck that mounts straight into a
// running session (a section change and back) is simply there. Fixed on