devez-vibe 1.9.56 → 1.9.58

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Devez Vibe contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Devez Vibe contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,73 +1,73 @@
-# Devez Vibe
-
-공식 `codex app-server`와 Claude Agent SDK를 위한 차분한 터미널 클라이언트입니다.
-각 공식 런타임이 인증·도구·스킬·프로젝트 지침을 담당하고, 이 프로젝트는 공통 화면과
-입력 계층을 소유합니다.
-
-## 설치
-
-```powershell
-npm install -g devez-vibe
-```
-
-설치하면 `dvz` 명령을 사용할 수 있습니다.
-
-| 요건 | 값 |
-| --- | --- |
-| OS | Windows x64 |
-| Node.js | 18 이상 (Claude Agent SDK 런타임 포함) |
-| Codex 전제 | Codex CLI 설치 및 로그인 완료 |
-| Claude 전제 | Claude Code 설치 후 `claude` 구독 로그인 완료 |
-
-현재 Windows x64 빌드만 배포합니다. 다른 플랫폼에서는 `EBADPLATFORM`으로 설치가 거부됩니다.
-
-## 사용
-
-Codex CLI가 설치되고 로그인된 환경에서:
-
-```powershell
-dvz
-```
-
-개인 Claude 구독 로그인 재사용:
-
-```powershell
-dvz --model claude
-dvz --model sonnet --effort high
-```
-
-Claude SDK 자식 프로세스는 API 키 환경변수를 제거하고 설치된 Claude Code 로그인만 사용합니다.
-본인 계정의 로컬 개인 사용만 대상으로 하며 로그인 공유나 제3자 인증은 제공하지 않습니다.
-
-주요 옵션:
-
-```text
-dvz [--resume [SESSION] | --continue] [--model MODEL] [--effort EFFORT]
-    [--cwd PATH] [--codex PATH] [--claude PATH] [--theme THEME]
-```
-
-`--resume`만 입력하면 검색 가능한 세션 피커를 열고, `--continue`는 현재 폴더의 가장 최근
-세션을 바로 이어갑니다. 실행 중 전체 명령은 `/help`에서 확인합니다.
-
-설치 상태와 제공자 연결 준비 상태는 다음 명령으로 점검합니다.
-
-```powershell
-dvz doctor
-```
-
-## 업데이트
-
-새 버전이 배포되면 시작 시 안내 배너가 표시됩니다. 배너의 안내대로 실행하면 됩니다.
-
-```powershell
-dvz update
-```
-
-새 버전을 별도 경로에 내려받아 실행 파일을 검증한 뒤 다음 실행 버전으로 전환합니다.
-실행 중인 `dvz` 세션은 이전 버전을 유지하고, 새로 시작하는 세션부터 새 버전을 사용합니다.
-
-업데이트 확인을 끄려면 `DEVEZ_VIBE_NO_UPDATE_CHECK` 환경변수를 설정합니다.
-
-## 라이선스
-
-MIT. 자세한 내용은 [저장소](https://github.com/MrHoje/Devez-vibe)를 참고하세요.
+# Devez Vibe
+
+공식 `codex app-server`와 Claude Agent SDK를 위한 차분한 터미널 클라이언트입니다.
+각 공식 런타임이 인증·도구·스킬·프로젝트 지침을 담당하고, 이 프로젝트는 공통 화면과
+입력 계층을 소유합니다.
+
+## 설치
+
+```powershell
+npm install -g devez-vibe
+```
+
+설치하면 `dvz` 명령을 사용할 수 있습니다.
+
+| 요건 | 값 |
+| --- | --- |
+| OS | Windows x64 |
+| Node.js | 18 이상 (Claude Agent SDK 런타임 포함) |
+| Codex 전제 | Codex CLI 설치 및 로그인 완료 |
+| Claude 전제 | Claude Code 설치 후 `claude` 구독 로그인 완료 |
+
+현재 Windows x64 빌드만 배포합니다. 다른 플랫폼에서는 `EBADPLATFORM`으로 설치가 거부됩니다.
+
+## 사용
+
+Codex CLI가 설치되고 로그인된 환경에서:
+
+```powershell
+dvz
+```
+
+개인 Claude 구독 로그인 재사용:
+
+```powershell
+dvz --model claude
+dvz --model sonnet --effort high
+```
+
+Claude SDK 자식 프로세스는 API 키 환경변수를 제거하고 설치된 Claude Code 로그인만 사용합니다.
+본인 계정의 로컬 개인 사용만 대상으로 하며 로그인 공유나 제3자 인증은 제공하지 않습니다.
+
+주요 옵션:
+
+```text
+dvz [--resume [SESSION] | --continue] [--model MODEL] [--effort EFFORT]
+    [--cwd PATH] [--codex PATH] [--claude PATH] [--theme THEME]
+```
+
+`--resume`만 입력하면 검색 가능한 세션 피커를 열고, `--continue`는 현재 폴더의 가장 최근
+세션을 바로 이어갑니다. 실행 중 전체 명령은 `/help`에서 확인합니다.
+
+설치 상태와 제공자 연결 준비 상태는 다음 명령으로 점검합니다.
+
+```powershell
+dvz doctor
+```
+
+## 업데이트
+
+새 버전이 배포되면 시작 시 안내 배너가 표시됩니다. 배너의 안내대로 실행하면 됩니다.
+
+```powershell
+dvz update
+```
+
+새 버전을 별도 경로에 내려받아 실행 파일을 검증한 뒤 다음 실행 버전으로 전환합니다.
+실행 중인 `dvz` 세션은 이전 버전을 유지하고, 새로 시작하는 세션부터 새 버전을 사용합니다.
+
+업데이트 확인을 끄려면 `DEVEZ_VIBE_NO_UPDATE_CHECK` 환경변수를 설정합니다.
+
+## 라이선스
+
+MIT. 자세한 내용은 [저장소](https://github.com/MrHoje/Devez-vibe)를 참고하세요.

package/bin/dvz.js

@@ -1,35 +1,35 @@
-#!/usr/bin/env node
-
-import { existsSync, readFileSync } from "node:fs";
-import { spawn } from "node:child_process";
-import { dirname, isAbsolute, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const packageExecutable = join(dirname(fileURLToPath(import.meta.url)), "dvz.exe");
-const pointer = process.env.LOCALAPPDATA
-  ? join(process.env.LOCALAPPDATA, "DevezVibe", "current-executable.txt")
-  : "";
-
-let executable = packageExecutable;
-try {
-  const candidate = pointer ? readFileSync(pointer, "utf8").trim() : "";
-  if (isAbsolute(candidate) && existsSync(candidate)) executable = candidate;
-} catch {
-  // A missing or incomplete pointer falls back to the npm-packaged executable.
-}
-
-const child = spawn(executable, process.argv.slice(2), { stdio: "inherit" });
-child.on("error", (error) => {
-  console.error(`Devez Vibe 실행 실패: ${error.message}`);
-  process.exit(1);
-});
-child.on("exit", (code, signal) => {
-  if (signal) process.kill(process.pid, signal);
-  else process.exit(code ?? 1);
-});
-
-for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
-  process.on(signal, () => {
-    if (!child.killed) child.kill(signal);
-  });
-}
+#!/usr/bin/env node
+
+import { existsSync, readFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { dirname, isAbsolute, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const packageExecutable = join(dirname(fileURLToPath(import.meta.url)), "dvz.exe");
+const pointer = process.env.LOCALAPPDATA
+  ? join(process.env.LOCALAPPDATA, "DevezVibe", "current-executable.txt")
+  : "";
+
+let executable = packageExecutable;
+try {
+  const candidate = pointer ? readFileSync(pointer, "utf8").trim() : "";
+  if (isAbsolute(candidate) && existsSync(candidate)) executable = candidate;
+} catch {
+  // A missing or incomplete pointer falls back to the npm-packaged executable.
+}
+
+const child = spawn(executable, process.argv.slice(2), { stdio: "inherit" });
+child.on("error", (error) => {
+  console.error(`Devez Vibe 실행 실패: ${error.message}`);
+  process.exit(1);
+});
+child.on("exit", (code, signal) => {
+  if (signal) process.kill(process.pid, signal);
+  else process.exit(code ?? 1);
+});
+
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(signal, () => {
+    if (!child.killed) child.kill(signal);
+  });
+}

package/bridge/claude-agent-sdk-bridge.mjs

@@ -749,6 +749,8 @@ function makeOptions(params, sessionId, resume) {
     // DevezVibe keeps per-task controls available through Claude's TaskStop
     // tool, so a turn interrupt must not tear down independent background work.
     perTaskStopAffordance: true,
+    // 순정처럼 하위 에이전트 줄의 설명을 약 30초마다 진행 요약으로 바꾼다.
+    agentProgressSummaries: true,
     systemPrompt: {
       type: "preset",
       preset: "claude_code",
@@ -2665,6 +2667,7 @@ function keepBackgroundSubagent(session, toolUseId, result) {
   }
   if (running.taskId) {
     session.knownSubagents.set(running.taskId, {
+      rowId: running.id,
       name: running.name,
       description: running.description,
       backgroundTask: running.backgroundTask === true,
@@ -2756,14 +2759,16 @@ function upsertStructuredSubagent(session, message) {
   if (!running && !subagentType && !isSubagentTaskType(message.task_type)) return null;
   if (!running) {
     const known = taskId ? session.knownSubagents.get(taskId) : null;
-    const id = toolUseId || `task:${taskId}`;
+    // 백그라운드 명령이 끝나 SDK가 같은 작업을 다시 돌리면, 끝난 줄과 같은 id·이름·설명으로
+    // 이어 붙여 설명 없는 새 줄이 따로 서지 않게 한다.
+    const id = known?.rowId || toolUseId || `task:${taskId}`;
     running = {
       id,
       toolUseId,
       taskId,
-      background: false,
-      name: subagentType || known?.name || "agent",
-      description: "",
+      background: message.is_backgrounded === true,
+      name: known?.name || subagentType || "agent",
+      description: known?.description || "",
       tool: "",
       startedAt: Date.now(),
       lastSeenAt: Date.now(),
@@ -2782,6 +2787,7 @@ function upsertStructuredSubagent(session, message) {
   running.lastSeenAt = Date.now();
   if (running.taskId) {
     session.knownSubagents.set(running.taskId, {
+      rowId: running.id,
       name: running.name,
       description: running.description,
       backgroundTask: running.backgroundTask === true,
@@ -2790,6 +2796,10 @@ function upsertStructuredSubagent(session, message) {
   return running;
 }
 
+function hasLiveChildren(session, taskId) {
+  return !!taskId && [...session.subagents.values()].some((agent) => agent.parentTaskId === taskId);
+}
+
 function finishStructuredSubagent(session, message) {
   const taskId = firstLine(message.task_id || "", 80);
   const toolUseId = firstLine(message.tool_use_id || "", 80);
@@ -2803,6 +2813,8 @@ function finishStructuredSubagent(session, message) {
   const running = (toolUseId && findSubagent(session, toolUseId))
     || (taskId && findSubagent(session, taskId));
   if (!running) return wasHidden;
+  // 자기 백그라운드 명령을 기다리며 멈춘 에이전트는 그 명령이 끝나면 다시 돌므로 행을 남긴다.
+  if (hasLiveChildren(session, running.taskId)) return true;
   session.subagents.delete(running.id);
   emitSubagents(session);
   return true;
@@ -2827,7 +2839,8 @@ function syncBackgroundSubagents(session, tasks) {
       changed = true;
       continue;
     }
-    if (!running.background || !running.taskId || liveIds.has(running.taskId)) continue;
+    if (!running.background || !running.taskId || liveIds.has(running.taskId)
+      || live.some((task) => task?.parent_task_id === running.taskId)) continue;
     session.subagents.delete(id);
     changed = true;
   }
@@ -2838,12 +2851,12 @@ function syncBackgroundSubagents(session, tasks) {
     const known = session.knownSubagents.get(taskId);
     if (!running) {
       running = {
-        id: `task:${taskId}`,
+        id: known?.rowId || `task:${taskId}`,
         toolUseId: "",
         taskId,
         background: true,
         name: known?.name || backgroundTaskName(task?.task_type),
-        description: "",
+        description: known?.description || "",
         tool: "",
         command: !isSubagentTaskType(task?.task_type),
         // 셸로 띄운 위임 에이전트도 있으므로 command와 별도로 표시 종류를 보존한다.
@@ -2902,6 +2915,8 @@ function processSubagentSystemMessage(session, message) {
     if (!running) return false;
     const tool = firstLine(message.last_tool_name || "", 80);
     if (tool) running.tool = tool;
+    const summary = firstLine(message.summary || "", SUBAGENT_DESCRIPTION_LIMIT);
+    if (summary) running.description = summary;
     emitSubagents(session);
     return true;
   }
@@ -3059,6 +3074,8 @@ function emitSubagents(session) {
     turnId: session.turn?.id,
     subagents: subagentRows(session).map(({ agent, depth }) => ({
       id: agent.id,
+      // 스냅숏 자리표시자가 Agent 행에 접혀 사라져도 화면이 끝난 줄로 남기지 않게 한다.
+      taskId: agent.taskId || "",
       name: agent.name,
       description: agent.description,
       backgroundTask: agent.backgroundTask === true,
@@ -6069,7 +6086,8 @@ async function runSelfTest() {
       summary: "Reading lifecycle source",
     });
     const structured = structuredSession.subagents.get("toolu_structured");
-    if (!structured?.background || structured.tool !== "Read" || structured.backgroundTask === true) {
+    if (!structured?.background || structured.tool !== "Read" || structured.backgroundTask === true
+      || structured.description !== "Reading lifecycle source") {
       throw new Error(`Claude structured task progress self-test failed: ${JSON.stringify(structured)}`);
     }
     processSubagentSystemMessage(structuredSession, {
@@ -6142,6 +6160,51 @@ async function runSelfTest() {
       throw new Error("Claude subagent agent_id self-test failed");
     }
     clearSubagents(nestedSession);
+    // 자기 백그라운드 명령을 기다리며 멈춘 에이전트는 그 명령이 도는 동안 행을 지킨다.
+    processSubagentSystemMessage(nestedSession, {
+      type: "system",
+      subtype: "task_started",
+      task_id: "agent-wait",
+      tool_use_id: "toolu_wait",
+      task_type: "local_agent",
+      subagent_type: "general-purpose",
+    });
+    nestedSession.subagents.get("toolu_wait").background = true;
+    const waitSnapshot = (tasks) => processSubagentSystemMessage(nestedSession, {
+      type: "system",
+      subtype: "background_tasks_changed",
+      tasks,
+    });
+    waitSnapshot([{ task_id: "shell-wait", task_type: "local_bash", description: "sleep 300", parent_task_id: "agent-wait" }]);
+    processSubagentSystemMessage(nestedSession, {
+      type: "system",
+      subtype: "task_notification",
+      task_id: "agent-wait",
+      status: "completed",
+    });
+    const waitingKept = nestedSession.subagents.has("toolu_wait");
+    waitSnapshot([]);
+    if (!waitingKept || nestedSession.subagents.size !== 0) {
+      throw new Error(`Claude waiting subagent self-test failed: ${waitingKept} ${nestedSession.subagents.size}`);
+    }
+    clearSubagents(nestedSession);
+    // 끝난 뒤 SDK가 같은 작업을 다시 돌리면 설명 없는 새 줄이 아니라 같은 줄로 돌아온다.
+    startSubagent(nestedSession, { id: "toolu_again", input: { description: "3분 대기", subagent_type: "general-purpose" } });
+    keepBackgroundSubagent(nestedSession, "toolu_again", { isAsync: true, agentId: "agent-again" });
+    waitSnapshot([]);
+    processSubagentSystemMessage(nestedSession, {
+      type: "system",
+      subtype: "task_started",
+      task_id: "agent-again",
+      task_type: "local_agent",
+      subagent_type: "general-purpose",
+      is_backgrounded: true,
+    });
+    const again = [...nestedSession.subagents.values()];
+    if (again.length !== 1 || again[0].id !== "toolu_again" || again[0].description !== "3분 대기") {
+      throw new Error(`Claude resumed subagent row self-test failed: ${JSON.stringify(again)}`);
+    }
+    clearSubagents(nestedSession);
 
     processSubagentSystemMessage(structuredSession, {
       type: "system",

package/install-skills.mjs

@@ -1,18 +1,18 @@
 import {
   copyFileSync,
   existsSync,
-  mkdirSync,
-  readdirSync,
-  rmSync,
-  writeFileSync,
-} from "node:fs";
+  mkdirSync,
+  readdirSync,
+  rmSync,
+  writeFileSync,
+} from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const packageRoot = dirname(fileURLToPath(import.meta.url));
-const skillNames = ["luna-loop", "insane-search"];
-const bundledMarker = ".devez-vibe-bundled-skill";
+const skillNames = ["luna-loop", "insane-search"];
+const bundledMarker = ".devez-vibe-bundled-skill";
 const userHome = homedir();
 const codexHome = process.env.CODEX_HOME?.trim() || join(userHome, ".codex");
 const claudeHome = process.env.CLAUDE_CONFIG_DIR?.trim() || join(userHome, ".claude");
@@ -61,10 +61,10 @@ for (const skill of skillNames) {
   for (const home of homes) {
     const target = join(home.root, skill);
     try {
-      copyTree(sourceRoot, target);
-      pruneTree(sourceRoot, target);
-      writeFileSync(join(target, bundledMarker), `${skill}\n`, "utf8");
-      console.log(`스킬 설치 완료 (${home.name}/${skill}): ${target}`);
+      copyTree(sourceRoot, target);
+      pruneTree(sourceRoot, target);
+      writeFileSync(join(target, bundledMarker), `${skill}\n`, "utf8");
+      console.log(`스킬 설치 완료 (${home.name}/${skill}): ${target}`);
     } catch (error) {
       failed = true;
       console.error(`스킬 설치 실패 (${home.name}/${skill}): ${error instanceof Error ? error.message : error}`);

package/package.json

@@ -1,50 +1,50 @@
-{
-  "name": "devez-vibe",
-  "version": "1.9.56",
-  "type": "module",
-  "description": "Stable terminal UI for Codex and Claude Agent SDK",
-  "keywords": [
-    "codex",
-    "cli",
-    "tui",
-    "terminal",
-    "app-server",
-    "claude-agent-sdk"
-  ],
-  "homepage": "https://github.com/MrHoje/Devez-vibe#readme",
-  "bugs": "https://github.com/MrHoje/Devez-vibe/issues",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MrHoje/Devez-vibe.git"
-  },
-  "license": "MIT",
-  "bin": {
-    "dvz": "bin/dvz.js"
-  },
-  "files": [
-    "bin/dvz.js",
-    "bin/dvz.exe",
-    "bridge/claude-agent-sdk-bridge.mjs",
-    "install-skills.mjs",
-    "prepare-search-deps.mjs",
-    "skills/luna-loop/",
-    "skills/insane-search/",
-    "README.md",
-    "LICENSE"
-  ],
-  "os": [
-    "win32"
-  ],
-  "cpu": [
-    "x64"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "postinstall": "node install-skills.mjs && node prepare-search-deps.mjs"
-  },
-  "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.3.296"
-  }
-}
+{
+  "name": "devez-vibe",
+  "version": "1.9.58",
+  "type": "module",
+  "description": "Stable terminal UI for Codex and Claude Agent SDK",
+  "keywords": [
+    "codex",
+    "cli",
+    "tui",
+    "terminal",
+    "app-server",
+    "claude-agent-sdk"
+  ],
+  "homepage": "https://github.com/MrHoje/Devez-vibe#readme",
+  "bugs": "https://github.com/MrHoje/Devez-vibe/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MrHoje/Devez-vibe.git"
+  },
+  "license": "MIT",
+  "bin": {
+    "dvz": "bin/dvz.js"
+  },
+  "files": [
+    "bin/dvz.js",
+    "bin/dvz.exe",
+    "bridge/claude-agent-sdk-bridge.mjs",
+    "install-skills.mjs",
+    "prepare-search-deps.mjs",
+    "skills/luna-loop/",
+    "skills/insane-search/",
+    "README.md",
+    "LICENSE"
+  ],
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "postinstall": "node install-skills.mjs && node prepare-search-deps.mjs"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.296"
+  }
+}

package/prepare-search-deps.mjs

@@ -1,42 +1,42 @@
-// insane-search 스킬이 첫 호출에서 받는 파이썬 패키지를 설치 시점에 미리 깔아 둔다.
-// 준비는 어디까지나 선택적이다. 파이썬이 없거나 설치가 실패해도 안내만 남기고 정상 종료해서
-// devezVibe 설치 자체가 깨지지 않게 한다. 스킬은 첫 사용 때 다시 설치를 시도하므로 손해가 없다.
-import { spawnSync } from "node:child_process";
-
-// SKILL.md의 의존성 가드와 같은 조합이다. 한쪽만 바뀌면 첫 호출에서 다시 설치가 돈다.
-const guard = 'import curl_cffi,bs4,yaml,pypdf,markdownify; v=curl_cffi.__version__.split("."); assert (int(v[0]),int(v[1]))>=(0,15)';
-const packages = ["curl_cffi>=0.15.0", "beautifulsoup4", "pyyaml", "pypdf", "markdownify"];
-
-function run(command, args) {
-  return spawnSync(command, args, { encoding: "utf8", windowsHide: true, timeout: 300000 });
-}
-
-// Windows에는 python3가 없는 대신 실행하면 스토어를 여는 별칭이 잡혀 있을 수 있다.
-// 버전 출력을 실제로 확인해서 쓸 수 있는 실행기만 고른다.
-function findPython() {
-  for (const candidate of ["python3", "python", "py"]) {
-    const probe = run(candidate, ["-c", "import sys; print(sys.version_info[0])"]);
-    if (probe.status === 0 && probe.stdout.trim() === "3") return candidate;
-  }
-  return null;
-}
-
-const python = findPython();
-if (!python) {
-  console.log("insane-search 준비 건너뜀: 파이썬 3을 찾지 못했습니다. 설치하면 첫 사용 때 자동으로 준비됩니다.");
-  process.exit(0);
-}
-
-if (run(python, ["-c", guard]).status === 0) {
-  console.log("insane-search 의존성 준비 완료: 이미 설치되어 있습니다.");
-  process.exit(0);
-}
-
-// --user는 관리자 권한 없이도 설치되게 하고, 가상환경에서는 pip가 알아서 무시한다.
-const install = run(python, ["-m", "pip", "install", "-U", "--user", "-q", ...packages]);
-if (install.status === 0 && run(python, ["-c", guard]).status === 0) {
-  console.log("insane-search 의존성 준비 완료");
-} else {
-  const detail = (install.stderr || install.stdout || "").trim().split("\n").pop() || "원인 미상";
-  console.log(`insane-search 준비 건너뜀 (${detail}). 첫 사용 때 다시 시도합니다.`);
-}
+// insane-search 스킬이 첫 호출에서 받는 파이썬 패키지를 설치 시점에 미리 깔아 둔다.
+// 준비는 어디까지나 선택적이다. 파이썬이 없거나 설치가 실패해도 안내만 남기고 정상 종료해서
+// devezVibe 설치 자체가 깨지지 않게 한다. 스킬은 첫 사용 때 다시 설치를 시도하므로 손해가 없다.
+import { spawnSync } from "node:child_process";
+
+// SKILL.md의 의존성 가드와 같은 조합이다. 한쪽만 바뀌면 첫 호출에서 다시 설치가 돈다.
+const guard = 'import curl_cffi,bs4,yaml,pypdf,markdownify; v=curl_cffi.__version__.split("."); assert (int(v[0]),int(v[1]))>=(0,15)';
+const packages = ["curl_cffi>=0.15.0", "beautifulsoup4", "pyyaml", "pypdf", "markdownify"];
+
+function run(command, args) {
+  return spawnSync(command, args, { encoding: "utf8", windowsHide: true, timeout: 300000 });
+}
+
+// Windows에는 python3가 없는 대신 실행하면 스토어를 여는 별칭이 잡혀 있을 수 있다.
+// 버전 출력을 실제로 확인해서 쓸 수 있는 실행기만 고른다.
+function findPython() {
+  for (const candidate of ["python3", "python", "py"]) {
+    const probe = run(candidate, ["-c", "import sys; print(sys.version_info[0])"]);
+    if (probe.status === 0 && probe.stdout.trim() === "3") return candidate;
+  }
+  return null;
+}
+
+const python = findPython();
+if (!python) {
+  console.log("insane-search 준비 건너뜀: 파이썬 3을 찾지 못했습니다. 설치하면 첫 사용 때 자동으로 준비됩니다.");
+  process.exit(0);
+}
+
+if (run(python, ["-c", guard]).status === 0) {
+  console.log("insane-search 의존성 준비 완료: 이미 설치되어 있습니다.");
+  process.exit(0);
+}
+
+// --user는 관리자 권한 없이도 설치되게 하고, 가상환경에서는 pip가 알아서 무시한다.
+const install = run(python, ["-m", "pip", "install", "-U", "--user", "-q", ...packages]);
+if (install.status === 0 && run(python, ["-c", guard]).status === 0) {
+  console.log("insane-search 의존성 준비 완료");
+} else {
+  const detail = (install.stderr || install.stdout || "").trim().split("\n").pop() || "원인 미상";
+  console.log(`insane-search 준비 건너뜀 (${detail}). 첫 사용 때 다시 시도합니다.`);
+}