cozyclay 3.2.0 → 3.2.1

package/src/shell/ViewportToolbar.jsx

@@ -6,12 +6,11 @@ import { PRESETS, SHOT_ASPECT_PRESETS } from "../app-stage.jsx";
 import { CAMERA_PRESETS } from "../camera-move.js";
 import { PRIME_SET } from "../shot.js";
 import { CatalogueEntries } from "../object-catalog.jsx";
-import { CHARACTER_MODEL_IDS } from "../scenes.js";
 import { elementByPath } from "../studio-elements.js";
 import { saveAutoColor } from "../auto-color.js";
 import { trackFeature } from "../analytics.js";
 import { GUIDE_LABELS, nextGuideMode } from "../shot-guides.js";
-import GhostsMenuGroup from "./GhostsMenuGroup.jsx"; import { addCameraShot } from "./add-camera-shot.js";
+import GhostsMenuGroup from "./GhostsMenuGroup.jsx"; import { addCameraShot } from "./add-camera-shot.js"; import { addCharacterEntries } from "./add-character-entries.js";
 import "./viewport.css";
 
 // G1: the single mode+tool pill. Keys 1-5 and W/E/R are bound in App's
@@ -122,7 +121,7 @@ export default function ViewportToolbar() {
 		autoColor, setAutoColor, isCharacterSelection, partColoursChoice, embedMode,
 		agentCollapsed, addSceneObject, spawnCharacter, characters, flySpeed,
 		ikEditTool, setIkEditTool, motion, setRangePinPartPick,
-		previsMode, sculptView, requestSculptView, appContext, setToast,
+		previsMode, castStyle, sculptView, requestSculptView, sculptParts, appContext, setToast,
 	} = useStudioShell();
 	const menu = useOverlayMenu();
 
@@ -154,11 +153,11 @@ export default function ViewportToolbar() {
 		],
 		// Motion is compiled by the agent (motion.compile); the department has no tools of its own.
 		motion: [],
-		// Sculpt mode's W/E/R swing the turntable camera to a reference view.
-		sculpt: [
-			{ key: "W", id: "front", name: ko("Front view", "정면 보기"), active: sculptView?.view === "front", pick: () => requestSculptView("front") },
-			{ key: "E", id: "side", name: ko("Side view", "측면 보기"), active: sculptView?.view === "side", pick: () => requestSculptView("side") },
-			{ key: "R", id: "back", name: ko("Back view", "뒷면 보기"), active: sculptView?.view === "back", pick: () => requestSculptView("back") },
+		// Sculpt mode's W/E/R swing the turntable camera to a reference view; with a part selected they drive its gizmo.
+		sculpt: sculptParts?.selected ? sculptParts.tools : [
+			{ key: "W", id: "front", name: ko("Front view (with a part selected, W moves it)", "정면 보기 (부품을 선택하면 W는 이동)"), active: sculptView?.view === "front", pick: () => requestSculptView("front") },
+			{ key: "E", id: "side", name: ko("Side view (with a part selected, E rotates it)", "측면 보기 (부품을 선택하면 E는 회전)"), active: sculptView?.view === "side", pick: () => requestSculptView("side") },
+			{ key: "R", id: "back", name: ko("Back view (with a part selected, R scales it)", "뒷면 보기 (부품을 선택하면 R은 크기)"), active: sculptView?.view === "back", pick: () => requestSculptView("back") },
 		],
 	}[workflowMode] ?? [];
 
