@ait-co/devtools 0.1.129 → 0.1.132

package/dist/mcp/cli.js

@@ -2024,7 +2024,7 @@ async function readMcpSdkVersion() {
 * some test environments that skip the build step).
 */
 function readDevtoolsVersion() {
-	return "0.1.129";
+	return "0.1.132";
 }
 /**
 * Derives the next recommended action from a completed diagnostics snapshot.
@@ -2864,32 +2864,50 @@ async function renderAndMaybeWait(deps, prep, waitForAttach, callTimeoutMs, conn
 	}, null, 2)}\n\n${qr}`);
 }
 /**
-* Builds a self-contained IIFE DOM expression that renders a dismissible
-* "Debugger Connected" badge on the bottom-left of the phone screen.
+* Builds a self-contained IIFE DOM expression that renders a LIVE
+* "Debugger Connected" / "Debugger Disconnected" badge on the bottom-left of
+* the phone screen (#730).
 *
 * **Pure function** — returns a JS expression string; does NOT inject it.
 * Injection is performed by {@link injectDebugIndicator} in `cell.ts`.
 *
 * The expression, when evaluated on the page, does the following:
-*   1. Early-returns if `#__ait_debug_indicator` already exists (idempotent —
-*      prevents duplicate badges on re-injection after page reload).
-*   2. Appends a fixed-position `<div id="__ait_debug_indicator">` at the
-*      bottom-left, accounting for safe-area insets.
-*   3. Attaches a `{ once: true }` `pointerdown` listener that removes the
-*      badge on first touch — one-tap dismiss.
+*   1. Idempotent controller — a single `window.__ait_indicator` controller
+*      object is created once (keyed on its presence, not on the DOM node).
+*      Re-injection (e.g. explicit disconnect notice from `close()`) UPDATES
+*      the existing badge's state/label in place — it never duplicates the
+*      `<div>` or stacks a second observer.
+*   2. Renders a fixed-position `<div id="__ait_debug_indicator">` at the
+*      bottom-left, accounting for safe-area insets. Background/text flip
+*      between the attached (red) and disconnected (grey) visuals.
+*   3. A `pointerdown` listener dismisses (hides) the badge on tap — dismiss
+*      is NON-terminal: a later state transition un-dismisses it, so a
+*      genuine disconnect after a dismissed tap is still visible.
+*   4. Observes relay-socket lifecycle WITHOUT opening any new connection:
+*      - Preferred path: if the in-app module (`src/in-app/attach.ts`) has
+*        already installed its relay-WS observer (`window.__ait_relay_ws_observed`),
+*        subscribe to the `ait:relay-ws-state` CustomEvent it broadcasts.
+*      - Fallback path: wrap `window.WebSocket` in a `Proxy` and match dials
+*        by PATHNAME SHAPE only (`/target/`) — never by host/wss value — so a
+*        bare CDP-injected badge (no in-app bundle) still reacts to the
+*        chii target socket's own open/close lifecycle.
 *
 * The expression intentionally contains NO relay URLs, wss addresses, TOTP
-* codes, or any other secrets. It is pure DOM UI text only.
+* codes, or any other secrets. It is pure DOM UI text + enum state only.
 *
 * SECRET-HANDLING: this expression contains no secrets, relay URLs, wss
-* addresses, or TOTP codes whatsoever — DOM label text only.
+* addresses, or TOTP codes whatsoever — DOM label text + a structural
+* pathname match (`/target/`) only.
 *
-* @param opts.label - Badge text (default: `'Debugger Connected'`).
+* @param opts.label - Attached-state badge text (default: `'Debugger Connected'`).
+* @param opts.disconnectedLabel - Disconnected-state badge text (default: `'Debugger Disconnected'`).
+* @param opts.state - Initial/forced state for THIS injection call (default: `'attached'`).
 * @returns A JS expression string suitable for `Runtime.evaluate`.
 */
 function buildIndicatorExpression(opts) {
 	const label = opts?.label ?? "Debugger Connected";
-	return `(() => {if (document.getElementById('__ait_debug_indicator')) return;const el = document.createElement('div');el.id = '__ait_debug_indicator';el.style.cssText = ['position:fixed','left:max(12px,calc(env(safe-area-inset-left,0px) + 8px))','bottom:max(12px,calc(env(safe-area-inset-bottom,0px) + 8px))','z-index:2147483647','background:#e5484d','color:#fff','font:bold 11px/1 system-ui,sans-serif','padding:5px 9px','border-radius:6px','pointer-events:auto','user-select:none',].join(';');el.textContent = ${JSON.stringify(label)};el.addEventListener('pointerdown', () => el.remove(), { once: true });document.body.appendChild(el);})()`;
+	const disconnectedLabel = opts?.disconnectedLabel ?? "Debugger Disconnected";
+	return `(() => {var W = window;function render(c) {if (c.dismissed) { c.el.style.display = 'none'; return; }c.el.style.display = 'block';var up = c.state !== 'disconnected';c.el.style.background = up ? '#e5484d' : '#8a8f98';c.el.textContent = up ? ${JSON.stringify(label)} : ${JSON.stringify(disconnectedLabel)};}function setState(c, next) { c.state = next; c.dismissed = false; render(c); }var c = W.__ait_indicator;if (!c) {var el = document.createElement('div');el.id = '__ait_debug_indicator';el.style.cssText = ['position:fixed','left:max(12px,calc(env(safe-area-inset-left,0px) + 8px))','bottom:max(12px,calc(env(safe-area-inset-bottom,0px) + 8px))','z-index:2147483647','color:#fff','font:bold 11px/1 system-ui,sans-serif','padding:5px 9px','border-radius:6px','pointer-events:auto','user-select:none',].join(';');document.body.appendChild(el);c = { el: el, state: 'attached', dismissed: false };el.addEventListener('pointerdown', function () { c.dismissed = true; render(c); }, { passive: true });W.__ait_indicator = c;if (W.__ait_relay_ws_observed) {W.addEventListener('ait:relay-ws-state', function (e) {setState(c, e.detail && e.detail.state === 'open' ? 'attached' : 'disconnected');});} else {try {var Native = W.WebSocket;W.WebSocket = new Proxy(Native, {construct: function (t, a) {var ws = Reflect.construct(t, a);try {var u = new URL(String(a[0]), location.href);if (/\\/target\\//.test(u.pathname)) {ws.addEventListener('open', function () { setState(c, 'attached'); });ws.addEventListener('close', function () { setState(c, 'disconnected'); });ws.addEventListener('error', function () { setState(c, 'disconnected'); });}} catch (_) {}return ws;},});} catch (_) {}}}setState(c, ${JSON.stringify(opts?.state ?? "attached")});})()`;
 }
 //#endregion
 //#region src/test-runner/cell.ts
