tabby-agentdeck 1.1.2 → 1.2.0

package/hooks/agentdeck-notify.ps1

@@ -34,12 +34,26 @@
   # "StopFailure":         -Status error     턴이 실패로 끝났다 (rate_limit 이면 limited)
 #>
 param(
+    # 어느 CLI 가 보냈나. **이 값이 에이전트 판정의 1순위 근거다** — 플러그인이 프로세스 이름·
+    # 명령줄·탭 제목·화면 문구로 추측하던 것(deck.service `detectAgentApp`)을 이 한 줄이 대신한다.
+    # 자기가 누구인지는 훅을 부르는 쪽이 아는 사실이지 추측할 일이 아니다 (cwd·tabId 와 같은 이치).
+    [ValidateSet('claude', 'codex', 'gemini')]
+    [string]$Agent = 'claude',
+
     [ValidateSet('running', 'waiting', 'limited', 'done', 'error', 'idle')]
     [string]$Status,
 
     # 사람이 셸에서 직접 붙이는 작업 이름. 이때만 라벨을 보낸다
     [string]$Label,
 
+    # 서브에이전트 생명주기. SubagentStart -> start / SubagentStop -> stop.
+    # `-Agent` 는 이미 어느 CLI 가 보냈나(claude/codex)에 쓰이므로 이름을 따로 둔다.
+    # **상태(-Status)와 섞지 않는다** — 이 이벤트는 세션 상태를 바꾸지 않고 개수만 움직인다.
+    # 훅 JSON 의 `agent_id` 가 함께 오므로 플러그인이 id 로 정확히 켜고 끈다(실측 payload:
+    # SubagentStart = agent_id·agent_type·session_id, SubagentStop = 같은 agent_id).
+    [ValidateSet('start', 'stop')]
+    [string]$Subagent,
+
     # stdin 훅 JSON 없이 부를 때 대상 세션 (없으면 가장 최근에 갱신된 세션)
     [string]$SessionId,
 
@@ -48,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 = $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
@@ -108,11 +135,26 @@ if ($hook -and [string]$hook.hook_event_name -eq 'StopFailure') {
     $failReason = if ($Status -eq 'limited' -and $hook.last_assistant_message) { [string]$hook.last_assistant_message } else { $code }
 }
 
+# --- 이번 도구가 고친 파일 ---
+# `변경` 탭이 "이 세션이 만진 것만" 을 그리는 근거다. 저장소 전체 diff 는 P4 워크스페이스 위에
+# git 을 얹은 곳에서 수백 개씩 나와 쓸모가 없다.
+# Edit/Write/NotebookEdit 은 전부 `tool_input.file_path` 를 쓴다. 다른 도구에는 없으므로 그냥 비고,
+# 훅이 아예 없는 에이전트는 이 키가 영영 안 와서 플러그인이 전체 목록으로 떨어진다(그게 폴백이다).
+$touchedFile = ''
+if ($hook -and $hook.tool_input -and $hook.tool_input.file_path) {
+    $touchedFile = [string]$hook.tool_input.file_path
+}
+
 # --- 진행중 중복 보고 생략 ---
 # PostToolUse 는 도구가 돌 때마다 발화한다. 이미 running 인데 running 을 또 쓰면 파일·TCP 만 흔들고
 # 사이드바는 변하지 않는다(경과시간이 매 도구마다 0 으로 되돌아가기까지 한다). 라벨 지정도 없으면 여기서 끝낸다 —
-# 아래 계보 조회(~450ms)까지 건너뛰므로 도구마다 붙는 비용이 사실상 없다
-if ($Status -eq 'running' -and $prevStatus -eq 'running' -and -not $Label) { exit 0 }
+# 아래 계보 조회(~450ms)까지 건너뛰므로 도구마다 붙는 비용이 사실상 없다.
+# **고친 파일이 있으면 건너뛰지 않는다** — 그 보고가 곧 `변경` 탭의 목록이라 하나라도 빠지면
+# 그 파일이 화면에서 사라진다. 대신 그 경우에도 계보 조회는 하지 않는다(아래 tabId 분기):
+# 세션은 이미 탭에 묶여 있어 sessionId 만으로 찾아간다(notify.service `resolveTab` 의 `alive`).
+# **서브에이전트 이벤트도 건너뛰지 않는다** — 하나 빠지면 개수가 영구히 어긋난다(start 를 놓치면
+# 적게, stop 을 놓치면 많게 굳는다). 이쪽도 계보 조회는 하지 않는다(아래 tabId 분기).
+if ($Status -eq 'running' -and $prevStatus -eq 'running' -and -not $Label -and -not $touchedFile -and -not $Subagent) { exit 0 }
 
 # --- 어느 탭인가: tabId (1순위) / 프로세스 계보 pids (폴백) ---
 # 사이드바가 이 보고를 어느 탭에 붙일지 정하는 근거. 예전 규칙 "처음 보고할 때의 활성 탭" 은
@@ -139,9 +181,12 @@ $tabId = ([string]$env:AGENTDECK_TAB).Trim()
 $pids = @()
 $claudePid = 0
 $claudeName = ''
+# 이미 running 인 세션의 "파일만 알리는" 보고와 서브에이전트 이벤트에서는 계보를 재지 않는다 —
+# 450ms 짜리 Win32_Process 전체 조회를 Edit·에이전트마다 낼 수는 없다. 그 세션은 앞선 보고로
+# 이미 탭에 묶여 있어 sessionId 만으로 찾아간다 (notify.service `resolveTab` 의 `alive` 경로).
 if ($tabId) {
     # 탭이 확정됐다 — 계보는 계산하지 않는다
-} elseif ($hook) {
+} elseif ($hook -and -not $Subagent -and -not ($Status -eq 'running' -and $prevStatus -eq 'running')) {
     $reuse = $false
     if ($prev -and $prev.pids -and $prev.claudePid) {
         $aliveProc = Get-Process -Id ([int]$prev.claudePid) -ErrorAction SilentlyContinue
@@ -186,7 +231,7 @@ if ($tabId) {
 # 그래서 Stop(done) 뒤에 유휴 알림이 오면 완료된 탭이 '승인대기' 로 뒤집힌다 (2026-08-28 실측:
 # status 폴더의 두 세션이 작업을 끝냈는데도 waiting 으로 박혀 있었다).
 # 승인 요청이 아닌 알림이면 상태를 건드리지 않는다.
-if ($Status -eq 'waiting') {
+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'
@@ -230,12 +275,64 @@ $effectiveStatus = if ($Status) { $Status } elseif ($prevStatus) { $prevStatus }
 
 $payload = [ordered]@{
     sessionId = $targetId
-    status    = $effectiveStatus
     ts        = [int64](([datetime]::UtcNow - [datetime]'1970-01-01').TotalMilliseconds)
+    # 누가 보냈나. 상태·서브에이전트와 달리 **매번 같은 값**이지만 그래도 매번 싣는다 —
+    # 빼먹은 보고가 하나라도 있으면 플러그인이 그 탭을 다시 추측 경로로 떨어뜨린다.
+    # (서브에이전트 이벤트처럼 status 를 안 싣는 보고에도 들어가야 하므로 아래 분기 밖에 둔다)
+    agent     = $Agent
 }
+# **서브에이전트 이벤트는 상태를 싣지 않는다.** 이 훅에는 `-Status` 가 없어서 직전 상태를
+# 되쓰게 되는데, 그러면 이미 `done` 인 세션에 백그라운드 에이전트의 stop 이 도착할 때
+# 세션이 `running` 으로 되살아난다 (백그라운드 에이전트는 턴이 끝난 뒤에도 돈다).
+if (-not $Subagent) { $payload['status'] = $effectiveStatus }
 if ($newLabel) { $payload['label'] = $newLabel }
 if ($reason) { $payload['reason'] = $reason }
 if ($tabId) { $payload['tabId'] = $tabId }
+# --- 작업 폴더 ---
+# 훅 JSON 의 `cwd` 는 에이전트가 실제로 돌고 있는 폴더다. 이걸 보내는 이유는 Tabby 순정의 cwd 추정이
+# 윈도우에서 못 믿을 값을 내기 때문이다 — `guessWindowsCWD` 가 PTY 출력에서 `X:\...` 처럼 보이는
+# 첫 토큰을 그대로 cwd 로 삼는다(tabby-local/dist/index.js:1316, 정규식 /([a-zA-Z]:[^\:\[\]\?\"\<\>\|]+)/mi).
+# 에이전트가 화면에 찍은 **파일 경로**도 걸려서, 미리보기 `변경` 탭이 `git -C <파일.py>` 를 돌리고
+# `fatal: cannot change to ...: Invalid argument` 로 끝났다 (2026-09-11 실측).
+if ($hook -and $hook.cwd) { $payload['cwd'] = [string]$hook.cwd }
+# 이번 도구가 고친 파일 — 플러그인이 탭별로 모아 `변경` 탭의 '세션' 목록을 만든다
+if ($touchedFile) { $payload['file'] = $touchedFile }
+
+# --- 지금 도는 서브에이전트 (스냅샷) ---
+# **증분(이번에 하나 떴다/졌다)이 아니라 목록 전체를 보낸다.** 이유는 상태 파일이 "마지막 보고
+# 한 건" 만 담기 때문이다 — TCP 가 막혀 폴링(400ms)으로만 전달되는 환경에서 start 와 stop 이
+# 한 주기 안에 겹치면 앞의 것이 덮여 **영영 유실**되고, 누적으로 세는 개수는 그대로 어긋난다
+# (상태값은 최신 하나만 의미가 있어서 이 구조로 충분했지만, 개수는 아니다).
+# 목록을 통째로 실으면 덮여도 마지막 파일이 곧 정답이라 유실이 개수를 틀리게 만들지 못한다.
+#
+# 직전 목록은 이 파일에서 읽는다(= 훅 호출 사이의 저장소). 그래서 상태 보고(running/done)에서도
+# 그대로 다시 실어 줘야 한다 — 안 실으면 다음 에이전트 이벤트가 빈 목록에서 시작한다.
+$agents = @()
+if ($prev -and $prev.agents) {
+    foreach ($a in @($prev.agents)) {
+        if ($a -and $a.id) {
+            $agents += , ([ordered]@{ id = [string]$a.id; type = [string]$a.type; at = [int64]$a.at })
+        }
+    }
+}
+if ($Subagent -and $hook -and $hook.agent_id) {
+    $aid = [string]$hook.agent_id
+    # 같은 id 는 먼저 빼고 — start 가 두 번 와도 하나, stop 은 빼기만 하면 된다
+    $agents = @($agents | Where-Object { $_.id -ne $aid })
+    if ($Subagent -eq 'start') {
+        $agents += , ([ordered]@{
+            id = $aid
+            type = [string]$hook.agent_type
+            at = [int64](([datetime]::UtcNow - [datetime]'1970-01-01').TotalMilliseconds)
+        })
+    }
+}
+# 빈 목록도 보낸다 — "마지막 하나가 끝났다" 를 말할 방법이 이것뿐이다.
+# 단 에이전트를 한 번도 본 적 없는 세션에서는 키 자체를 빼서, 훅이 개수를 안다고 주장하지 않는다
+# (플러그인은 이 키를 본 탭에서만 대화기록 폴백을 끈다)
+if ($Subagent -or $agents.Count -gt 0) {
+    $payload['agents'] = @($agents)
+}
 if ($pids.Count -gt 0) {
     $payload['pids'] = [int[]]$pids
     $payload['claudePid'] = $claudePid
@@ -246,8 +343,11 @@ if ($pids.Count -gt 0) {
 #
 # TCP 로 밀어 넣더라도 이 파일 쓰기는 건너뛰지 않는다 — 파일이 곧 상태 저장소라서
 # 다음 훅 호출이 여기서 직전 상태를 읽는다(위 $prevStatus). 그게 '승인대기 오탐 차단' 의 근거다.
-$json = $payload | ConvertTo-Json -Compress
-$tmp = "$file.tmp"
+# `-Depth` 를 명시한다 — 기본 2 는 `agents` 안의 객체를 `System.Collections.Specialized...` 문자열로
+# 뭉개 버린다(중첩 한 겹이 더 생겼다). 원소가 하나일 때 배열이 스칼라로 접히는 문제는 받는 쪽에서
+# 배열/단일을 모두 받아 푼다 — PowerShell 의 JSON 변환은 그 접힘을 끌 수 없다
+$json = $payload | ConvertTo-Json -Compress -Depth 5
+$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)

package/hooks/agentdeck-statusline.mjs

@@ -0,0 +1,351 @@
+/**
+ * Claude Code statusLine 을 한 겹 감싸서, 그 stdin JSON 을 AgentDeck 사이드바로 넘긴다.
+ *
+ * 왜 감싸나 — 모델·effort·컨텍스트%·5h/7d 한도% 는 **statusLine stdin 에만** 내려온다.
+ * 훅(JSON)에는 없고 대화기록(jsonl)에는 모델까지만 있다. 사이드바 하단의 "지금 이 탭" 줄이
+ * 원하는 값이 전부 여기 있으므로, 이미 걸려 있는 statusLine 명령 앞에 이 스크립트를 끼워
+ * 같은 stdin 을 그대로 흘려보내면서 한 벌 베껴 둔다.
+ *
+ * **이 스크립트의 첫 번째 계약은 "원래 statusLine 을 절대 죽이지 않는다" 이다.**
+ * statusLine 은 사용자가 매 렌더마다 보는 것이라, 우리가 실패해도 안쪽 명령의 출력은
+ * 그대로 나가야 한다. 그래서 베껴 쓰는 일은 전부 try/catch 로 감싸고, 종료코드도
+ * 안쪽 명령의 것을 그대로 쓴다. 안쪽이 없거나 못 띄우면 조용히 아무것도 출력하지 않는다
+ * (여기서 에러 문구를 뱉으면 그게 사용자의 statusLine 자리에 박힌다).
+ *
+ * 안쪽 명령은 설치할 때 `statusline-inner.json` 으로 옮겨 둔 **원래 설정 그대로**다
+ * (src/statusLine.ts). 체인 순서는 상관없다 — 이 스크립트는 stdin 을 바꾸지 않고
+ * stdout 을 건드리지 않으므로, 누가 우리를 또 감싸도 각 겹이 같은 JSON 을 본다.
+ */
+import * as fs from 'node:fs'
+import * as os from 'node:os'
+import * as path from 'node:path'
+import { spawn } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+import * as https from 'node:https'
+
+const ROOT = path.join(
+    process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local'),
+    'tabby-agentdeck',
+)
+/** 사이드바가 읽는 곳. 상태 보고(`status/`)와 폴더를 나눈다 — 그쪽 폴링은 자기 형식만 알아본다 */
+const META_DIR = path.join(ROOT, 'meta')
+const INNER_FILE = path.join(ROOT, 'statusline-inner.json')
+/** 모델별 주간 한도(Fable 등) 캐시 — stdin 에 없는 값이라 따로 물어본 것을 여기 둔다 */
+const SCOPED_FILE = path.join(ROOT, 'scoped-limit.json')
+/** 캐시를 낡았다고 보는 기준. statusLine 은 초 단위로 불리므로 매번 물어보면 안 된다 */
+const SCOPED_TTL_MS = 60_000
+/**
+ * **못 받았을 때는 더 오래 쉰다.**
+ *
+ * 실패는 대개 곧 풀리지 않는다 — 토큰이 없거나(API 키·게이트웨이), 그 요금제에 모델별 한도가
+ * 없거나, 레지스트리가 우리를 막은 경우다. 1분마다 두드리면 마지막 것은 **더 오래 막힌다**:
+ * 2026-09-15 실측으로 이 API 가 실제로 429 를 돌려줬다(앞서 캐시 도장이 없어 렌더마다
+ * 요청이 나가던 판의 결과다).
+ */
+const SCOPED_FAIL_TTL_MS = 10 * 60_000
+
+function readStdin () {
+    try {
+        // fd 0 을 통째로 읽는다. Claude Code 는 JSON 한 덩이를 주고 stdin 을 닫는다
+        return fs.readFileSync(0)
+    } catch {
+        return Buffer.alloc(0)
+    }
+}
+
+/**
+ * 계정 — statusLine stdin 에는 없다. 설정 파일에서 읽는다.
+ *
+ * `CLAUDE_CONFIG_DIR` 이 걸려 있으면 그 아래를 먼저 본다. 그 환경변수는 이 프로세스가
+ * claude 에서 그대로 물려받은 것이라, **탭마다 계정을 갈라 쓰는 경우에도 이 값이 맞다.**
+ * (`$CLAUDE_CONFIG_DIR/.claude.json` 위치는 근거 미확인이라 홈 폴더로 폴백한다.)
+ */
+function readAccount () {
+    const dirs = []
+    if (process.env.CLAUDE_CONFIG_DIR) {
+        dirs.push(process.env.CLAUDE_CONFIG_DIR)
+    }
+    dirs.push(os.homedir())
+    for (const dir of dirs) {
+        try {
+            const file = path.join(dir, '.claude.json')
+            const acc = JSON.parse(fs.readFileSync(file, 'utf8'))?.oauthAccount
+            if (acc?.emailAddress) {
+                return {
+                    account: String(acc.emailAddress),
+                    org: acc.organizationName ? String(acc.organizationName) : '',
+                    configDir: dir,
+                }
+            }
+        } catch {
+            // 없거나 아직 못 읽는다 — 다음 후보로
+        }
+    }
+    return { account: '', org: '', configDir: '' }
+}
+
+function pct (v) {
+    const n = Number(v)
+    return Number.isFinite(n) ? Math.round(n) : null
+}
+
+// ---------- 모델별 주간 한도 (Fable 등) ----------
+//
+// statusLine stdin 의 `rate_limits` 는 `five_hour` / `seven_day` 만 조립한다. 모델별 주간 한도
+// (내부명 `seven_day_overage_included`, 화면 이름 `Fable`)는 **거기 없다** — 진본은
+// `GET /api/oauth/usage` 의 `limits[]` 중 `kind=weekly_scoped` 다.
+//
+// 렌더를 막으면 안 되므로 **읽기는 캐시에서만** 한다. 캐시가 낡았으면 자기 자신을
+// `--refresh-scoped` 로 떼어 내 띄우고(detached), 이번 렌더는 낡은 값 그대로 쓴다.
+// 다음 렌더에 새 값이 들어온다 — statusLine 은 몇 초에 한 번씩 다시 불린다.
+
+/** OAuth 토큰 — 계정 파일과 같은 후보 폴더를 본다 (탭마다 계정을 갈라 써도 맞는다) */
+function readOauthToken () {
+    const dirs = []
+    if (process.env.CLAUDE_CONFIG_DIR) {
+        dirs.push(process.env.CLAUDE_CONFIG_DIR)
+    }
+    dirs.push(path.join(os.homedir(), '.claude'), os.homedir())
+    for (const dir of dirs) {
+        try {
+            const raw = fs.readFileSync(path.join(dir, '.credentials.json'), 'utf8')
+            const token = JSON.parse(raw)?.claudeAiOauth?.accessToken
+            if (token) {
+                return String(token)
+            }
+        } catch {
+            // 없거나 못 읽는다 — 다음 후보로
+        }
+    }
+    return ''
+}
+
+function readScopedCache () {
+    try {
+        return JSON.parse(fs.readFileSync(SCOPED_FILE, 'utf8'))
+    } catch {
+        return null
+    }
+}
+
+/** 캐시가 낡았으면 갱신을 떼어 낸다 — 부모(이 렌더)는 기다리지 않는다 */
+function armScopedRefresh (cache) {
+    // 직전이 실패였으면(`ok: false`) 더 길게 쉰다 — SCOPED_FAIL_TTL_MS 주석
+    const ttl = cache && cache.ok === false ? SCOPED_FAIL_TTL_MS : SCOPED_TTL_MS
+    if (cache && Date.now() - Number(cache.ts || 0) < ttl) {
+        return
+    }
+    try {
+        const child = spawn(process.execPath, [fileURLToPath(import.meta.url), '--refresh-scoped'], {
+            detached: true,
+            stdio: 'ignore',
+            env: { ...process.env, AGENTDECK_SL_DEPTH: '0' },
+        })
+        child.unref()
+    } catch {
+        // 못 띄우면 다음 렌더가 다시 시도한다
+    }
+}
+
+/**
+ * 실제로 물어보고 캐시에 남긴다 (`--refresh-scoped` 로 따로 뜬 프로세스에서만 돈다).
+ *
+ * `fetch` 가 아니라 `node:https` 를 쓴다 — undici 는 응답을 다 읽은 뒤에도 소켓을 쥐고 있어서,
+ * 다 쓰고 `process.exit` 하면 Windows 에서 libuv 가 죽는다 (실측: `Assertion failed:
+ * !(handle->flags & UV_HANDLE_CLOSING)`, rc 127). 여기서는 응답이 끝나면 이벤트 루프가
+ * 저절로 비어 프로세스가 정상 종료된다.
+ */
+function requestUsage (token) {
+    return new Promise((resolve, reject) => {
+        const req = https.request({
+            host: 'api.anthropic.com',
+            path: '/api/oauth/usage',
+            method: 'GET',
+            headers: {
+                'authorization': `Bearer ${token}`,
+                'anthropic-beta': 'oauth-2025-04-20',
+                'accept': 'application/json',
+            },
+            timeout: 10_000,
+        }, res => {
+            const chunks = []
+            res.on('data', c => chunks.push(c))
+            res.on('end', () => {
+                if (res.statusCode !== 200) {
+                    reject(new Error('http ' + res.statusCode))
+                    return
+                }
+                try {
+                    resolve(JSON.parse(Buffer.concat(chunks).toString('utf8')))
+                } catch (e) {
+                    reject(e)
+                }
+            })
+        })
+        req.on('timeout', () => req.destroy(new Error('timeout')))
+        req.on('error', reject)
+        req.end()
+    })
+}
+
+/**
+ * 갱신 결과를 캐시에 남긴다.
+ *
+ * **못 받았을 때도 반드시 부른다.** `armScopedRefresh` 는 "캐시가 있고 TTL 안" 일 때만 건너뛰는데,
+ * 실패했다고 아무것도 안 쓰면 캐시가 영원히 없어서 **statusLine 이 불릴 때마다**(초 단위)
+ * 새 프로세스가 뜬다 — 토큰이 없는 계정(API 키·게이트웨이)에서는 영영 성공하지 못하므로
+ * 그 상태가 계속된다 (2026-09-15 코드리뷰 지적).
+ */
+/**
+ * **실패해도 마지막 정상값은 지운다 — 가 아니라 지킨다.** 예전에는 실패하면 이름·퍼센트를 빈 값으로
+ * 덮어써서, 일시적 오류 한 번에 `Fable` 칸이 사라지고 실패 TTL(10분) 동안 빈 채로 있다가
+ * 다음 성공에서야 돌아왔다 (2026-09-16 실측: 10:28 실패 → 10:38 복귀, 사용자 "왜 안 나오다 또
+ * 나오나"). 몇 분 전 값이라도 빈 칸보다 낫다 — 한도는 분 단위로 크게 안 움직인다.
+ * 그래서 `scoped` 가 없으면 `prev` 의 이름·퍼센트·리셋 시각을 그대로 옮기고, 도장(`ts`)과
+ * 판정(`ok`)만 새로 찍는다. `ok:false` 는 여전히 재시도 간격을 가르는 데만 쓰인다.
+ *
+ * `err` 는 왜 비었는지 남기는 자리다 — 상태코드·타임아웃을 삼키면 이런 문제를 영영 못 찾는다.
+ */
+function writeScoped (scoped, prev, err) {
+    const name = scoped ? (scoped.scope?.model?.display_name ?? scoped.scope?.model?.id ?? '') : ''
+    // `resets_at` 은 여기서만 ISO 문자열이다 (stdin 쪽은 epoch 초) — 초로 맞춰 둔다
+    const resetsAt = scoped ? Math.round(Date.parse(scoped.resets_at ?? '') / 1000) || 0 : 0
+    const keep = !scoped && prev && prev.name ? prev : null
+    fs.mkdirSync(ROOT, { recursive: true })
+    const tmp = SCOPED_FILE + '.' + process.pid + '.tmp'
+    fs.writeFileSync(tmp, JSON.stringify({
+        ts: Date.now(),
+        // 다음 갱신 간격을 가르는 값 — 못 받았으면 오래 쉰다 (`armScopedRefresh`)
+        ok: !!scoped,
+        name: keep ? String(keep.name) : String(name),
+        pct: keep ? keep.pct : (scoped ? pct(scoped.percent) : null),
+        resetsAt: keep ? Number(keep.resetsAt) || 0 : resetsAt,
+        // 실패 사유 (성공이면 비운다). 값을 지킨 경우 `stale: true` 로 표시만 해 둔다
+        ...(scoped ? {} : { err: String(err ?? 'unknown'), stale: !!keep }),
+    }), 'utf8')
+    fs.renameSync(tmp, SCOPED_FILE)
+}
+
+async function refreshScoped () {
+    const prev = readScopedCache()
+    const token = readOauthToken()
+    if (!token) {
+        // 토큰이 없다 (로그인 안 함·API 키 사용) — 칸이 안 생길 뿐이지만 **도장은 찍는다**
+        writeScoped(null, prev, 'no-token')
+        return
+    }
+    let body
+    try {
+        body = await requestUsage(token)
+    } catch (e) {
+        // 네트워크·상태코드·타임아웃 — 마지막 정상값을 지키고 사유만 남긴다 (writeScoped 주석)
+        writeScoped(null, prev, e?.message || 'request-failed')
+        return
+    }
+    // 모델별 주간 한도는 여러 개일 수 있다 — 가장 많이 쓴 칸 하나만 보인다 (줄이 하나뿐이다)
+    const scoped = (Array.isArray(body?.limits) ? body.limits : [])
+        .filter(l => l?.kind === 'weekly_scoped')
+        .sort((a, b) => Number(b?.percent ?? 0) - Number(a?.percent ?? 0))[0]
+    // 모델별 한도가 없는 요금제도 있다 — 그때도 도장을 찍어야 다시 묻지 않는다.
+    // 이 경우는 실패가 아니라 "없다" 가 답이므로 옛 값을 지키지 않는다 (prev 를 안 넘긴다)
+    writeScoped(scoped ?? null, null, scoped ? undefined : 'no-scoped-limit')
+}
+
+/** stdin JSON 에서 사이드바가 쓸 것만 뽑는다 — 원문을 통째로 두면 대화 비용·경로까지 남는다 */
+function snapshot (data) {
+    const model = data.model ?? {}
+    const ctx = data.context_window ?? {}
+    const lim = data.rate_limits ?? {}
+    const { account, org, configDir } = readAccount()
+    const scoped = readScopedCache()
+    armScopedRefresh(scoped)
+    return {
+        sessionId: String(data.session_id ?? ''),
+        ts: Date.now(),
+        agent: 'claude',
+        model: String(model.display_name ?? model.id ?? ''),
+        modelId: String(model.id ?? ''),
+        effort: String(data.effort?.level ?? ''),
+        version: String(data.version ?? ''),
+        fastMode: !!data.fast_mode,
+        account,
+        org,
+        configDir,
+        cwd: String(data.cwd ?? data.workspace?.current_dir ?? ''),
+        contextPct: pct(ctx.used_percentage),
+        limits: {
+            fiveHourPct: pct(lim.five_hour?.used_percentage),
+            fiveHourResetsAt: Number(lim.five_hour?.resets_at) || 0,
+            sevenDayPct: pct(lim.seven_day?.used_percentage),
+            sevenDayResetsAt: Number(lim.seven_day?.resets_at) || 0,
+            scopedName: scoped?.name ?? '',
+            scopedPct: scoped?.pct ?? null,
+            scopedResetsAt: Number(scoped?.resetsAt) || 0,
+        },
+    }
+}
+
+function writeSnapshot (raw) {
+    const data = JSON.parse(raw.toString('utf8'))
+    const snap = snapshot(data)
+    if (!snap.sessionId) {
+        return // 누구 것인지 모르면 쓰지 않는다 — 사이드바가 세션 id 로만 탭에 묶는다
+    }
+    fs.mkdirSync(META_DIR, { recursive: true })
+    // 같은 파일을 사이드바가 400ms 마다 읽는다. 쓰다 만 파일을 읽히지 않도록 임시 파일 + rename
+    const file = path.join(META_DIR, snap.sessionId + '.json')
+    const tmp = file + '.' + process.pid + '.tmp'
+    fs.writeFileSync(tmp, JSON.stringify(snap), 'utf8')
+    fs.renameSync(tmp, file)
+}
+
+/** 원래 걸려 있던 statusLine 을 그대로 실행하고 stdout/stderr 을 넘겨준다 */
+function runInner (raw) {
+    let inner = null
+    try {
+        inner = JSON.parse(fs.readFileSync(INNER_FILE, 'utf8'))
+    } catch {
+        // 안쪽이 없다 = 원래 statusLine 이 없던 사용자다. 출력 없이 끝낸다
+    }
+    const command = inner && inner.type === 'command' ? String(inner.command ?? '') : ''
+    if (!command || command.includes('agentdeck-statusline')) {
+        // 우리 자신을 안쪽으로 두면 무한히 겹친다 — 설치가 꼬였을 때의 안전판
+        process.exit(0)
+    }
+    // 겹 세기. 남의 래퍼(원래 명령을 백업해 두는 종류)가 우리를 자기 안쪽에 넣어
+    // 버리면 `우리 -> 남 -> 우리 -> ...` 고리가 생긴다. 직접 검사(위 includes)로는 한 겹밖에
+    // 못 보므로, 물려주는 env 에 깊이를 실어 두 겹을 넘으면 조용히 멈춘다. 그 화면은
+    // statusLine 이 비어 보이지만(설치를 다시 하면 풀린다) 프로세스가 무한히 늘지는 않는다
+    const depth = Number(process.env.AGENTDECK_SL_DEPTH || 0) + 1
+    if (depth > 2) {
+        process.exit(0)
+    }
+    // stdout/stderr 은 그대로 물려준다(inherit) — 우리가 중계하면 버퍼 한 겹만 늘어난다
+    const child = spawn(command, {
+        shell: true,
+        stdio: ['pipe', 'inherit', 'inherit'],
+        env: { ...process.env, AGENTDECK_SL_DEPTH: String(depth) },
+    })
+    child.on('error', () => process.exit(0))
+    child.on('close', code => process.exit(code ?? 0))
+    child.stdin.on('error', () => { /* 안쪽이 stdin 을 안 읽고 끝냈다 — 정상 */ })
+    child.stdin.end(raw)
+}
+
+// 갱신 전용 실행 — 떼어 낸 프로세스가 여기로 들어온다. stdin 도 statusLine 도 건드리지 않는다
+if (process.argv.includes('--refresh-scoped')) {
+    // exit 을 부르지 않는다 — 응답이 끝나면 루프가 비어 저절로 끝난다 (requestUsage 주석)
+    refreshScoped().catch(() => {
+        // 네트워크·토큰 문제. **여기서도 도장을 찍는다** — 안 찍으면 TTL 게이트가 비어
+        // 렌더마다 새 프로세스가 뜬다 (writeScoped 주석)
+        try { writeScoped(null, readScopedCache(), 'unhandled') } catch { /* 디스크까지 막혔으면 할 수 있는 게 없다 */ }
+    })
+} else {
+    const raw = readStdin()
+    try {
+        writeSnapshot(raw)
+    } catch {
+        // 베끼기 실패는 사이드바 한 줄이 안 뜨는 것으로 끝난다. statusLine 은 계속 나가야 한다
+    }
+    runInner(raw)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tabby-agentdeck",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Run AI coding agents side by side in Tabby - a live deck of agent sessions with status, a preview panel for the files they touch, agent-friendly hotkeys and image paste",
   "keywords": [
     "tabby-plugin",
@@ -14,17 +14,25 @@
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
   "scripts": {
-    "build": "webpack --progress --color",
+    "build": "webpack --mode production",
+    "build:release": "node tools/sync-version.js && webpack --mode production --env release",
+    "prepack": "npm run build:release && node tools/check-release.js",
     "watch": "webpack --progress --color --watch",
-    "test": "tsc src/prompt.ts src/detect.ts src/claudeHooks.ts src/screen.ts src/bind.ts src/order.ts src/reason.ts src/tabenv.ts src/viewer.ts src/markdown.ts src/ime.ts src/gitDiff.ts src/agents.ts src/group.ts src/project-root.ts src/gitCommit.ts src/diag.ts src/subagents.ts src/nav.ts src/sessionLedger.ts src/update.ts src/api.ts src/dock.ts src/status.service.ts src/profile.service.ts src/recovery.service.ts --outDir .tmp --module commonjs --target es2019 --skipLibCheck --experimentalDecorators --esModuleInterop && node test/version.test.js && node test/prompt.test.js && node test/detect.test.js && node test/claudeHooks.test.js && node test/screen.test.js && node test/bind.test.js && node test/order.test.js && node test/reason.test.js && node test/tabenv.test.js && node test/viewer.test.js && node test/markdown.test.js && node test/ime.test.js && node test/gitDiff.test.js && node test/agents.test.js && node test/group.test.js && node test/gitCommit.test.js && node test/diag.test.js && node test/subagents.test.js && node test/nav.test.js && node test/sessionLedger.test.js && node test/update.test.js && node test/api.test.js && node test/dock.test.js && node test/status.service.test.js && node test/profile.service.test.js && node test/recovery.service.test.js",
+    "test": "npm run test:existing && npm run test:codex",
     "prebuild": "node tools/sync-version.js",
-    "sync-version": "node tools/sync-version.js"
+    "sync-version": "node tools/sync-version.js",
+    "release": "node tools/release.js",
+    "test:existing": "tsc src/codexHooks.ts src/i18n.ts src/prompt.ts src/detect.ts src/claudeHooks.ts src/screen.ts src/bind.ts src/order.ts src/reason.ts src/tabenv.ts src/viewer.ts src/markdown.ts src/ime.ts src/gitDiff.ts src/agents.ts src/group.ts src/project-root.ts src/gitCommit.ts src/diag.ts src/subagents.ts src/nav.ts src/keybind.ts src/sessionLedger.ts src/update.ts src/api.ts src/dock.ts src/status.service.ts src/profile.service.ts src/recovery.service.ts src/meta.ts src/statusLine.ts src/codexMeta.ts --outDir .tmp --module commonjs --target es2019 --skipLibCheck --experimentalDecorators --esModuleInterop && node test/version.test.js && node test/tags.test.js && node test/prompt.test.js && node test/detect.test.js && node test/claudeHooks.test.js && node test/screen.test.js && node test/bind.test.js && node test/order.test.js && node test/reason.test.js && node test/tabenv.test.js && node test/viewer.test.js && node test/markdown.test.js && node test/ime.test.js && node test/gitDiff.test.js && node test/agents.test.js && node test/group.test.js && node test/gitCommit.test.js && node test/diag.test.js && node test/subagents.test.js && node test/nav.test.js && node test/sessionLedger.test.js && node test/update.test.js && node test/api.test.js && node test/dock.test.js && node test/status.service.test.js && node test/profile.service.test.js && node test/recovery.service.test.js && node test/meta.test.js && node test/i18n.test.js && node test/statusLine.test.js && node test/hotkeys.test.js && node test/keybind.test.js && node test/codexMeta.test.js && node test/codexHooks.test.js",
+    "test:codex": "node test/regression.cjs && node test/resume.cjs && node test/cursor.cjs && node test/wheel.cjs",
+    "typecheck": "tsc --noEmit"
   },
   "files": [
     "dist",
     "hooks",
     "updater",
-    "install.ps1"
+    "install.ps1",
+    "CHANGELOG.md",
+    "README.ko.md"
   ],
   "license": "MIT",
   "devDependencies": {
@@ -33,6 +41,7 @@
     "@angular/forms": "^15.2.6",
     "@types/node": "^20.19.43",
     "@types/webpack-env": "^1.18.4",
+    "@xterm/headless": "^5.5.0",
     "css-loader": "^6.10.0",
     "rxjs": "^7.5.7",
     "sass": "^1.71.1",
@@ -49,5 +58,13 @@
   },
   "author": {
     "name": "junggon"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jghwang2/tabby-agentdeck.git"
+  },
+  "homepage": "https://jghwang2.github.io/tabby-agentdeck/",
+  "bugs": {
+    "url": "https://github.com/jghwang2/tabby-agentdeck/issues"
   }
 }