@@ -277,16 +276,14 @@ export default function ViewportToolbar() {
 							<CatalogueEntries onPick={(kind) => { addSceneObject(kind); menu.close(); }} />
 							<div className="add-object-group">
 								<span className="add-object-heading">{ko("Scene", "장면")}</span>
-								<button
-									type="button"
-									role="menuitem"
-									className="add-object-item"
-									data-add="character"
-									onClick={() => { spawnCharacter(CHARACTER_MODEL_IDS[0], characterSpawnX(characters.length), 0); menu.close(); }}
-								>
-									<span className="add-object-swatch vp-add-swatch-cast" aria-hidden="true" />
-									<span>{ko("Character", "캐릭터")}</span>
-								</button>
+								{addCharacterEntries(castStyle).map((entry) => (
+									<button key={entry.add} type="button" role="menuitem" className="add-object-item" data-add={entry.add}
+										onClick={() => { spawnCharacter(entry.model, characterSpawnX(characters.length), 0); menu.close(); }}
+									>
+										<span className="add-object-swatch vp-add-swatch-cast" aria-hidden="true" />
+										<span>{entry.label()}</span>
+									</button>
+								))}
 								<button
 									type="button"
 									role="menuitem"

package/src/shell/add-character-entries.js

@@ -0,0 +1,13 @@
+// Add > Character offers both bodies in every project (ViewportToolbar). The
+// project's cast style only decides which one comes first: never hide either.
+import { ko } from "../locale.js";
+import { CHARACTER_MODEL_IDS, PROXY_FIGURE_MODEL } from "../scenes.js";
+
+const ENTRIES = Object.freeze([
+	Object.freeze({ add: "character", model: CHARACTER_MODEL_IDS[0], label: () => "Y Bot" }),
+	Object.freeze({ add: "capsule", model: PROXY_FIGURE_MODEL, label: () => ko("Capsule figure", "캡슐 인물") }),
+]);
+
+export function addCharacterEntries(castStyle) {
+	return castStyle === "capsule" ? [ENTRIES[1], ENTRIES[0]] : ENTRIES;
+}

package/src/shell/pose-controls.js

@@ -0,0 +1,32 @@
+import { ko } from "../locale.js";
+import { DEFAULT_POSE } from "../poses.js";
+import { FINGER_PRESETS } from "../motion/fingers.js";
+
+// The Pose panel's reset and the focused hand's finger controls, read off the studio shell.
+export function posePanelControls(shell) {
+	const { motion, characters, runStudioAction, castDomain, setStudioPick, setToast, cancelPendingIkEdit } = shell;
+	// Over a take the default is the take itself: drop the IK edits and keep the motion.
+	// Without one, back to the default pose; clearMotion also drops the IK keys (one undo step).
+	const resetPose = (characterId) => {
+		cancelPendingIkEdit?.();
+		const current = characters.find((entry) => entry.id === characterId)?.pose;
+		// Already on the default pose: only the IK edits go. A pose write would re-apply the
+		// bare pose on Undo over the restored IK keys.
+		if (motion || !current || current.id === DEFAULT_POSE.id) {
+			runStudioAction("character.clearIkKeys", { characterId });
+			if (motion) {
+				setToast(ko("Pose edits cleared — the motion stays", "포즈 수정을 지웠어요 — 모션은 그대로예요"));
+				return;
+			}
+		} else castDomain.run('character.setPose', { characterId, pose: DEFAULT_POSE.id, clearMotion: true });
+		setStudioPick(DEFAULT_POSE.id);
+		setToast(ko("Back to the default pose", "기본 포즈로 돌아왔어요"));
+	};
+	const { handFingers: fingers, ikTick, ikSolve, ikDragEnd, fingerEditing, setFingerEdit } = shell;
+	const fingerPanel = {
+		fingers, tick: ikTick, editing: fingerEditing, onToggleEdit: () => setFingerEdit(!fingerEditing),
+		onCurl: (id, curl) => ikSolve("finger", id, { curl }), onCommit: ikDragEnd,
+		onPreset: (name) => { for (const finger of fingers) ikSolve("finger", finger.id, { curl: FINGER_PRESETS[name][finger.name] }); ikDragEnd(); },
+	};
+	return { resetPose, fingerPanel };
+}

package/src/shell/preference-pages.jsx

@@ -1,4 +1,3 @@
-import { getAnalyticsOptOut, setAnalyticsOptOut } from "../analytics.js";
 import { loadAutoColor, saveAutoColor } from "../auto-color.js";
 import { readStoredGridView, writeStoredGridView } from "../grid-view.js";
 import { ko } from "../locale.js";
@@ -13,7 +12,7 @@ import {
 } from "./preference-controls.jsx";
 
 export function preferenceSection(section, props) {
-	const { autoColor, setAutoColor, analyticsOptOut, setAnalyticsOptOutState, gridView, setGridView } = props;
+	const { autoColor, setAutoColor, gridView, setGridView } = props;
 
 	switch (section) {
 		case "Appearance":
@@ -31,14 +30,6 @@ export function preferenceSection(section, props) {
 						<PreferenceRow title={ko("Auto colour", "자동 색")} description={ko("Give scene objects stable display colours.", "씬 오브젝트에 고정된 표시 색을 사용해요.")}>
 							<ToggleControl pressed={autoColor} onChange={(value) => { setAutoColor(value); saveAutoColor(value); }} label={ko("Auto colour", "자동 색")} testid="preferences-auto-color" />
 						</PreferenceRow>
-						<PreferenceRow title={ko("Anonymous analytics", "익명 사용 통계")} description={ko("Help improve CozyClay with anonymous product events.", "익명 제품 이벤트로 CozyClay 개선을 도와요.")}>
-							<ToggleControl
-								pressed={!analyticsOptOut}
-								onChange={async (value) => setAnalyticsOptOutState(await setAnalyticsOptOut(!value))}
-								label={ko("Anonymous analytics", "익명 사용 통계")}
-								testid="settings-analytics"
-							/>
-						</PreferenceRow>
 					</PreferenceSection>
 				</>
 			);
@@ -69,4 +60,4 @@ export function preferenceSection(section, props) {
 }
 
 // Kept here so the dialog can load a new setting's initial value lazily.
-export { getAnalyticsOptOut, loadAutoColor, readStoredGridView };
+export { loadAutoColor, readStoredGridView };

package/src/shell/storyboard-caption.js

@@ -0,0 +1,21 @@
+// The storyboard contact sheet is drawn on a bare 2d canvas, which has no
+// stylesheet to inherit from: it gets the studio's own type stack explicitly
+// so the sheet reads like the app it came out of.
+export const STORYBOARD_FONT = '12px Inter, "Pretendard", "Noto Sans KR", system-ui, -apple-system, "Segoe UI", Helvetica, Arial, sans-serif';
+// One unwrapped caption line at 12px inside a 480px cell holds about 64
+// characters before it runs into the next column.
+const STORYBOARD_CAPTION_CHARS = 64;
+
+/** Cut a caption to what one unwrapped cell line holds. */
+export function storyboardLine(text) {
+	return text.length > STORYBOARD_CAPTION_CHARS ? `${text.slice(0, STORYBOARD_CAPTION_CHARS - 1)}\u2026` : text;
+}
+
+/** Fold a labelled shot prompt into the one line a board cell can hold. */
+export function storyboardCaption(prompt) {
+	return storyboardLine(prompt
+		.split("\n")
+		.filter((line) => line.startsWith("SHOT:") || line.startsWith("LENS:"))
+		.map((line) => line.slice(line.indexOf(":") + 1).trim())
+		.join(" · "));
+}

package/src/shell/studio-shell-context.js

@@ -13,6 +13,7 @@ import { playbackFrame, usePlaybackSnapshot } from "../motion/playback-frame-sto
 // - agentOpen/toggleAgent, preferencesOpen/setPreferencesOpen;
 // - statusText/setStatusText, previewRanges/setPreviewRanges, liveHubStatus,
 //   flySpeed (the navigation multiplier, not metres per second);
+// - castStyle ("rig" | "capsule" | "hybrid"), which orders Add > Character;
 // - previsMode ("storyboard" | "animation"), sceneRevision (bumps on every
 //   authored edit) and capturePanelThumbnail(shot) (the shot's first frame as
 //   a PNG data URL, or null) for the Board dock tab.

package/src/shortcut-friction.js

@@ -6,6 +6,7 @@
 import { track } from "./analytics.js";
 import { admit, bump } from "./analytics-friction.js";
 import { isImeComposing } from "./ime.js";
+import { hintNoSelection } from "./friction-hint.js";
 
 const IGNORED_PER_CLASS = 5, UNBOUND_PER_COMBO = 3, HELP_PER_SESSION = 3;
 let send = track, defer = (run) => setTimeout(run, 0), listening = false;
@@ -52,7 +53,7 @@ export function noteUnselectedKey(event) {
 		: event.code === "KeyD" && mod && !event.altKey && !event.shiftKey ? "duplicate"
 			: (event.key === "Delete" || event.key === "Backspace") && !mod ? "delete" : null;
 	if (!keyClass) return;
-	defer(() => { if (!event.defaultPrevented) noteShortcutIgnored(keyClass, "no_selection"); });
+	defer(() => { if (!event.defaultPrevented) { noteShortcutIgnored(keyClass, "no_selection"); hintNoSelection(); } });
 }
 
 const modOnly = (event) => (event.ctrlKey || event.metaKey) && !event.altKey && !event.shiftKey;

package/src/site/landing-analytics.js

@@ -0,0 +1,28 @@
+// Landing page (index.html) analytics: one $pageview and landing:cta_clicked.
+// Same hosted consent rules as /app/ (no cookies, DNT respected, no autocapture);
+// the lite init skips session, error, long-task and device signals.
+import { initAnalytics, track } from "../analytics.js";
+import { LANDING_CTA_TARGETS } from "../analytics-strict.js";
+
+const COPY_TARGETS = [["--via site", "copy_npx"], ["git clone", "copy_clone"], ["mcpServers", "copy_mcp"], ["cclay live", "copy_terminal"]];
+
+/** The landing:cta_clicked target for a clicked element, or null when it is not a call to action. */
+function ctaTarget(element) {
+	const copy = element.closest?.("button.copy[data-copy]");
+	if (copy) return COPY_TARGETS.find(([needle]) => copy.dataset.copy.includes(needle))?.[1] ?? null;
+	const href = element.closest?.("a[href]")?.getAttribute("href") ?? "";
+	if (href === "/app/" || href.startsWith("/app/?")) return "app";
+	if (href.includes("INSTALL_FOR_AGENTS")) return "agent_install_doc";
+	if (href.startsWith("https://github.com/NomaDamas/CozyClay")) return "github";
+	if (href.startsWith("https://discord.gg/")) return "discord";
+	if (href.startsWith("https://www.npmjs.com/package/cozyclay")) return "npm";
+	return null;
+}
+
+if (typeof document !== "undefined") {
+	void initAnalytics({ lite: true });
+	document.addEventListener("click", (event) => {
+		const target = event.target instanceof Element ? ctaTarget(event.target) : null;
+		if (target && LANDING_CTA_TARGETS.includes(target)) track("landing:cta_clicked", { target });
+	}, { capture: true });
+}

package/src/studio-actions.js

@@ -41,7 +41,8 @@ const waypointFrame = { ...frame, minimum: 1 };
 /** The tracks an IK key stores (src/motion/ik.js IK_TRACKS and FK_TRACKS). A
  * chain track keys its three bones (upper, lower, end); a joint track one. */
 export const STUDIO_IK_CHAIN_TRACKS = freezeStudioData(["leftHand", "rightHand", "leftFoot", "rightFoot"]);
-export const STUDIO_IK_JOINT_TRACKS = freezeStudioData(["hips", "spine", "chest", "neck", "head", "leftShoulder", "rightShoulder"]);
+export const STUDIO_IK_JOINT_TRACKS = freezeStudioData(["hips", "spine", "chest", "neck", "head", "leftShoulder", "rightShoulder",
+	...["left", "right"].flatMap(side => ["Thumb", "Index", "Middle", "Ring", "Pinky"].flatMap(finger => [1, 2, 3].map(joint => `${side}${finger}${joint}`)))]);
 const num = { type: "number" };
 const perBone = items => ({ type: "array", items, minItems: 1, maxItems: 3 });
 const quaternion = input({ x: num, y: num, z: num, w: num });
@@ -102,7 +103,7 @@ export const STUDIO_ACTIONS = freezeStudioData([
 	{ id: "character.clearWaypoints", label: "Clear root path", kind: "mutation", undoDomain: "cast", input: input(characterId),
 		description: "Remove every root waypoint of the character, leaving its motion unconstrained by a path." },
 	{ id: "character.setIkKey", label: "Set IK key", kind: "mutation", undoDomain: "motion", input: input({ ...characterId, frame, tracks: ikTracks }),
-		description: "Key a character's IK correction layer at frame, the same key a pose drag bakes. tracks maps a track id to its key: q is the bones' LOCAL rotations as unit quaternions {x,y,z,w}, three for a chain track (leftHand, rightHand, leftFoot, rightFoot: upper, lower and end bone) and one for a joint track (hips, spine, chest, neck, head, leftShoulder, rightShoulder); p is a joint's local position {x,y,z} (the hips' height and lean). Optional baseQ/basePos give the take's own pose the key was made over, so it applies as a delta on the take; chainP gives a chain's three local bone positions; keepTranslations keeps them over the take's; blend (frames, 1-240) is how far this key's correction eases into the take around it, 6 when omitted; pin (1-64 characters) tags the key as baked by that range pin. A key needs q or p. Each named track replaces its key at frame and starts evaluating; other tracks at that frame stay. Keyed frames are in inspect_studio { scope: \"motion\" } ikKeyFrames." },
+		description: "Key a character's IK correction layer at frame, the same key a pose drag bakes. tracks maps a track id to its key: q is the bones' LOCAL rotations as unit quaternions {x,y,z,w}, three for a chain track (leftHand, rightHand, leftFoot, rightFoot: upper, lower and end bone) and one for a joint track (hips, spine, chest, neck, head, leftShoulder, rightShoulder, and the finger bones <side><Thumb|Index|Middle|Ring|Pinky><1-3>, e.g. leftIndex2); p is a joint's local position {x,y,z} (the hips' height and lean). Optional baseQ/basePos give the take's own pose the key was made over, so it applies as a delta on the take; chainP gives a chain's three local bone positions; keepTranslations keeps them over the take's; blend (frames, 1-240) is how far this key's correction eases into the take around it, 6 when omitted; pin (1-64 characters) tags the key as baked by that range pin. A key needs q or p. Each named track replaces its key at frame and starts evaluating; other tracks at that frame stay. Keyed frames are in inspect_studio { scope: \"motion\" } ikKeyFrames." },
 	{ id: "character.removeIkKey", label: "Delete IK key", kind: "mutation", undoDomain: "motion", input: input({ ...characterId, frame }),
 		description: "Delete the character's whole IK key at frame (every track keyed there), like the Full-Body lane's delete." },
 	{ id: "character.clearIkKeys", label: "Clear IK keys", kind: "mutation", undoDomain: "motion", input: input(characterId),

package/src/studio-agent-protocol.js

@@ -4,9 +4,9 @@ import { STUDIO_ERROR_CODES, refusalCode } from "./studio-error-codes.js";
 import { EFFECT_VALUE_SCHEMA } from "./effects/effect-record.js";
 import { TEXT_VALUE_SCHEMA } from "./text/text-record.js";
 import { wrongType, unknownField, missingField, arrayRefusal, duplicateItem, stringRefusal, enumRefusal, numberRefusal, unionRefusal } from "./studio-schema-errors.js";
-// Mirrors PREVIS_MODES (project.js) and POSTURES (scenes.js). Neither is imported:
-// both pull in three.js, which the agent sidecar must not load. The protocol test pins the lists to their owners.
-const PREVIS_MODES = ["storyboard", "animation"], POSTURES = ["stand", "sit", "lie"];
+// Mirrors PREVIS_MODES and CAST_STYLES (project.js) and POSTURES (scenes.js). Neither is imported:
+// both pull in three.js, which the agent sidecar must not load. The protocol tests pin the lists to their owners.
+const PREVIS_MODES = ["storyboard", "animation"], CAST_STYLES = ["rig", "capsule", "hybrid"], POSTURES = ["stand", "sit", "lie"];
 
 // Sized for the compact index of up to 400 entities (~100 bytes each) beside
 // 24 detailed rows; a small scene stays far below it.
@@ -232,7 +232,7 @@ const jobSummary = object({ id, characterId: id, state: choices(STUDIO_VARIANTS.
 const contextSchema = object({
 	schema: literal("studio-context-v1"), host, revision,
 	units: object({ distance: literal("m"), angle: literal("deg"), up: literal("+Y"), yawZero: literal("+Z"), yawPositiveToward: literal("+X"), pivot: literal("base"), fps: literal(24), rangeEnd: literal("exclusive") }),
-	scene: object({ name, aspect: text(40), floorY: number(), frameCount: integer(), objectCount: integer(), characterCount: integer() }, { previsMode: choices(PREVIS_MODES) }),
+	scene: object({ name, aspect: text(40), floorY: number(), frameCount: integer(), objectCount: integer(), characterCount: integer() }, { previsMode: choices(PREVIS_MODES), castStyle: choices(CAST_STYLES) }),
 	selection, activeCharacterId: nullable(id), view, shot: nullable(currentShot), camera: nullable(camera),
 	entities: array(entity, 24), entityPage: object({ returned: integer(0, 24), total: integer(), truncated: bool, nextCursor: nullable(text(512)) }),
 	shots: array(shotSummary, 8), shotsTruncated: bool, assets: array(assetSummary, STUDIO_CONTEXT_LIMITS.assets),

package/src/studio-app-binding.js

@@ -137,13 +137,14 @@ export function createStudioAppBinding(ports) {
 	const frameRange = row => ({ startFrame: row.startFrame, endFrameExclusive: row.endFrame + 1 });
 	function context() {
 		const s = refresh(), entities = entityProjection(s), registry = ports.actions?.();
-		const shot = s.shots.find(row => row.id === s.selectedShotId) ?? shotAtFrame(s.shots, s.view.frame);
+		const shot = s.shots.find(row => row.id === s.selectedShotId) ?? shotAtFrame(s.shots, s.view.frame), cast = id => s.characters.some(c => c.id === id);
 		const range = frameRange;
 		return buildStudioContext({ schema: "studio-context-v1", host: { surface: "studio", ...s.host, workspaceHandle: s.workspaceHandle },
 			revision: { scene: s.revision, physics: s.physicsRevision, view: s.viewRevision },
 			units: { distance: "m", angle: "deg", up: "+Y", yawZero: "+Z", yawPositiveToward: "+X", pivot: "base", fps: 24, rangeEnd: "exclusive" },
-			scene: { name: s.sceneName, aspect: s.aspect, floorY: 0, frameCount: s.frameCount, objectCount: s.objects.length, characterCount: s.characters.length, ...(s.previsMode ? { previsMode: s.previsMode } : {}) },
-			selection: s.selection, activeCharacterId: s.activeCharacterId, view: s.view,
+			scene: { name: s.sceneName, aspect: s.aspect, floorY: 0, frameCount: s.frameCount, objectCount: s.objects.length, characterCount: s.characters.length, ...(s.previsMode ? { previsMode: s.previsMode } : {}), ...(s.castStyle ? { castStyle: s.castStyle } : {}) },
+			// A removed character (the last one, too) is neither selected nor active.
+			selection: ["character", "rig"].includes(s.selection?.kind) && !cast(s.selection.id) ? null : s.selection, activeCharacterId: cast(s.activeCharacterId) ? s.activeCharacterId : null, view: s.view,
 			shot: shot ? { id: shot.id, name: shot.name, range: range(shot), mode: shot.camera?.mode ?? "keys" } : null, camera: s.camera,
 			// buildStudioContext selects the detailed rows and writes the real page.
 			entities, entityPage: { returned: 0, total: 0, truncated: false, nextCursor: null },

package/src/update/UpdateChip.jsx

@@ -1,7 +1,8 @@
 import { useCallback, useEffect, useRef, useState } from "react";
 import { ko } from "../locale.js";
-import { createUpdatePoller } from "./update-client.js";
-import { noteNoticeShown, noteUpdateClicked, noteUpdatePolled } from "./update-telemetry.js";
+import { useStudioShell } from "../shell/studio-shell-context.js";
+import { createUpdatePoller, reloadAfterRestart } from "./update-client.js";
+import { noteNoticeShown, noteUpdateClicked, noteUpdatePolled, noteUpdateRestarted } from "./update-telemetry.js";
 import UpdateDialog from "./UpdateDialog.jsx";
 import "./update.css";
 
@@ -13,6 +14,9 @@ function chipLabel(state) {
 	switch (state.view) {
 		case "updating": return ko("Updating…", "업데이트 중…", "正在更新…");
 		case "restart_needed": return ko("Restart to finish", "다시 시작하면 끝나요", "重启以完成");
+		case "restarting": return ko("Restarting…", "다시 시작하는 중…", "正在重启…");
+		case "restarted": return ko(`Updated to ${v}`, `${v}로 업데이트됨`, `已更新到 ${v}`);
+		case "restart_timeout": return ko("Restart didn't finish", "다시 시작하지 못했어요", "重启未完成");
 		case "failed": return ko("Update failed", "업데이트 실패", "更新失败");
 		default: return ko(`Update ${v}`, `${v} 업데이트`, `更新到 ${v}`);
 	}
@@ -22,10 +26,20 @@ export default function UpdateChip() {
 	const [state, setState] = useState(null);
 	const [open, setOpen] = useState(false);
 	const poller = useRef(null);
+	const { projectDirty } = useStudioShell() ?? {};
+	const dirty = useRef(projectDirty);
+	useEffect(() => { dirty.current = projectDirty; }, [projectDirty]);
 	useEffect(() => {
+		let reloaded = false;
 		const instance = createUpdatePoller({
 			onState: ({ state: next, info }) => {
 				setState(next);
+				// Decided once, when the new launcher answers: a saved project reloads, a dirty one asks first.
+				if (next.view === "restarted" && !reloaded) {
+					reloaded = true;
+					// A task later, so this tab's update:restarted is handed over first.
+					if (!reloadAfterRestart({ dirty: dirty.current, reload: () => setTimeout(() => window.location.reload(), 0) })) setOpen(true);
+				}
 				noteNoticeShown(next);
 				noteUpdatePolled(info);
 			},
@@ -45,6 +59,10 @@ export default function UpdateChip() {
 		if (state) noteUpdateClicked("update_now", state.kind);
 		void poller.current?.update();
 	}, [state]);
+	const restart = useCallback(() => {
+		if (state) noteUpdateClicked("restart", state.kind);
+		void poller.current?.restart().then((outcome) => { if (outcome) noteUpdateRestarted(outcome); });
+	}, [state]);
 	if (view === "hidden") return null;
 	return (
 		<span className="update-chip-wrap">
@@ -78,6 +96,7 @@ export default function UpdateChip() {
 					onClose={close}
 					onLater={() => dismiss("later")}
 					onUpdate={update}
+					onRestart={restart}
 					onAction={(action) => noteUpdateClicked(action, state.kind)}
 				/>
 			)}

package/src/update/UpdateDialog.jsx

@@ -22,6 +22,9 @@ function titleOf(state) {
 	if (state.view === "updating") return ko("Updating…", "업데이트 중…", "正在更新…");
 	if (state.view === "restart_needed") return ko("Restart to finish", "다시 시작하면 끝나요", "重启以完成");
 	if (state.view === "failed") return ko("Update failed", "업데이트 실패", "更新失败");
+	if (state.view === "restarting") return ko("Restarting…", "다시 시작하는 중…", "正在重启…");
+	if (state.view === "restarted") return ko(`Updated to ${v}`, `${v}로 업데이트됨`, `已更新到 ${v}`);
+	if (state.view === "restart_timeout") return ko("Restart didn't finish", "다시 시작하지 못했어요", "重启未完成");
 	return ko(`CozyClay ${v} is available`, `CozyClay ${v} 버전이 나왔어요`, `CozyClay ${v} 已发布`);
 }
 
@@ -29,11 +32,18 @@ function bodyOf(state) {
 	const v = state.latest;
 	if (state.view === "updating") return ko(`Installing ${v}. This takes about a minute.`, `${v} 설치 중이에요. 1분쯤 걸려요.`, `正在安装 ${v}，大约需要一分钟。`);
 	if (state.view === "restart_needed") {
-		return ko(`Updated to ${v}. Quit CozyClay in the terminal (Ctrl+C), then run \`cclay\` again.`,
-			`${v} 설치 완료. 터미널에서 CozyClay를 종료(Ctrl+C)하고 \`cclay\`를 다시 실행하세요.`,
-			`已更新到 ${v}。请在终端中退出 CozyClay（Ctrl+C），然后重新运行 \`cclay\`。`);
+		return ko(`Updated to ${v}. Restart now, or quit CozyClay in the terminal (Ctrl+C) and run \`cclay\` again.`,
+			`${v} 설치 완료. 지금 다시 시작하거나, 터미널에서 CozyClay를 종료(Ctrl+C)하고 \`cclay\`를 다시 실행하세요.`,
+			`已更新到 ${v}。请立即重启，或在终端中退出 CozyClay（Ctrl+C）后重新运行 \`cclay\`。`);
 	}
 	if (state.view === "failed") return (failureCopy[state.errorClass] ?? failureCopy.other)();
+	if (state.view === "restarting") return ko(`Starting ${v}. The Studio reloads when it answers.`, `${v}를 시작하는 중이에요. 응답하면 Studio가 다시 로드돼요.`, `正在启动 ${v}。它响应后 Studio 会重新加载。`);
+	if (state.view === "restarted") return ko("Updated. Save your project, then reload.", "업데이트됐어요. 프로젝트를 저장한 뒤 다시 로드하세요.", "已更新。请先保存项目，然后重新加载。");
+	if (state.view === "restart_timeout") {
+		return ko("CozyClay didn't come back within 30 seconds. Quit it in the terminal (Ctrl+C), then run `cclay` again.",
+			"CozyClay가 30초 안에 돌아오지 않았어요. 터미널에서 종료(Ctrl+C)하고 `cclay`를 다시 실행하세요.",
+			"CozyClay 未在 30 秒内恢复。请在终端中退出（Ctrl+C），然后重新运行 `cclay`。");
+	}
 	if (state.kind === "npx") {
 		return ko("Quit CozyClay in the terminal and run `npx cozyclay` again. npx fetches the newest version each time (internet needed).",
 			"터미널에서 CozyClay를 종료하고 `npx cozyclay`를 다시 실행하세요. npx가 매번 최신 버전을 받아요 (인터넷 필요).",
@@ -65,7 +75,7 @@ async function copyText(text) {
 	}
 }
 
-export default function UpdateDialog({ state, onClose, onLater, onUpdate, onAction }) {
+export default function UpdateDialog({ state, onClose, onLater, onUpdate, onRestart, onAction }) {
 	const closeRef = useRef(null);
 	const titleId = useId();
 	// "Copied" belongs to the view it was pressed in: a later phase shows its own command afresh.
@@ -89,7 +99,7 @@ export default function UpdateDialog({ state, onClose, onLater, onUpdate, onActi
 		const view = state.view;
 		setCopiedView((await copyText(state.command)) ? view : null);
 	};
-	const startsInstall = state.actions.includes("update_now") || state.actions.includes("retry");
+	const startsInstall = ["update_now", "retry", "restart"].some((action) => state.actions.includes(action));
 	const body = bodyOf(state);
 	return createPortal(
 		<div className="menubar-dialog-backdrop" onPointerDown={(event) => { if (event.target === event.currentTarget) onClose(); }}>
@@ -127,6 +137,16 @@ export default function UpdateDialog({ state, onClose, onLater, onUpdate, onActi
 								{ko("Try again", "다시 시도", "重试")}
 							</button>
 						)}
+						{state.actions.includes("restart") && (
+							<button type="button" className="update-dialog-primary" data-testid="update-restart" disabled={blocked} onClick={onRestart}>
+								{ko("Restart now", "지금 다시 시작", "立即重启")}
+							</button>
+						)}
+						{state.actions.includes("reload") && (
+							<button type="button" className="update-dialog-primary" data-testid="update-reload" onClick={() => window.location.reload()}>
+								{ko("Reload", "다시 로드", "重新加载")}
+							</button>
+						)}
 						{state.actions.includes("copy_command") && (
 							<button type="button" data-testid="update-copy" data-copied={copied || undefined} onClick={() => void copy()}>
 								{copied ? ko("Copied", "복사했어요", "已复制") : ko("Copy command", "명령 복사", "复制命令")}
@@ -135,7 +155,7 @@ export default function UpdateDialog({ state, onClose, onLater, onUpdate, onActi
 						{state.actions.includes("later") && (
 							<button type="button" data-testid="update-later" onClick={onLater}>{ko("Later", "나중에", "稍后")}</button>
 						)}
-						{state.view === "restart_needed" && (
+						{["restart_needed", "restart_timeout"].includes(state.view) && (
 							<button type="button" onClick={onClose}>{ko("Close", "닫기", "关闭")}</button>
 						)}
 					</div>