@@ -2935,12 +2953,16 @@ async function injectGlobals(conn, globals) {
 	}
 }
 /**
-* Injects the "Debugger Connected" on-phone indicator via `Runtime.evaluate`.
+* Injects (or updates) the "Debugger Connected"/"Debugger Disconnected"
+* on-phone indicator via `Runtime.evaluate` (#730).
 *
 * Uses the same CDP mechanism as {@link injectGlobals} — a single
 * `Runtime.evaluate` round-trip with the expression built by
-* {@link buildIndicatorExpression}. The indicator is a dismissible red badge
-* rendered at the bottom-left of the page (position:fixed, safe-area-aware).
+* {@link buildIndicatorExpression}. The indicator is a LIVE badge rendered at
+* the bottom-left of the page (position:fixed, safe-area-aware): the badge's
+* controller is idempotent, so calling this again (e.g. right before
+* `close()` with `{ state: 'disconnected' }`) UPDATES the existing badge in
+* place instead of injecting a duplicate.
 *
 * **Isolation**: unlike {@link injectGlobals}, this function NEVER throws to
 * its caller. Injection failure (e.g. page detached during inject, CSS not
@@ -2950,12 +2972,12 @@ async function injectGlobals(conn, globals) {
 * `src/in-app/attach.ts`.
 *
 * Call this ONLY on the manual debug paths (start_attach MCP, devtools-test
-* CLI). Do NOT call on the `run_tests` auto-attach path — the red badge
+* CLI). Do NOT call on the `run_tests` auto-attach path — the badge
 * would contaminate screenshots, measure_safe_area probes, and DOM snapshots
 * taken during automated measurement runs.
 *
 * SECRET-HANDLING: the injected expression contains no secrets, relay URLs,
-* wss addresses, or TOTP codes — it is pure DOM UI text built by
+* wss addresses, or TOTP codes — it is pure DOM UI text + enum state built by
 * {@link buildIndicatorExpression}.
 *
 * @param conn - The live CDP connection (relay-attached page).
@@ -2985,6 +3007,23 @@ async function injectDebugIndicator(conn, opts) {
 * safe to import from the MCP daemon graph.
 */
 /**
+* Filename suffix that opts a test file into manual-variant scheduling
+* (devtools#741). A file named `<name>.manual.ait.test.ts` is EXCLUDED from
+* `discoverTestFiles`'s default output (so existing unattended runs are
+* unaffected — the zero-diff-when-off constraint) and is only surfaced when
+* the caller explicitly asks for manual files via {@link partitionManualTests}
+* (wired from the CLI's `--manual-blocking` flag).
+*
+* This is the entire tagging contract for v1 — no separate manifest/config,
+* just a filename convention. Documented here + in the CLI `--help` text
+* (cli.ts USAGE) and the test-runner README.
+*/
+const MANUAL_TEST_SUFFIX = ".manual.ait.test.ts";
+/** True when `file`'s basename ends with {@link MANUAL_TEST_SUFFIX}. */
+function isManualTestFile(file) {
+	return basename(file).endsWith(MANUAL_TEST_SUFFIX);
+}
+/**
 * Expands `patterns` (globs or plain paths) into a sorted, de-duplicated list of
 * ABSOLUTE test file paths, resolved relative to `cwd`.
 *
@@ -2993,14 +3032,26 @@ async function injectDebugIndicator(conn, opts) {
 * resolved against `cwd`. `bundleTestFile` requires an absolute path, so the
 * absolute output feeds it directly.
 *
+* By default, files matching {@link MANUAL_TEST_SUFFIX} are EXCLUDED from the
+* result (devtools#741) — blocking-UI tests opt in via that filename
+* convention and must never appear in an unattended run unless the caller
+* explicitly asks for them via `includeManual: true`. This keeps the
+* default (flag-off) discovery path byte-for-byte identical to before this
+* option existed.
+*
 * @param patterns Glob patterns or file paths (e.g. `['src/**\/*.ait.test.ts']`).
 * @param cwd      Base directory for relative patterns/results.
+* @param opts     `{ includeManual }` — when true, manual-tagged files are kept
+*                 in the (still-sorted) output instead of being filtered out.
+*                 Use {@link partitionManualTests} to separate + reorder them.
 * @returns Sorted, de-duplicated absolute file paths. Empty when nothing matches.
 */
