tabby-agentdeck 1.1.3 → 1.2.0

package/dist/settings.component.d.ts

@@ -1,11 +1,22 @@
-import { ConfigService, PlatformService } from 'tabby-core';
+import { AfterViewInit, ElementRef, NgZone, OnDestroy } from '@angular/core';
+import { ConfigService, HotkeysService, LocaleService, PlatformService } from 'tabby-core';
+import { KeyItem, BindingPlan } from './keybind';
 import { AgentDeckRecoveryService } from './recovery.service';
 import { AgentDeckUpdateService } from './update.service';
+import { AgentDeckDevReloadService } from './devReload.service';
 /**
  * 설정 > AgentDeck 탭.
  *
  * 사용자가 실제로 바꿀 일이 있는 것만 노출한다 — 레이아웃 on/off, 기동 시 탭 복원 끄기,
- * 사이드바 목록(키보드 조작 · 서브에이전트 개수), 세션 그룹, 미리보기 패널, 작업 루트 프로필.
+ * 지난 세션 이어받기, 에이전트 상태 연동, 작업 루트 프로필, 문제 신고, (개발 설치) 개발자 옵션.
+ * 2026-09-14 유저 지시로 자동 업데이트·이어받기 개수·사이드바 목록·세션 그룹·미리보기 패널 절을
+ * 템플릿에서 주석 처리했다 — "알아서 세팅해 두고, 고치고 싶으면 설정 파일을 직접 고칠 일".
+ * 같은 날 `"지금 이 탭" 줄`(metaLine)과 `통보 채널`(notifyChannel) 스위치도 걷어냈다 —
+ * 앞의 것은 statusLine 을 연결해 놓고 줄만 끄는 조합에 뜻이 없고, 뒤의 것은 훅 설치/제거가
+ * 정답을 이미 알고 있다(`syncNotifyChannel`). 두 값 모두 config 에는 남아 있다.
+ * 상태 훅과 statusLine 을 따로 걸던 줄 셋도 `Claude 연동` · `Codex 연동` 둘로 합쳤다
+ * (`toggleClaude`) — 사용자가 정하는 것은 "이 에이전트를 사이드바에 붙일까" 하나뿐이다.
+ * 값은 `config.ts` 기본값이 그대로 쓰인다. 아래 옛 설명은 그 절들이 있던 시절 기준이다.
  * 나머지(화면비, 사이드바 폭, 투명도, 상태 감지, 붙여넣기/줄바꿈 가로채기, 렌더 보정)는
  * 손댈 이유가 거의 없고 잘못 만지면 화면이 깨지는 값이라 `config.ts` 의 기본값으로 고정하고
  * 설정 창에서는 뺐다. 정말 필요하면 설정 파일의 `agentDeck.*` 를 직접 고친다.
@@ -28,19 +39,37 @@ import { AgentDeckUpdateService } from './update.service';
  * (deck.service.ts `navCanFocus`/`moveNav`, notify.service `subagentEnabled`)
  * 토글하면 바로 듣는다 — 그래서 재시작 안내를 붙이지 않았다.
  */