-async function discoverTestFiles(patterns, cwd) {
+async function discoverTestFiles(patterns, cwd, opts) {
 	const out = /* @__PURE__ */ new Set();
 	for await (const match of glob(patterns, { cwd })) out.add(isAbsolute(match) ? match : resolve(cwd, match));
-	return [...out].sort();
+	const sorted = [...out].sort();
+	if (opts?.includeManual) return sorted;
+	return sorted.filter((f) => !isManualTestFile(f));
 }
 //#endregion
 //#region src/shared/relay-auth-close.ts
@@ -3235,7 +3286,11 @@ var ChiiCdpConnection = class {
 	* EventEmitter is missed (defensive belt-and-suspenders).
 	*
 	* @param filterFn  - Predicate that the returned targets must satisfy.
-	* @param timeoutMs - Reject after this many ms (default 90 000).
+	* @param timeoutMs - Reject after this many ms (default 90 000). Pass a
+	*   non-finite value (`Infinity`) to disable the rejection timer entirely —
+	*   used by the test-runner's unbounded QR-attach wait (devtools#735). Node
+	*   clamps `setTimeout(fn, Infinity)` to ~1ms, so a non-finite value MUST
+	*   skip arming the timer rather than pass it through.
 	* @param pollIntervalMs - Fallback poll interval (default 500ms).
 	*/
 	waitForFirstTarget(filterFn, timeoutMs = 9e4, pollIntervalMs = 500) {
@@ -3247,7 +3302,7 @@ var ChiiCdpConnection = class {
 			const settle = (targets) => {
 				if (settled) return;
 				settled = true;
-				clearTimeout(timeoutHandle);
+				if (timeoutHandle !== null) clearTimeout(timeoutHandle);
 				if (pollHandle !== null) {
 					clearInterval(pollHandle);
 					pollHandle = null;
@@ -3258,7 +3313,7 @@ var ChiiCdpConnection = class {
 			const onAttach = (targets) => {
 				if (filterFn(targets)) settle(targets);
 			};
-			const timeoutHandle = setTimeout(() => {
+			const timeoutHandle = Number.isFinite(timeoutMs) ? setTimeout(() => {
 				if (settled) return;
 				settled = true;
 				if (pollHandle !== null) {
@@ -3267,7 +3322,7 @@ var ChiiCdpConnection = class {
 				}
 				this.emitter.off("target:attached", onAttach);
 				reject(/* @__PURE__ */ new Error(`waitForFirstTarget: 타임아웃 (${timeoutMs}ms) — 폰이 relay에 attach되지 않았습니다.`));
-			}, timeoutMs);
+			}, timeoutMs) : null;
 			this.emitter.on("target:attached", onAttach);
 			pollHandle = setInterval(() => {
 				this.refreshTargets().then((targets) => {
@@ -4043,6 +4098,13 @@ async function injectAndRunBundle(connection, bundleCode, timeoutMs = DEFAULT_TI
 //#endregion
 //#region src/test-runner/relay-worker.ts
 /**
+* Per-file evaluate timeout (ms) for manual-variant files (devtools#741) — a
+* human is expected to be tapping through a native sheet, so the timeout must
+* be far longer than the unattended default (60s, rpc.ts DEFAULT_TIMEOUT_MS).
+* Fixed constant (not configurable in v1) — documented here + CLI `--help`.
+*/
+const MANUAL_FILE_TIMEOUT_MS = 5 * 6e4;
+/**
 * Sentinel string embedded in the error message by `injectAndRunBundle` when
 * the per-file evaluate race hits the timeout. Used by the retry guard so only
 * genuine timeouts get a second attempt — not bundle errors or parse failures.
@@ -4113,12 +4175,21 @@ async function runTestFilesOverRelay(connection, files, opts) {
 			process.stderr.write(`relay-worker: reconnect failed (${e instanceof Error ? e.message : String(e)}) — continuing, remaining files may fail\n`);
 		}
 	};
+	const manualFiles = opts?.manualFiles;
+	const manualTotal = manualFiles?.size ?? 0;
+	let manualIndex = 0;
 	try {
 		for (const file of files) {
 			if (pendingReconnectCheck) {
 				await attemptReconnect("next-file");
 				pendingReconnectCheck = false;
 			}
+			const isManual = manualFiles?.has(file) === true;
+			if (isManual) {
+				manualIndex += 1;
+				opts?.onManualFile?.(file, manualIndex, manualTotal);
+			}
+			const fileTimeoutMs = isManual ? MANUAL_FILE_TIMEOUT_MS : opts?.timeoutMs;
 			let fileEntry;
 			try {
 				const { code } = await bundleTestFile(file, opts?.bundleOptions);
@@ -4144,7 +4215,7 @@ async function runTestFilesOverRelay(connection, files, opts) {
 				const attempt = async () => {
 					let rpcResult;
 					try {
-						rpcResult = await injectAndRunBundle(connection, code, opts?.timeoutMs);
+						rpcResult = await injectAndRunBundle(connection, code, fileTimeoutMs);
 					} catch (e) {
 						return {
 							file,
@@ -4180,6 +4251,7 @@ async function runTestFilesOverRelay(connection, files, opts) {
 				};
 			}
 			if ("error" in fileEntry.result && isRelayDisconnectMessage(fileEntry.result.error)) pendingReconnectCheck = true;
+			if (isManual) fileEntry.mode = "manual";
 			fileResults.push(fileEntry);
 		}
 	} finally {
@@ -4252,9 +4324,9 @@ OPTIONS
                           the CLI waits for a human to scan the QR code — use
                           --attach-timeout for that.
   --attach-timeout <ms>   How long to wait for a human to scan the QR code with
-                          their phone (default: 600000 — 10 minutes). Omit to
-                          use the relay factory's generous default. Decrease for
-                          CI environments where a scan should arrive quickly.
+                          their phone. Omit (default) to wait indefinitely — the
+                          runner stays up until you stop it (Ctrl-C/SIGTERM).
+                          Pass a value to bound the wait for CI/headless runs.
   --cell-sdk-line <line>  SDK line to inject as __AIT_CELL__.sdkLine (2.x|3.x)
   --cell-platform <plat>  Platform to inject as __AIT_CELL__.platform
                           (mock|ios|android, default: AIT_CELL_PLATFORM env)
@@ -4267,6 +4339,24 @@ OPTIONS
   --headless              Disable browser auto-open (text QR only)
   --project-root <dir>    Project root for .ait_relay secret lookup
                           (default: current working directory)
+  --manual-blocking       Run manual-tagged test files (*.manual.ait.test.ts)
+                          LAST, after all regular files, with a human present.
+                          Before each manual file, the QR dashboard is pushed
+                          a step-by-step Korean prompt naming the file + its
+                          progress (k/n), and the same line is printed to
+                          stdout. Manual files get a 5-minute per-file evaluate
+                          timeout (vs. --timeout for everything else) since a
+                          human is expected to tap through a native sheet
+                          (photo picker, permission dialog, fullscreen ad).
+                          Without this flag (default off), *.manual.ait.test.ts
+                          files are EXCLUDED from the glob expansion entirely —
+                          existing unattended runs are byte-for-byte unaffected.
+                          With --report-dir, a run that included manual files
+                          ALSO writes <sdkLine>.<platform>.manual.json
+                          alongside (never replacing) the standard report, and
+                          each manual file's report entry is stamped
+                          mode: 'manual' — never diff a manual run against an
+                          unattended baseline as if they were equivalent.
   --help, -h              Show this help message
 
 DESCRIPTION
@@ -5397,6 +5487,11 @@ const en = {
 	"dashboard.watchdog.title": "Server has shut down",
 	"dashboard.watchdog.body": "The MCP server has stopped. This session is no longer active. You may close this tab.",
 	"dashboard.watchdog.close": "Close tab",
+	"dashboard.conn.lost": "Connection lost — reconnecting…",
+	"dashboard.session.completeTitle": "Test run complete",
+	"dashboard.session.completeBody": "The runner exited cleanly. See your terminal for results.",
+	"dashboard.session.shutdownTitle": "Debug server stopped",
+	"dashboard.session.shutdownBody": "The MCP server has shut down; this session is no longer live. You can close this tab.",
 	"attach.title": "AIT Debug Session — QR Scan",
 	"attach.deployment": "deployment: {label}",
 	"attach.steps.section": "How to scan",
@@ -5635,6 +5730,11 @@ const tables = {
 		"dashboard.watchdog.title": "서버가 종료되었습니다",
 		"dashboard.watchdog.body": "MCP server가 종료되어 이 세션이 더 이상 유효하지 않습니다. 이 탭을 닫아도 됩니다.",
 		"dashboard.watchdog.close": "탭 닫기",
+		"dashboard.conn.lost": "연결 끊김 — 재연결 시도 중…",
+		"dashboard.session.completeTitle": "테스트 실행 완료",
+		"dashboard.session.completeBody": "러너가 정상 종료되었습니다. 결과는 터미널에서 확인하세요.",
+		"dashboard.session.shutdownTitle": "디버그 서버가 종료되었습니다",
+		"dashboard.session.shutdownBody": "MCP server가 종료되어 이 세션이 더 이상 유효하지 않습니다. 이 탭을 닫아도 됩니다.",
 		"attach.title": "AIT 디버그 세션 — QR 스캔",
 		"attach.deployment": "deployment: {label}",
 		"attach.steps.section": "스캔 절차",
@@ -6216,7 +6316,12 @@ function buildDashboardHtml(state, qrDataUrl, locale, path = "/", params = new U
 		watchdogTimeoutMs,
 		watchdogTitle: JSON.stringify(s("dashboard.watchdog.title")),
 		watchdogBody: JSON.stringify(s("dashboard.watchdog.body")),
-		watchdogCloseLabel: JSON.stringify(s("dashboard.watchdog.close"))
+		watchdogCloseLabel: JSON.stringify(s("dashboard.watchdog.close")),
+		connectionLost: JSON.stringify(s("dashboard.conn.lost")),
+		completeTitle: JSON.stringify(s("dashboard.session.completeTitle")),
+		completeBody: JSON.stringify(s("dashboard.session.completeBody")),
+		shutdownTitle: JSON.stringify(s("dashboard.session.shutdownTitle")),
+		shutdownBody: JSON.stringify(s("dashboard.session.shutdownBody"))
 	};
 	const langSwitcher = buildLangSwitcher(path, params, locale, s);
 	const filled = dashboardChromeByLocale[locale].replaceAll("__LANG_SWITCHER__", langSwitcher).replaceAll("__NOW__", escapeHtml(now)).replaceAll("__TUNNEL_CLASS__", tunnelClass).replaceAll("__TUNNEL_STATUS__", escapeHtml(tunnelStatus)).replaceAll("__ATTACH_SECTION__", attachSection).replaceAll("__INSPECTOR_SECTION__", inspectorSection).replaceAll("__PAGES_SECTION__", pagesSection);
@@ -6273,6 +6378,14 @@ function buildSseScript(strings) {
       var WATCHDOG_BODY = ${strings.watchdogBody};
       var WATCHDOG_CLOSE_LABEL = ${strings.watchdogCloseLabel};
 
+      // ── 실시간 상태 표면 상수 (#730) ───────────────────────────────────────
+      var CONN_LOST = ${strings.connectionLost};
+      var COMPLETE_TITLE = ${strings.completeTitle};
+      var COMPLETE_BODY = ${strings.completeBody};
+      var SHUTDOWN_TITLE = ${strings.shutdownTitle};
+      var SHUTDOWN_BODY = ${strings.shutdownBody};
+      var disconnectedShown = false;
+
       // ── 클립보드 복사 헬퍼 ────────────────────────────────────────────────
       function copyText(text) {
         if (navigator.clipboard && navigator.clipboard.writeText) {
@@ -6350,6 +6463,36 @@ function buildSseScript(strings) {
         }
       }
 
+      // ── Terminal 상태 배너 (#730) ─────────────────────────────────────────
+      // "완료"/"종료"는 watchdog(최대 210s 지연)을 기다리지 않고 close() 직전에
+      // 서버가 직접 push하는 마지막 SSE 프레임으로 즉시 렌더한다. watchdogFired를
+      // 함께 세워 뒤이은 onerror의 showConnLost가 이 배너를 덮어쓰지 않게 한다.
+      function showTerminalBanner(title, body) {
+        if (watchdogTimer) { clearInterval(watchdogTimer); watchdogTimer = null; }
+        watchdogFired = true; // 이후 watchdog/onerror 발화를 억제
+        if (document.body) {
+          document.body.innerHTML =
+            '<div style="display:flex;flex-direction:column;align-items:center;justify-content:center;' +
+            'height:100vh;font-family:sans-serif;text-align:center;padding:2rem;box-sizing:border-box;">' +
+            '<p style="font-size:1.4rem;font-weight:bold;margin-bottom:1rem;">' + title + '</p>' +
+            '<p style="color:#555;">' + body + '</p></div>';
+        }
+      }
+
+      // ── SSE onerror 즉시 신호 (#730) ──────────────────────────────────────
+      // EventSource는 "재시도 중"과 "서버 종료"를 구분하지 못하므로, onerror에서
+      // 즉시 구분되는 '연결 끊김' 상태를 tunnel-status 배지에 표시한다. 이미
+      // terminal 배너가 뜬 뒤(watchdogFired)라면 덮어쓰지 않는다.
+      function showConnLost() {
+        if (disconnectedShown || watchdogFired) return;
+        disconnectedShown = true;
+        var el = document.getElementById('tunnel-status');
+        if (el) { el.textContent = CONN_LOST; el.className = 'status status-down'; }
+      }
+      function clearConnLost() {
+        disconnectedShown = false;
+      }
+
       function fireWatchdog() {
         if (watchdogFired) return;
         watchdogFired = true;
@@ -6380,7 +6523,7 @@ function buildSseScript(strings) {
       src.onopen = function () {
         // 연결 복구 시 lastSeen 갱신 — 일시적 끊김이 watchdog을 발화시키지 않게.
         // watchdog이 이미 발화했으면 갱신하지 않는다(폴백 UI를 그대로 유지).
-        if (!watchdogFired) { lastSeen = Date.now(); }
+        if (!watchdogFired) { lastSeen = Date.now(); clearConnLost(); }
       };
       src.onmessage = function (e) {
         // SSE 메시지 수신 — lastSeen 갱신으로 watchdog 리셋.
@@ -6388,6 +6531,13 @@ function buildSseScript(strings) {
         if (!watchdogFired) { lastSeen = Date.now(); }
         try {
           var s = JSON.parse(e.data);
+          // 어떤 프레임이든 성공적으로 수신됐다는 건 서버가 살아있다는 뜻 —
+          // onerror가 세운 '연결 끊김' 표시를 해제한다 (#730).
+          clearConnLost();
+          // phase gate (#730) — 'complete'/'shutdown'은 terminal 상태이므로
+          // 나머지 필드 렌더보다 먼저 처리하고 즉시 반환한다.
+          if (s.phase === 'complete') { showTerminalBanner(COMPLETE_TITLE, COMPLETE_BODY); return; }
+          if (s.phase === 'shutdown') { showTerminalBanner(SHUTDOWN_TITLE, SHUTDOWN_BODY); return; }
           // 터널 상태 갱신
           var el = document.getElementById('tunnel-status');
           if (el) {
@@ -6466,7 +6616,11 @@ function buildSseScript(strings) {
         } catch (_) { /* 파싱 오류 무시 */ }
       };
       src.onerror = function () {
-        // 재연결은 EventSource가 자동 처리 (spec 기본 동작).
+        // EventSource는 "재시도 중"과 "서버 종료"를 구분하지 못하므로 즉시
+        // 구분되는 "연결 끊김"을 표시한다(#730). 네이티브 auto-reconnect는 그대로
+        // 진행되며 onopen/onmessage가 성공 즉시 이 상태를 해제한다. watchdog은
+        // 여전히 2차 fallback으로 남는다(최종 폴백 UI 전환).
+        showConnLost();
       };
     })();
   <\/script>`;
@@ -6515,7 +6669,12 @@ function buildAttachHtml(qrDataUrl, safeLabel, safeAttachUrl, locale, path = "/a
 		watchdogTimeoutMs,
 		watchdogTitle: JSON.stringify(s("dashboard.watchdog.title")),
 		watchdogBody: JSON.stringify(s("dashboard.watchdog.body")),
-		watchdogCloseLabel: JSON.stringify(s("dashboard.watchdog.close"))
+		watchdogCloseLabel: JSON.stringify(s("dashboard.watchdog.close")),
+		connectionLost: JSON.stringify(s("dashboard.conn.lost")),
+		completeTitle: JSON.stringify(s("dashboard.session.completeTitle")),
+		completeBody: JSON.stringify(s("dashboard.session.completeBody")),
+		shutdownTitle: JSON.stringify(s("dashboard.session.shutdownTitle")),
+		shutdownBody: JSON.stringify(s("dashboard.session.shutdownBody"))
 	});
 	return filled.replace("</body>", `${sseScript}\n</body>`);
 }
@@ -6542,7 +6701,9 @@ async function startQrHttpServer(getDashboardState, options) {
 			},
 			pages: state.pages,
 			attachUrl: state.attachUrl,
-			inspectorUrl: state.inspectorUrl ?? null
+			inspectorUrl: state.inspectorUrl ?? null,
+			phase: state.phase ?? "active",
+			manualPrompt: state.manualPrompt ?? null
 		});
 		res.write(`data: ${payload}\n\n`);
 	}
@@ -6851,7 +7012,7 @@ function createDebugServer(deps) {
 	};
 	const server = new Server({
 		name: "ait-debug",
-		version: "0.1.129"
+		version: "0.1.132"
 	}, { capabilities: { tools: { listChanged: true } } });
 	server.setRequestHandler(ListToolsRequestSchema, () => {
 		const conn = router.active;
@@ -7813,6 +7974,7 @@ async function runDebugServer(options = {}) {
 		return router.active;
 	});
 	let lastAttachParts = null;
+	let currentPhase = "active";
 	const getDashboardState = () => {
 		const targets = router.active.listTargets();
 		const inspectorUrl = qrServer?.inspectorStableUrl ?? null;
@@ -7827,7 +7989,8 @@ async function runDebugServer(options = {}) {
 			})),
 			attachUrl: lastAttachParts ? rebuildAttachUrl(lastAttachParts) : null,
 			inspectorUrl,
-			mode: deriveEnvironment(router.active.kind, router.activeRelayOrigin)
+			mode: deriveEnvironment(router.active.kind, router.activeRelayOrigin),
+			phase: currentPhase
 		};
 	};
 	const getDirectInspectorUrl = () => {
@@ -7891,6 +8054,8 @@ async function runDebugServer(options = {}) {
 	const shutdown = () => {
 		if (closed) return;
 		closed = true;
+		currentPhase = "shutdown";
+		qrServer?.notifyStateChange();
 		parentWatcher?.stop();
 		maxAgeWatchdog?.stop();
 		if (totpRefreshHandle) clearInterval(totpRefreshHandle);
@@ -8028,6 +8193,7 @@ async function runLocalDebugServer(options = {}) {
 		return router.active;
 	});
 	let lastAttachParts = null;
+	let currentPhase = "active";
 	const getDashboardState = () => {
 		const targets = router.active.listTargets();
 		const inspectorUrl = qrServer?.inspectorStableUrl ?? null;
@@ -8041,7 +8207,8 @@ async function runLocalDebugServer(options = {}) {
 				url: t.url
 			})),
 			attachUrl: lastAttachParts ? rebuildAttachUrl(lastAttachParts) : null,
-			inspectorUrl
+			inspectorUrl,
+			phase: currentPhase
 		};
 	};
 	const getDirectInspectorUrl = () => {
@@ -8105,6 +8272,8 @@ async function runLocalDebugServer(options = {}) {
 	const shutdown = () => {
 		if (closed) return;
 		closed = true;
+		currentPhase = "shutdown";
+		qrServer?.notifyStateChange();
 		parentWatcher?.stop();
 		maxAgeWatchdog?.stop();
 		if (totpRefreshHandle) clearInterval(totpRefreshHandle);
@@ -8225,6 +8394,7 @@ async function runMobileDebugServer(options = {}) {
 		return router.active;
 	});
 	let lastAttachParts = null;
+	let currentPhase = "active";
 	const getDashboardState = () => {
 		const targets = router.active.listTargets();
 		const inspectorUrl = qrServer?.inspectorStableUrl ?? null;
@@ -8238,7 +8408,8 @@ async function runMobileDebugServer(options = {}) {
 				url: t.url
 			})),
 			attachUrl: lastAttachParts ? rebuildAttachUrl(lastAttachParts) : null,
-			inspectorUrl
+			inspectorUrl,
+			phase: currentPhase
 		};
 	};
 	const getDirectInspectorUrl = () => {
@@ -8302,6 +8473,8 @@ async function runMobileDebugServer(options = {}) {
 	const shutdown = () => {
 		if (closed) return;
 		closed = true;
+		currentPhase = "shutdown";
+		qrServer?.notifyStateChange();
 		parentWatcher?.stop();
 		maxAgeWatchdog?.stop();
 		if (totpRefreshHandle) clearInterval(totpRefreshHandle);
@@ -8823,7 +8996,7 @@ function createDevServer(deps = {}) {
 	const aitSource = deps.aitSource ?? new HttpAitSource({ stateEndpoint });
 	const server = new Server({
 		name: "ait-devtools",
-		version: "0.1.129"
+		version: "0.1.132"
 	}, { capabilities: { tools: {} } });
 	server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: DEV_TOOL_DEFINITIONS.map((tool) => ({ ...tool })) }));
 	server.setRequestHandler(CallToolRequestSchema, async (request) => {