-export declare class AgentDeckSettingsTabComponent {
+export declare class AgentDeckSettingsTabComponent implements AfterViewInit, OnDestroy {
     config: ConfigService;
     recovery: AgentDeckRecoveryService;
     private update;
     private platform;
+    devReload: AgentDeckDevReloadService;
+    private host;
+    private locale;
+    private hotkeys;
+    private zone;
     /** 이 환경에서 훅을 걸 수 있나 (통보 스크립트가 PowerShell 이라 Windows 전용) */
     hooksSupported: boolean;
     /** 지금 걸려 있나 — 파일을 매번 읽지 않도록 화면용으로 들고 있는다 */
     hooksOn: boolean;
     codexHooksOn: boolean;
     codexHookError: string;
+    /**
+     * Codex 가 `/hooks` 에서 **꺼 둔** 우리 훅 (`config.toml` 의 `[hooks.state]`).
+     *
+     * 설치 여부와 따로 읽는다 — `hooks.json` 에 우리 항목이 있어도 Codex 가 꺼 두면
+     * 한 건도 오지 않는데, 그때 화면이 `연동됨` 이라고 말하면 사용자는 원인을 볼 수 없다
+     * (2026-09-14 실측: 상태 보고 폴더에 codex 파일 0건).
+     */
+    codexOff: string[];
     /** 훅을 쓰다 실패한 이유 — 조용히 삼키면 사용자는 버튼이 먹통인 줄 안다 */
     hookError: string;
+    /** statusLine 래퍼를 걸 수 있나 (스크립트가 패키지에 들어 있나) */
+    statusLineSupported: boolean;
+    /** 지금 감싸져 있나 */
+    statusLineOn: boolean;
+    statusLineError: string;
     /** 신고 안내에 그대로 보여줄 진단 로그 경로 */
     diagPath: string;
     /** 신고 본문에 적을 버전 — 사용자가 어느 버전을 쓰는지 스스로 알 방법이 없었다 */
@@ -51,11 +80,92 @@ export declare class AgentDeckSettingsTabComponent {
     diagBundlePath: string;
     /** 묶음을 만들다 실패한 이유 */
     diagError: string;
+    /**
+     * Claude 연동이 **온전히** 걸려 있나 — 상태 훅 + statusLine 둘 다.
+     *
+     * 반쪽(훅만 걸림)은 `false` 다. 그래야 버튼이 `설치` 로 남아 한 번 더 누르면 모자란 쪽이
+     * 채워진다 — `연동됨` 이라고 해 놓고 막대가 안 뜨면 사용자가 손댈 곳이 없어진다.
+     * statusLine 스크립트가 없는 설치본에서는 훅만으로 판정한다.
+     */
+    get claudeOn(): boolean;
+    /** 꺼진 훅 이름을 사람이 `/hooks` 에서 찾을 수 있는 표기로 */
+    get codexOffLabels(): string;
+    /** 두 갈래(훅·statusLine) 중 실패한 것만 모아 한 줄로 */
+    get claudeError(): string;
     /** `지금 확인` 이 도는 동안 버튼을 잠근다 (레지스트리 응답까지 몇 초) */
     updateBusy: boolean;
     /** 마지막 확인 결과 한 줄 */
     updateMsg: string;
-    constructor(config: ConfigService, recovery: AgentDeckRecoveryService, update: AgentDeckUpdateService, platform: PlatformService);
+    /** 늘어놓는 항목 — README 첫 화면의 표와 같은 순서 */
+    keyItems: KeyItem[];
+    /** 지금 키를 받고 있는 항목 id */
+    capturing: string | null;
+    /** 겹침이 나와 확인을 기다리는 계획 */
+    pending: {
+        plan: BindingPlan;
+        names: string;
+    } | null;
+    /** 한 줄 안내(숫자로 끝나야 한다 등) 와 그 대상 */
+    keyMsg: string;
+    keyMsgFor: string;
+    /** id → 사람이 읽는 이름. Tabby 순정·다른 플러그인 것까지 HotkeysService 가 모아 준다 */
+    private hotkeyNames;
+    private captureHandler;
+    private readonly keyPlatform;
+    /** 600px 제한을 풀어 둔 Tabby 의 본문 엘리먼트 (나갈 때 되돌린다) */
+    private widened;
+    /** 풀기 전의 값 — 인라인으로 없던 상태면 빈 문자열이라 그대로 되돌려진다 */
+    private prevMaxWidth;
+    /** 지금 그릴 언어 — Tabby 의 `설정 > 응용 프로그램 > 언어` 를 따라간다 */
+    private lang;
+    private localeSub;
+    constructor(config: ConfigService, recovery: AgentDeckRecoveryService, update: AgentDeckUpdateService, platform: PlatformService, devReload: AgentDeckDevReloadService, host: ElementRef<HTMLElement>, locale: LocaleService | null, hotkeys: HotkeysService | null, zone: NgZone);
+    /**
+     * 문구 하나. 표는 `i18n.ts` 에 있고 여기서는 언어만 얹는다.
+     *
+     * 템플릿에서 매 변경감지마다 불리는 함수다 — 표 조회 + 정규식 치환뿐이라 값이 싸고,
+     * 캐시를 두면 언어가 바뀌었을 때 무효화할 자리가 하나 더 생긴다.
+     */
+    t(key: string, params?: Record<string, string | number>): string;
+    /**
+     * 설정 본문의 600px 제한을 **이 탭에서만** 푼다.
+     *
+     * Tabby 는 모든 설정 탭 본문에 `settings-tab-body { max-width: 600px }` 를 건다
+     * (tabby-settings 컴포넌트 styles). 넓은 창에서는 오른쪽이 통째로 놀게 되는데,
+     * 그 규칙은 컴포넌트 스타일이라 우리 스타일시트로는 못 이긴다(우선순위가 아니라 `:host`
+     * 범위 문제다 — 우리 CSS 는 그 엘리먼트를 선택할 수는 있어도 어느 탭의 것인지 모른다).
+     * 그래서 **우리 엘리먼트에서 위로 찾아** 인라인으로 푼다. 화면을 어떻게 채울지는
+     * `styles.scss` 의 `agentdeck-settings-tab` 격자가 정한다.
+     *
+     * 되돌리기가 필요한 이유 — 이 엘리먼트는 다른 설정 탭과 **돌려 쓰일 수 있다**.
+     * 풀어 둔 채 나가면 남의 탭이 우리 때문에 넓어진다.
+     */
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    /** 이 항목이 지금 쓰는 키들 (사람 표기) */
+    keysOf(it: KeyItem): string[];
+    isPending(it: KeyItem): boolean;
+    isDefault(it: KeyItem): boolean;
+    /**
+     * 키 받기 시작. **window 캡처 단계**에 건다 — 그래야 document 에 걸린 Tabby 의 HotkeysService
+     * 리스너와 우리 deck.service 의 캡처 리스너(Ctrl+V · Shift+Enter)보다 먼저 받고, 전파를 끊어
+     * 그 키가 진짜로 실행되는 일(검색창이 열리거나 터미널에 붙여지는 일)을 막는다.
+     * 수식키만 눌린 이벤트는 그냥 흘린다 — 아직 조합 중이고, 막으면 Shift 추적이 어긋난다.
+     */
+    startCapture(it: KeyItem): void;
+    stopCapture(): void;
+    /** 겹침을 알고도 쓰기 — 겹치는 쪽에서 그 키를 뗀다 (한 번 눌러 둘이 도는 상태를 남기지 않는다) */
+    confirmPending(): void;
+    resetKeys(it: KeyItem): void;
+    private commit;
+    /**
+     * 기본값 표 — 순정 항목(split-right · split-bottom …)은 Tabby 의 플랫폼 기본표에서,
+     * 우리 항목과 close-pane 은 `defaultHotkeys()` 에서. 순정 기본표는 ConfigService 가 들고 있다
+     * (`getDefaults()`), 없으면 우리 표만으로 간다(그때 순정 항목의 `기본값` 은 비운다).
+     */
+    private keyDefaults;
+    private nameOf;
+    private loadHotkeyNames;
     /**
      * 사람이 직접 누른 확인. `force` 라 간격과 `다시 묻지 않기` 를 건너뛴다 —
      * 눌렀다는 것 자체가 "지금 알고 싶다" 는 뜻이다.
@@ -63,13 +173,28 @@ export declare class AgentDeckSettingsTabComponent {
     checkUpdate(): Promise<void>;
     private refreshHooks;
     /**
-     * 훅을 걸거나 뗀다.
+     * Claude 연동을 걸거나 뗀다 — **상태 훅과 statusLine 을 한 덩이로** 다룬다.
      *
-     * 걸 때는 통보 채널도 같이 켠다 — 훅만 걸고 채널이 닫혀 있으면 보고가 어디에도 닿지 않는데,
-     * 사용자 입장에서는 "설치했는데 아무 일도 안 일어난다" 로만 보인다.
+     * 따로 두었더니 "훅만 걸고 statusLine 은 안 건 상태" 가 흔하게 나왔고, 그 화면은
+     * 상태는 뜨는데 모델·한도 막대만 없어서 사용자가 원인을 못 짚는다 (2026-09-14 유저 지시:
+     * "status line 은 같은 취급 해"). 사용자가 정하는 것은 **이 에이전트를 사이드바에 붙일까**
+     * 하나뿐이고, 그걸 이루는 파일이 둘인 것은 우리 사정이다.
+     *
+     * 해제는 **원래 statusLine 을 제자리에 돌려놓는다** — 우리 것이 아니면 아무것도 건드리지
+     * 않는다(`unwrapStatusLine`). 되돌릴 것이 없던 사용자는 statusLine 키 자체가 지워진다.
+     *
+     * 한쪽만 실패해도 나머지는 계속 간다 — 둘 다 시도한 뒤 모아서 한 줄로 알린다.
+     * 그래야 "훅은 걸렸는데 statusLine 이 안 걸린" 반쪽 상태를 사용자가 볼 수 있다.
      */
-    toggleHooks(): void;
+    toggleClaude(): void;
     toggleCodexHooks(): void;
+    /**
+     * 통보 채널을 훅 설치 상태에 맞춘다 — 하나라도 걸려 있으면 열고, 하나도 없으면 닫는다.
+     *
+     * `refreshHooks()` **뒤에** 부른다. 실패해서 설치가 안 됐을 수도 있으므로 버튼을 누른
+     * 의도가 아니라 **파일을 다시 읽은 결과**를 기준으로 삼는다.
+     */
+    private syncNotifyChannel;
     /**
      * OS 폴더 선택 창을 띄워 작업 폴더를 고른다.
      *

package/dist/status.service.d.ts

@@ -62,6 +62,34 @@ export declare class WorkStatusService {
      * 탭 목록 변화는 사람이 만드는 빈도(초당 몇 번이 최대)라 문제가 되지 않는다.
      */
     sweep(alive: readonly BaseTabComponent[]): number;
-    /** 사이드바가 매 틱 호출 — idle 전환만 담당하고 화면 갱신 필요 여부를 돌려준다 */
-    tickIdle(tab: BaseTabComponent, idleAfterMs: number): boolean;
+    /**
+     * 사이드바가 매 틱 호출 — idle 전환만 담당하고 화면 갱신 필요 여부를 돌려준다.
+     *
+     * `staleAfterMs` 는 **고정(pinned)된 진행중 탭의 유예 시간**이다. 0 이면 예전과 같다.
+     *
+     * 왜 필요한가 — 훅에는 "세션이 끝났다" 가 없다. 설치하는 이벤트는 `UserPromptSubmit`
+     * `PostToolUse` `Notification` `Stop` 뿐이라(`claudeHooks.ts` PLAN), 세션이 정상 종료
+     * 밖으로 사라지면(Ctrl+C 로 끊음 · 창을 닫음 · CLI 크래시 · Tabby 가 탭을 복원했는데 그
+     * 세션은 이미 죽음) **마지막으로 온 `running` 이 영원히 남는다.** `setManual` 이 pinned 를
+     * 세우고 여기서 pinned 를 그냥 건너뛰었으므로, 그 탭에는 배지가 내려올 길이 한 개도 없었다
+     * (`setAuto` 는 pinned 를 무시하고 `resume` 은 waiting 전용이며 `unpin` 은 사람이 메뉴에서
+     * 고르는 것뿐이다). 사이드바에 "작업중" 이 박혀 있는 탭이 실은 아무것도 안 하고 있는 모양이
+     * 이 구멍이다.
+     *
+     * **살아 있다는 증거는 셋 다 인정한다** — 훅 보고(`since` 는 `setManual` 이 매 보고마다
+     * 새로 찍는다) · PTY 출력(`lastOutput`) · 작업중 신호(`lastBusy`). 셋 중 가장 최근 것에서
+     * 잰다. 그래서 오래 도는 빌드처럼 화면이 조용해 보이는 작업도, 스피너든 훅이든 하나만
+     * 살아 있으면 내려가지 않는다.
+     *
+     * **대상은 `running`·`done`·`error` 뿐이다**(`STALE_STATUSES`). 푸는 것은 **고정**이고,
+     * `진행중` 일 때만 이어서 `idle` 로 내린다 — 기척이 끊긴 진행중은 거짓말이지만, `완료`·`오류`
+     * 는 실제로 있었던 일이라 글자를 지울 이유가 없다. 그 둘에서 필요한 것은 **다음 출력이
+     * 배지를 되살릴 수 있게 하는 것**뿐이다: CLI 를 끄고 같은 탭에서 셸을 쓰면 `setAuto` 가
+     * 계속 들어오는데 pinned 라 전부 무시돼 배지가 `완료` 에 박혀 있었다.
+     *
+     * 고정을 반드시 푸는 이유도 같다. idle 로만 내리고 pinned 를 남기면 그 탭은 이어지는
+     * 자동 감지를 계속 무시한다 — 구멍을 반만 막는 셈이다. 다음 훅 보고가 오면 `setManual`
+     * 이 다시 고정한다.
+     */
+    tickIdle(tab: BaseTabComponent, idleAfterMs: number, staleAfterMs?: number): boolean;
 }

package/dist/statusLine.d.ts

@@ -0,0 +1,27 @@
+/** 원래 걸려 있던 statusLine 을 옮겨 두는 자리 (스크립트도 같은 경로를 읽는다) */
+export declare function innerConfigPath(): string;
+/** statusLine 스크립트의 실제 경로. dist/index.js 기준으로 한 단계 위가 패키지 뿌리다 */
+export declare function statusLineScriptPath(): string;
+export declare function statusLineSupported(): boolean;
+/** 우리 래퍼가 걸려 있나 — 파일을 읽지 않는 순수 판정 */
+export declare function isWrapped(settings: any): boolean;
+/**
+ * 설정 객체의 statusLine 을 우리 래퍼로 갈아 끼운 새 객체를 돌려준다 (원본은 건드리지 않는다).
+ *
+ * 이미 우리 것이면 명령줄만 지금 경로로 갱신한다 — 그때 안쪽 설정은 **그대로 둔다**
+ * (다시 옮기면 안쪽에 우리 자신이 들어가 고리가 된다).
+ */
+export declare function wrapStatusLine(settings: any, script: string): {
+    next: any;
+    inner: any | null;
+};
+/**
+ * 우리 래퍼를 걷어내고 안쪽 설정을 제자리에 돌려놓은 새 객체.
+ * 안쪽이 없었으면(원래 statusLine 이 없던 사용자) 키 자체를 지운다.
+ */
+export declare function unwrapStatusLine(settings: any, inner: any | null): any;
+export declare function statusLineInstalled(): boolean;
+/** 지금 안쪽에 무엇이 있는지 (설정 창이 사용자에게 보여 준다) */
+export declare function innerCommand(): string;
+export declare function installStatusLine(): void;
+export declare function uninstallStatusLine(): void;

package/dist/update.d.ts

@@ -4,11 +4,17 @@
  * 네트워크·fs·타이머는 여기 없다 (`group.ts`·`sessionLedger.ts` 와 같은 이유). 이 파일은
  * "무엇을 근거로 결정하는가" 만 정하고, 실제로 묻고 설치하는 것은 `update.service.ts` 다.
  *
- * ## 왜 "받아 두고 다음 기동에 적용" 인가
+ * ## 적용은 **창만 새로 고쳐서** 한다 (Tabby 를 닫지 않는다)
  *
- * Tabby 는 플러그인을 **기동할 때 한 번** 읽는다. 돌고 있는 플러그인을 갈아끼울 방법이 없으므로
- * 어떤 방식으로 업데이트하든 재시작이 필요하다. 그래서 이 기능은 조용히 받아만 두고
- * "재시작하면 적용된다" 고 한 번 알린다 — 사람의 작업을 끊지 않는 유일한 모양이다.
+ * Tabby 는 플러그인을 기동할 때 `dist/index.js` 를 한 번 읽는다. 그래서 예전에는
+ * "닫았다가 설치하고 다시 띄운다" 였는데, 그 사이 열린 탭과 돌고 있는 세션이 전부 끊겼다.
+ * 지금은 `reload.service.ts` 가 **renderer 만 리로드**하면서 탭을 복구 토큰으로 되살린다 —
+ * pty 는 main 프로세스가 쥐고 있어 창이 다시 떠도 살아 있다. 리로드는 디스크를 다시 읽으므로
+ * 새로 깔린 코드가 그대로 뜬다.
+ *
+ * 그래서 설치도 **Tabby 가 떠 있는 채로** 한다. 로드된 `.js` 는 Windows 가 잡고 있지 않으므로
+ * (require 는 읽고 바로 닫는다 — 2026-09-14 실측: 요구된 파일이 든 폴더를 그대로 지울 수 있었다)
+ * npm 이 플러그인 폴더를 갈아끼워도 돌고 있는 코드는 메모리에 그대로다.
  */
 /** npm 레지스트리 기본값. 사내 미러를 쓰는 사람은 설정으로 바꾼다 */
 export declare const DEFAULT_REGISTRY = "https://registry.npmjs.org";
@@ -58,7 +64,15 @@ export declare function canSelfUpdate(marks: {
     hasWebpackConfig: boolean;
     isLink: boolean;
 }): boolean;
-export type UpdateOutcome = 'disabled' | 'too-soon' | 'dev-install' | 'unknown' | 'up-to-date' | 'update-ready' | 'skipped' | 'postponed' | 'installing' | 'failed';
+/**
+ * 설치가 실제로 끝났나 — **디스크의 버전**으로 판정한다.
+ *
+ * npm 이 0 으로 끝나도 폴더가 옛것 그대로일 수 있다(캐시·권한·프록시). 그 상태로 창을
+ * 리로드하면 "업데이트했다" 고 해 놓고 같은 버전이 다시 뜬다. 그래서 갈아끼우기 직전에
+ * `<plugins>/node_modules/<pkg>/package.json` 의 버전을 읽어 기대값과 맞춰 본다.
+ */
+export declare function installSucceeded(expected: string, onDisk: unknown): boolean;
+export type UpdateOutcome = 'disabled' | 'too-soon' | 'dev-install' | 'unknown' | 'up-to-date' | 'update-ready' | 'skipped' | 'postponed' | 'installing' | 'installed' | 'failed';
 /**
  * 확인 결과로 무엇을 할지 — 순수 결정.
  *

package/dist/update.service.d.ts

@@ -1,18 +1,20 @@
 import { AppService, ConfigService, NotificationsService, PlatformService } from 'tabby-core';
+import { AgentDeckReloadService } from './reload.service';
 import { UpdateOutcome } from './update';
 /**
- * npm 레지스트리를 보고 **Tabby 를 껐다 켜면서** 새 버전을 깐다.
+ * npm 레지스트리를 보고 **Tabby 를 띄운 채로** 새 버전을 깐다.
  *
  * 흐름은 넷이다 —
  *  ① 기동하고 잠시 뒤 레지스트리에 묻는다
  *  ② 새 버전이 있으면 **물어본다** (`지금 업데이트` / `나중에` / `다시 묻지 않기`)
- *  ③ 승낙하면 설치 스크립트를 **밖으로 띄우고** Tabby 를 닫는다
- *  ④ 스크립트가 Tabby 종료를 기다렸다가 설치하고 다시 띄운다
+ *  ③ 승낙하면 설치 스크립트를 임시 폴더에서 돌린다 — **Tabby 는 그대로 떠 있다**
+ *  ④ 디스크 버전을 확인하고 **창만 새로 고친다**(`reload.service`) — 탭과 세션은 살아남는다
  *
- * **왜 밖에서 까나.** 돌고 있는 플러그인은 자기를 갈아끼울 수 없다 — Tabby 는 기동할 때
- * `dist/index.js` 를 한 번 읽어 메모리에 올리므로 디스크를 바꿔도 돌던 코드는 옛것이다.
- * 게다가 Windows 는 로드된 파일을 잡고 있어서, 떠 있는 동안 npm 이 그 폴더를 지우려 들면
- * 반쯤 지운 채 실패할 수 있다 — 플러그인이 깨진 채 남는 것이 가장 나쁜 결과다.
+ * **예전에는 닫았다 켰다.** 돌고 있는 플러그인은 자기를 갈아끼울 수 없고(모듈이 이미
+ * 메모리에 있다) Windows 가 파일을 잡고 있을까 걱정했기 때문인데, 둘 다 지금은 해결됐다 —
+ * 적용은 renderer 리로드가 하고(pty 는 main 이 쥐고 있어 살아남는다), 로드된 `.js` 는
+ * 잠기지 않는다(2026-09-14 실측: require 한 파일이 든 폴더를 그대로 지울 수 있었다).
+ * 남은 조건은 하나 — **설치 스크립트는 패키지 밖에서 돌려야 한다**(제 발밑을 npm 이 갈아엎는다).
  *
  * **개발 설치에는 설치하지 않는다.** 플러그인 폴더의 `tabby-agentdeck` 은 개발 중에는 소스
  * 트리를 가리키는 링크이고(`plugins/package.json` 에 `file:D:/Project/tabby-agentdeck` 로 적힌다),
@@ -23,7 +25,8 @@ export declare class AgentDeckUpdateService {
     private config;
     private platform;
     private notifications;
-    constructor(app: AppService, config: ConfigService, platform: PlatformService, notifications: NotificationsService);
+    private reloader;
+    constructor(app: AppService, config: ConfigService, platform: PlatformService, notifications: NotificationsService, reloader: AgentDeckReloadService);
     init(): void;
     /**
      * 한 번 확인하고, 새 버전이면 물어본 뒤 설치를 건다.
@@ -32,26 +35,32 @@ export declare class AgentDeckUpdateService {
      * (사람이 직접 눌렀으니 그 순간만큼은 묻는 게 맞다). 기능 자체를 끈 것은 존중한다.
      */
     run(reason: string, force?: boolean): Promise<UpdateOutcome>;
-    /** ② 물어보고 ③ 설치 스크립트를 띄운 뒤 Tabby 를 닫는다 */
+    /** ② 물어보고 ③ 제자리에 깐 뒤 ④ 창만 새로 고친다 */
     private confirmAndInstall;
     /**
-     * 설치 스크립트를 **패키지 밖에서** 떼어 띄운다.
+     * ③ 제자리에 깔고 ④ 창을 새로 고친다 — **묻는 단계는 이미 지났다.**
      *
-     * 임시 폴더로 복사하는 이유: 이 스크립트는 곧 npm 이 통째로 갈아엎을 폴더 안에 산다.
-     * 제자리에서 돌리면 자기 발밑이 사라진다.
+     * 따로 떼어 둔 이유는 회귀 때문이다. `showMessageBox` 는 OS 의 모달이라 CDP 로 누를 수
+     * 없어서, 묻기와 한 덩어리면 이 길을 자동으로 한 번도 못 밟아 본다
+     * (`tools/regress-update.js` 가 여기를 부른다).
      *
-     * `detached` + `unref` 라야 Tabby 가 죽어도 살아남는다 — 부모가 죽을 때 같이 끌려가면
-     * 설치는커녕 Tabby 를 다시 띄우지도 못한다.
+     * `spec` 은 npm 에 건넬 대상을 바꾼다 — **회귀 전용**이다. 기본값(`tabby-agentdeck@<버전>`)은
+     * 레지스트리를 보지만, 회귀는 *지금 이 소스로 만든 tgz* 를 깔아야 한다. 이미 배포된 버전을
+     * 깔면 그 안에는 이 코드가 없어서, 리로드 뒤 복구를 맡을 쪽이 옛 코드가 된다.
      */
-    private launchUpdater;
+    installAndReload(current: string, latest: string, spec?: string): Promise<UpdateOutcome>;
     /**
-     * 이 Tabby 인스턴스의 **메인 프로세스 PID**.
+     * 설치 스크립트를 **패키지 밖에서** 돌리고 끝날 때까지 기다린다.
+     *
+     * 임시 폴더로 복사하는 이유: 이 스크립트는 곧 npm 이 통째로 갈아엎을 폴더 안에 산다.
+     * 제자리에서 돌리면 자기 발밑이 사라진다.
      *
-     * 플러그인은 렌더러에서 돌고, Electron 렌더러의 부모가 메인이다. 메인이 죽으면 렌더러·gpu 도
-     * 함께 내려가므로 "이 인스턴스가 완전히 꺼졌나" 를 재는 기준점으로 이것이 맞다.
-     * `ppid` 를 못 읽는 환경(테스트 하네스 등)에서는 0 을 주고, 스크립트가 옛 방식으로 물러난다.
+     * `-InPlace` 는 "Tabby 종료를 기다리지도, 다시 띄우지도 말라" 는 뜻이다. 기다릴 이유가
+     * 없어졌고(파일이 잠기지 않는다), 다시 띄울 이유도 없다(닫지 않는다).
      */
-    private mainProcessPid;
+    private runUpdater;
+    /** 플러그인 폴더에 **실제로 깔려 있는** 버전 — 설치 성공 판정의 근거 */
+    private installedVersion;
     /** `<Tabby 설정폴더>/plugins` — npm 이 `--prefix` 로 받을 경로 */
     private pluginsDir;
     /**

package/dist/viewPanel.d.ts

@@ -77,7 +77,7 @@ export declare class ViewPanel {
      * `변경` 목록의 범위. `session` = 이번 세션이 만진 파일만, `all` = 저장소의 커밋 안 된 전부.
      *
      * **기본이 `session` 인 이유** — `git diff HEAD` 는 저장소 사정에 따라 수백 개가 나온다
-     * (P4 워크스페이스 위의 git 오버레이에서 405개 실측, 2026-09-11). 그 안에서 방금 에이전트가
+     * (큰 워크스페이스 위의 git 오버레이에서는 흔한 일이다). 그 안에서 방금 에이전트가
      * 고친 것을 찾을 수는 없다. 설정에 저장하지 않는다 — 모드(`file`/`diff`)와 같은 이유로
      * 기동 때는 늘 기본값에서 시작한다.
      */
@@ -204,8 +204,18 @@ export declare class ViewPanel {
      * (사이드바 `dock.ts` 가 절대 거리로 재는 것은 거기서만 맞다 — 사이드바는 창에 딱 붙는다.)
      */
     private installResize;
-    /** deck 의 relayout 이 정해 준 자리에 앉는다 (사이드바와 같은 방식으로 절대 배치) */
-    layout(side: ViewSide, width: number, outerOffset: number): void;
+    /**
+     * deck 의 relayout 이 정해 준 자리에 앉는다 (사이드바와 같은 방식으로 절대 배치).
+     *
+     * 네 값 모두 **컨테이닝 블록 좌표로 이미 풀린 실좌표**다 — 예전처럼 `right: outerOffset` 으로
+     * 가장자리에 붙이면 그 가장자리가 화면 밖일 때 패널도 같이 밀려난다 (deck.service anchorOrigin).
+     */
+    layout(side: ViewSide, rect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    }): void;
     private togglePathRow;
     private setPathNote;
     /**

package/hooks/agentdeck-codex-notify.ps1

@@ -1,4 +1,4 @@
-# Codex lifecycle -> existing AgentDeck file/TCP transport. Never emit model context.
+# Codex lifecycle -> existing AgentDeck file/TCP transport. Never emit model context.
 $ErrorActionPreference = 'Stop'
 try {
     $reader = New-Object System.IO.StreamReader([Console]::OpenStandardInput(), (New-Object System.Text.UTF8Encoding($false)))
@@ -18,7 +18,10 @@ try {
     if ($status -eq 'waiting') {
         $hook | Add-Member -NotePropertyName message -NotePropertyValue ('Approval: ' + [string]$hook.tool_name) -Force
     }
-    $hook | ConvertTo-Json -Depth 30 -Compress | & (Join-Path $PSScriptRoot 'agentdeck-notify.ps1') -Status $status -Agent codex
+    # JSON is passed as -HookJson, not piped: a script that accepts pipeline input makes the host pre-read
+    # stdin in the console codepage (CP949), which corrupts non-ASCII text for external callers.
+    $json = $hook | ConvertTo-Json -Depth 30 -Compress
+    & (Join-Path $PSScriptRoot 'agentdeck-notify.ps1') -Status $status -Agent codex -HookJson $json
 } catch {
     # Status reporting must not block the agent if Tabby is unavailable.
     exit 0

package/hooks/agentdeck-label.js

@@ -2,7 +2,7 @@
 /**
  * 작업 라벨만 바꾼다 (상태는 건드리지 않는다).
  *
- *   node agentdeck-label.js <sessionId> "회랑 정산 버그 수정"
+ *   node agentdeck-label.js <sessionId> "결제 모듈 버그 수정"
  *   AGENTDECK_SESSION=<id> node agentdeck-label.js "빌드 중"
  *
  * 에이전트가 단계(분석→구현→빌드→검증)를 넘어갈 때마다 부르는 용도다.

package/hooks/agentdeck-notify.ps1

@@ -33,10 +33,13 @@
   # "Stop":                -Status done      답이 끝났다
   # "StopFailure":         -Status error     턴이 실패로 끝났다 (rate_limit 이면 limited)
 #>
-param(
-    [ValidateSet('claude', 'codex')]
-    [string]$Agent = 'claude',
-
+param(
+    # 어느 CLI 가 보냈나. **이 값이 에이전트 판정의 1순위 근거다** — 플러그인이 프로세스 이름·
+    # 명령줄·탭 제목·화면 문구로 추측하던 것(deck.service `detectAgentApp`)을 이 한 줄이 대신한다.
+    # 자기가 누구인지는 훅을 부르는 쪽이 아는 사실이지 추측할 일이 아니다 (cwd·tabId 와 같은 이치).
+    [ValidateSet('claude', 'codex', 'gemini')]
+    [string]$Agent = 'claude',
+
     [ValidateSet('running', 'waiting', 'limited', 'done', 'error', 'idle')]
     [string]$Status,
 
@@ -59,17 +62,30 @@ param(
     # 없앤 순간 "알 수 없는 인자" 로 훅이 통째로 실패한다
     [switch]$PromptAsLabel,
 
-    [int]$MaxLabel = 40
+    [int]$MaxLabel = 40,
+
+    # 같은 PowerShell 안에서 부르는 래퍼(agentdeck-codex-notify.ps1)가 훅 JSON 을 넘기는 자리.
+    # 파이프(`$json | & notify.ps1`)로 넘기지 않는 이유는 아래 stdin 주석 — 스크립트가 파이프 입력을
+    # 받는 순간 외부 호출(Claude Code)의 stdin 이 CP949 로 깨진다
+    [string]$HookJson
 )
 
 $ErrorActionPreference = 'SilentlyContinue'
 
 try {
     # PS 5.1 은 stdin 을 시스템 ANSI(CP949) 로 읽어 UTF-8 JSON 의 한글을 깨뜨린다.
-    # 표준입력 스트림을 UTF-8 로 직접 열어서 읽는다
-    $reader = New-Object System.IO.StreamReader([Console]::OpenStandardInput(), (New-Object System.Text.UTF8Encoding($false)))
-    $raw = if ($MyInvocation.ExpectingInput) { ($input | Out-String) } else { $reader.ReadToEnd() }
-    $reader.Close()
+    # 표준입력 스트림을 UTF-8 로 직접 열어서 읽는다.
+    #
+    # **이 파일 어디에도 파이프 입력 자동변수를 쓰지 말 것.** 스크립트가 그걸 참조하기만 해도
+    # PowerShell 호스트가 실행 전에 stdin 을 콘솔 인코딩(CP949)으로 먼저 다 읽어 가서, 아래 원본 스트림은
+    # 비고 파이프 입력 쪽은 이미 깨져 있다. 실측(2026-09-14): 참조하는 스크립트는 15/15 원본 스트림 0자,
+    # 참조하지 않는 스크립트는 15/15 2606자 온전 — 한도 문구의 `·` 가 `쨌` 로 깨지던 HK2·HK6 의 원인이었다
+    $raw = $HookJson
+    if (-not $raw) {
+        $reader = New-Object System.IO.StreamReader([Console]::OpenStandardInput(), (New-Object System.Text.UTF8Encoding($false)))
+        $raw = $reader.ReadToEnd()
+        $reader.Close()
+    }
     $hook = if ($raw) { $raw | ConvertFrom-Json } else { $null }
 } catch {
     $hook = $null
@@ -121,7 +137,7 @@ if ($hook -and [string]$hook.hook_event_name -eq 'StopFailure') {
 
 # --- 이번 도구가 고친 파일 ---
 # `변경` 탭이 "이 세션이 만진 것만" 을 그리는 근거다. 저장소 전체 diff 는 P4 워크스페이스 위에
-# git 을 얹은 곳에서 405개씩 나와 쓸모가 없다 (2026-09-11 유저 지적).
+# git 을 얹은 곳에서 수백 개씩 나와 쓸모가 없다.
 # Edit/Write/NotebookEdit 은 전부 `tool_input.file_path` 를 쓴다. 다른 도구에는 없으므로 그냥 비고,
 # 훅이 아예 없는 에이전트는 이 키가 영영 안 와서 플러그인이 전체 목록으로 떨어진다(그게 폴백이다).
 $touchedFile = ''
@@ -215,7 +231,7 @@ if ($tabId) {
 # 그래서 Stop(done) 뒤에 유휴 알림이 오면 완료된 탭이 '승인대기' 로 뒤집힌다 (2026-08-28 실측:
 # status 폴더의 두 세션이 작업을 끝냈는데도 waiting 으로 박혀 있었다).
 # 승인 요청이 아닌 알림이면 상태를 건드리지 않는다.
-if ($Status -eq 'waiting' -and $Agent -eq 'claude') {
+if ($Status -eq 'waiting' -and $Agent -eq 'claude') {
     $msg = if ($hook -and $hook.message) { [string]$hook.message } else { '' }
     $idleNotice = $msg -match '(?i)waiting for your input|idle'
     $alreadyFinished = $prevStatus -eq 'done' -or $prevStatus -eq 'idle' -or $prevStatus -eq 'limited'
@@ -260,6 +276,10 @@ $effectiveStatus = if ($Status) { $Status } elseif ($prevStatus) { $prevStatus }
 $payload = [ordered]@{
     sessionId = $targetId
     ts        = [int64](([datetime]::UtcNow - [datetime]'1970-01-01').TotalMilliseconds)
+    # 누가 보냈나. 상태·서브에이전트와 달리 **매번 같은 값**이지만 그래도 매번 싣는다 —
+    # 빼먹은 보고가 하나라도 있으면 플러그인이 그 탭을 다시 추측 경로로 떨어뜨린다.
+    # (서브에이전트 이벤트처럼 status 를 안 싣는 보고에도 들어가야 하므로 아래 분기 밖에 둔다)
+    agent     = $Agent
 }
 # **서브에이전트 이벤트는 상태를 싣지 않는다.** 이 훅에는 `-Status` 가 없어서 직전 상태를
 # 되쓰게 되는데, 그러면 이미 `done` 인 세션에 백그라운드 에이전트의 stop 이 도착할 때
@@ -327,7 +347,7 @@ if ($pids.Count -gt 0) {
 # 뭉개 버린다(중첩 한 겹이 더 생겼다). 원소가 하나일 때 배열이 스칼라로 접히는 문제는 받는 쪽에서
 # 배열/단일을 모두 받아 푼다 — PowerShell 의 JSON 변환은 그 접힘을 끌 수 없다
 $json = $payload | ConvertTo-Json -Compress -Depth 5
-$tmp = "$file.$PID.tmp"
+$tmp = "$file.$PID.tmp"
 $enc = New-Object System.Text.UTF8Encoding($false)
 [System.IO.File]::WriteAllText($tmp, $json, $enc)
 [System.IO.File]::Copy($tmp, $file, $true)