jutell 1.0.1 → 2.0.0

package/assets/templates/request-builder/README.md

@@ -1,48 +1,48 @@
-# Request Builder — 요청 만들기 템플릿
-
-## 이 폴더는 무엇인가요?
-
-막연한 요구를 AI Agent가 이해할 수 있는 요청서로 바꾸는 Markdown 템플릿 모음입니다.
-
-JuTell은 Agent를 대신 실행하거나 Prompt를 자동으로 보내지 않습니다. 완성된 요청문을 복사해서 사용 중인 AI Agent(Codex, Claude Code, OpenCode 등)에 직접 붙여넣으면 됩니다.
-
-## 사용 방법 (3단계)
-
-1. 하고 싶은 일과 가장 가까운 템플릿을 고릅니다.
-2. `[ ]` 선택지에 체크하고, 빈칸에는 쉬운 말로 적습니다. 모르는 항목은 **비워 둡니다.**
-3. 맨 아래 **최종 요청문**을 복사해 AI Agent에 붙여넣습니다.
-
-## 템플릿 목록
-
-| 템플릿 | 언제 사용하나요? |
-|---|---|
-| [DESIGN_REQUEST.md](DESIGN_REQUEST.md) | 화면 모양이나 분위기를 바꾸고 싶을 때 |
-| [FEATURE_REQUEST.md](FEATURE_REQUEST.md) | 새로운 기능이나 화면을 만들고 싶을 때 |
-| [BUG_REPORT_REQUEST.md](BUG_REPORT_REQUEST.md) | 무언가 고장 났거나 이상하게 동작할 때 |
-| [PROJECT_PLANNING_REQUEST.md](PROJECT_PLANNING_REQUEST.md) | 프로젝트 전체를 처음 계획할 때 |
-| [CODE_REVIEW_REQUEST.md](CODE_REVIEW_REQUEST.md) | 만든 작업을 검토받고 싶을 때 |
-| [NEXT_AGENT_HANDOFF.md](NEXT_AGENT_HANDOFF.md) | 다른 AI Agent에게 작업을 넘길 때 |
-| [MANUAL_EDIT_GUIDE.md](MANUAL_EDIT_GUIDE.md) | 직접 파일을 수정해야 할 때 |
-
-## 공통 선택지 의미
-
-- **잘 모르겠음** — 해당 항목을 모르며 AI의 도움을 원합니다.
-- **정확히 무엇이 문제인지 모르겠음** — 문제는 느끼지만 원인을 특정하지 못합니다.
-- **현재 상태 유지** — 이 부분은 지금 그대로 두길 원합니다.
-- **요청하지 않음** — 이 항목은 다루지 않길 원합니다.
-- **AI가 먼저 확인 후 제안** — 답을 추측하지 말고 먼저 확인한 뒤 선택지를 제안해달라는 뜻입니다.
-
-## 작성 원칙
-
-- 전문 용어, 색상 코드(Hex), CSS, Framework 이름을 몰라도 됩니다. 그런 용어가 필요한 항목은 선택지로 고르거나 `잘 모르겠음`으로 두면 됩니다.
-- **모르는 항목은 추측해서 채우지 않습니다.** 빈칸은 AI가 요청서를 읽고 질문해야 할 항목으로 남습니다.
-- **사용자가 직접 쓴 사실과 AI의 제안은 구분해서 표시합니다.**
-
-## 프로젝트 경로 안내 주의
-
-템플릿 안에 "파일은 `src/css/`에 있음", "`npm run dev`로 실행함" 같은 내용을 임의로 채우면 안 됩니다. 실제 프로젝트 구조를 확인하기 전에는 특정 경로나 실행 명령을 확정해 적지 않고, 모르면 `확인 필요`로 남깁니다. AI가 먼저 프로젝트를 확인한 뒤 안내하도록 유도하는 것이 이 템플릿의 목적입니다.
-
-## 요청하기 전에
-
-- 비밀번호, API 키, 토큰, 실제 개인정보는 요청서에 적지 않습니다.
-- 기밀 프로젝트 이름이나 저장소 주소가 필요하다면 `내용 요약`만 적습니다.
+# Request Builder — 요청 만들기 템플릿
+
+## 이 폴더는 무엇인가요?
+
+막연한 요구를 AI Agent가 이해할 수 있는 요청서로 바꾸는 Markdown 템플릿 모음입니다.
+
+JuTell은 Agent를 대신 실행하거나 Prompt를 자동으로 보내지 않습니다. 완성된 요청문을 복사해서 사용 중인 AI Agent(Codex, Claude Code, OpenCode 등)에 직접 붙여넣으면 됩니다.
+
+## 사용 방법 (3단계)
+
+1. 하고 싶은 일과 가장 가까운 템플릿을 고릅니다.
+2. `[ ]` 선택지에 체크하고, 빈칸에는 쉬운 말로 적습니다. 모르는 항목은 **비워 둡니다.**
+3. 맨 아래 **최종 요청문**을 복사해 AI Agent에 붙여넣습니다.
+
+## 템플릿 목록
+
+| 템플릿 | 언제 사용하나요? |
+|---|---|
+| [DESIGN_REQUEST.md](DESIGN_REQUEST.md) | 화면 모양이나 분위기를 바꾸고 싶을 때 |
+| [FEATURE_REQUEST.md](FEATURE_REQUEST.md) | 새로운 기능이나 화면을 만들고 싶을 때 |
+| [BUG_REPORT_REQUEST.md](BUG_REPORT_REQUEST.md) | 무언가 고장 났거나 이상하게 동작할 때 |
+| [PROJECT_PLANNING_REQUEST.md](PROJECT_PLANNING_REQUEST.md) | 프로젝트 전체를 처음 계획할 때 |
+| [CODE_REVIEW_REQUEST.md](CODE_REVIEW_REQUEST.md) | 만든 작업을 검토받고 싶을 때 |
+| [NEXT_AGENT_HANDOFF.md](NEXT_AGENT_HANDOFF.md) | 다른 AI Agent에게 작업을 넘길 때 |
+| [MANUAL_EDIT_GUIDE.md](MANUAL_EDIT_GUIDE.md) | 직접 파일을 수정해야 할 때 |
+
+## 공통 선택지 의미
+
+- **잘 모르겠음** — 해당 항목을 모르며 AI의 도움을 원합니다.
+- **정확히 무엇이 문제인지 모르겠음** — 문제는 느끼지만 원인을 특정하지 못합니다.
+- **현재 상태 유지** — 이 부분은 지금 그대로 두길 원합니다.
+- **요청하지 않음** — 이 항목은 다루지 않길 원합니다.
+- **AI가 먼저 확인 후 제안** — 답을 추측하지 말고 먼저 확인한 뒤 선택지를 제안해달라는 뜻입니다.
+
+## 작성 원칙
+
+- 전문 용어, 색상 코드(Hex), CSS, Framework 이름을 몰라도 됩니다. 그런 용어가 필요한 항목은 선택지로 고르거나 `잘 모르겠음`으로 두면 됩니다.
+- **모르는 항목은 추측해서 채우지 않습니다.** 빈칸은 AI가 요청서를 읽고 질문해야 할 항목으로 남습니다.
+- **사용자가 직접 쓴 사실과 AI의 제안은 구분해서 표시합니다.**
+
+## 프로젝트 경로 안내 주의
+
+템플릿 안에 "파일은 `src/css/`에 있음", "`npm run dev`로 실행함" 같은 내용을 임의로 채우면 안 됩니다. 실제 프로젝트 구조를 확인하기 전에는 특정 경로나 실행 명령을 확정해 적지 않고, 모르면 `확인 필요`로 남깁니다. AI가 먼저 프로젝트를 확인한 뒤 안내하도록 유도하는 것이 이 템플릿의 목적입니다.
+
+## 요청하기 전에
+
+- 비밀번호, API 키, 토큰, 실제 개인정보는 요청서에 적지 않습니다.
+- 기밀 프로젝트 이름이나 저장소 주소가 필요하다면 `내용 요약`만 적습니다.

package/assets/version.json

@@ -1,5 +1,5 @@
 {
-  "cli": "1.0.1",
+  "cli": "2.0.0",
   "skill": "확인 필요",
   "mcp": "0.1.0",
   "admin": "0.1.0"

package/dist/commands/default.js

@@ -1,6 +1,6 @@
 import { stdin } from 'node:process';
 import { dashboardCommand } from './dashboard.js';
-import { enableCommand, setupCommand } from './lifecycle.js';
+import { enableCommand } from './lifecycle.js';
 import { getStatus } from './status.js';
 import { useCommand } from './use.js';
 import { AGENT_PROVIDERS } from '../installer/providers.js';
@@ -10,85 +10,144 @@ const profileLabels = {
     learning: '학습 보고',
     detailed: '상세 보고',
 };
-const profileChoices = [
-    { value: 'balanced', label: '균형 보고', note: '처음 사용에 적당한 기본값 (권장)' },
-    { value: 'minimal', label: '최소 보고', note: '핵심만 짧게' },
-    { value: 'learning', label: '학습 보고', note: '개발 용어를 조금 더 설명' },
-    { value: 'detailed', label: '상세 보고', note: '복잡한 작업을 자세히' },
-];
 function needsRepair(status) {
     return !status.configValid || !status.skillInstalled || !status.agentsManaged || status.codexPreparation !== 'enabled';
 }
 function readyMessage(status) {
     const ready = status.configValid && status.skillInstalled && status.agentsManaged && status.codexPreparation === 'enabled';
     if (!ready) {
-        return `JuTell 연결이 일부 준비되지 않았습니다.
-
-설정과 Skill을 확인했지만 AI Agent Provider 연결 준비가 완료되지 않았습니다.
+        return `JuTell 연결이 일부 준비되지 않았습니다.
+
+설정과 Skill을 확인했지만 AI Agent Provider 연결 준비가 완료되지 않았습니다.
 관리자 화면에서 현재 상태를 확인할 수 있습니다.`;
     }
-    return `JuTell 준비 완료
-
-✓ 설정 연결됨
-✓ Skill 연결됨
-✓ AI Agent 연결 준비 완료
-✓ 안전 보고 규칙 적용됨
-
-현재 보고 방식: ${profileLabels[status.profile]}
-활성 기능: ${status.activeFeatureCount}개
-
-새 AI Agent 세션부터 사용할 수 있습니다.
+    return `JuTell 준비 완료
+
+✓ 설정 연결됨
+✓ Skill 연결됨
+✓ AI Agent 연결 준비 완료
+✓ 안전 보고 규칙 적용됨
+
+현재 보고 방식: ${profileLabels[status.profile]}
+활성 기능: ${status.activeFeatureCount}개
+
+새 AI Agent 세션부터 사용할 수 있습니다.
 실제 도구 호출 여부는 해당 Provider에서 확인할 수 있습니다.`;
 }
-const firstRunMessage = `이 프로젝트에는 아직 JuTell이 연결되지 않았습니다.
-
-JuTell을 연결하면:
-- AI 작업을 쉬운 말로 보고받을 수 있습니다.
-- 현재 설정에 맞춰 보고 길이와 설명 방식을 조절할 수 있습니다.
-- 연결된 AI Agent에서 JuTell MCP를 사용할 수 있습니다.`;
-async function firstRunWizard(io) {
-    io.write(`Welcome to JuTell! 🎉
-
-AI가 한 일을 쉽게 이해하고, 검증하고, 다음 작업으로 이어가도록 돕습니다.
-몇 가지만 고르면 이 프로젝트에 연결을 준비합니다.
-`);
-    const agentChoices = AGENT_PROVIDERS.map((provider) => ({
-        value: provider.id,
-        label: provider.label,
-        note: provider.status === 'planned' ? '준비 중' : provider.description,
-    }));
-    let agent = 'codex';
-    while (true) {
-        const picked = await io.choose('① 사용 중인 AI Agent를 선택하세요.', agentChoices, 'codex');
-        const provider = AGENT_PROVIDERS.find((item) => item.id === picked);
-        if (provider && provider.status !== 'planned') {
-            agent = provider.id;
-            break;
+export function providerRuntimeStatuses(status) {
+    const byId = (id) => AGENT_PROVIDERS.find((provider) => provider.id === id);
+    const rows = [
+        ['codex', status.codexDetected, status.codexPreparation === 'enabled', status.codexPreparation === 'error'],
+        ['opencode', status.opencodeDetected, status.opencodePreparation === 'enabled', status.opencode.conflict],
+        ['claude-code', status.claudeDetected, status.claudePreparation === 'enabled', status.claude.conflict],
+    ];
+    return rows
+        .map(([id, detected, connected, conflict]) => {
+        const provider = byId(id);
+        return provider ? { provider, detected, connected, conflict } : undefined;
+    })
+        .filter((row) => row !== undefined);
+}
+function padLabel(label, width) {
+    return label + ' '.repeat(Math.max(1, width - label.length + 2));
+}
+const noProvidersMessage = `JuTell이 이 컴퓨터에서 지원하는 Coding Agent(Codex, OpenCode, Claude Code)를 찾지 못했습니다.
+
+Codex, OpenCode, Claude Code 중 하나를 설치한 뒤 'jutell'을 다시 실행해 주세요.
+이미 설치했다면 PATH에서 실행 파일을 찾을 수 있는지 'jutell doctor'로 확인해 주세요.`;
+function alreadyConfiguredMessage(statuses) {
+    const width = Math.max(...statuses.map((row) => row.provider.label.length));
+    const lines = statuses.map((row) => `${padLabel(row.provider.label, width)}${row.detected ? '연결됨' : '미감지'}`);
+    return `JuTell
+
+${lines.join('\n')}
+
+JuTell 준비 완료.
+
+명령 목록: jutell --help`;
+}
+// Printed once, after offerAutoConnect() finishes successfully, instead of auto-launching
+// the dashboard (see JUTELL-V1.X-AUTO-SETUP-FOUNDATION-01B - the user asked to connect,
+// not to open a browser/local-server session; `jutell dashboard` remains the explicit,
+// opt-in way to do that). Lists every currently-connected provider, not just the ones
+// connected in this run, so a partial-catch-up run still shows the full accurate picture.
+function connectedSummaryMessage(statuses) {
+    const connectedLines = statuses.filter((row) => row.connected).map((row) => `✓ ${row.provider.label} 연결됨`);
+    return `JuTell 준비 완료.
+
+${connectedLines.join('\n')}
+
+새 Coding Agent 세션을 열고 평소처럼 사용하세요.
+
+'jutell' — 상태/설정
+'jutell --help' — 명령어 보기`;
+}
+/**
+ * Multi-provider auto-detect-and-connect for bare `jutell`. Reuses the exact
+ * same per-provider detection (via getStatus, which already wraps
+ * codexDetected/opencodeDetected/claudeDetected) and the exact same atomic,
+ * idempotent, rollback-safe registration path `jutell use <provider>` already
+ * uses (useCommand) - this intentionally does not implement a second
+ * detection or registration system.
+ */
+export async function offerAutoConnect(paths, options, io, statuses) {
+    const detected = statuses.filter((row) => row.detected);
+    const toConnect = detected.filter((row) => !row.connected);
+    const offerable = toConnect.filter((row) => !row.conflict);
+    const conflicted = toConnect.filter((row) => row.conflict);
+    const width = Math.max(...statuses.map((row) => row.provider.label.length));
+    const foundList = statuses
+        .map((row) => `${padLabel(row.provider.label, width)}${row.detected ? (row.connected ? '찾음 (이미 연결됨)' : '찾음') : '미감지'}`)
+        .join('\n');
+    io.write(`JuTell\n\n찾은 Coding Agent:\n\n${foundList}`);
+    if (offerable.length === 0) {
+        if (conflicted.length) {
+            io.write(`\n주의: ${conflicted.map((row) => row.provider.label).join(', ')}에 관리되지 않는 기존 MCP 설정이 있어 자동으로 연결하지 않았습니다. 'jutell use <agent>'로 직접 확인해 주세요.`);
         }
-        io.write(`${provider?.label ?? '선택한 Agent'}는 아직 준비 중입니다. 지금 사용할 수 있는 Agent를 선택하세요.`);
+        return { cancelled: true };
     }
-    const profile = (await io.choose('② 보고 방식을 선택하세요. 나중에 언제든 바꿀 수 있습니다.', profileChoices, 'balanced'));
-    const agentLabel = AGENT_PROVIDERS.find((item) => item.id === agent)?.label ?? agent;
-    io.write(`\n③ 선택 완료: ${agentLabel} · ${profileLabels[profile]}\n연결을 준비합니다.\n`);
-    return { agent, profile };
-}
-export async function defaultCommand(paths, options, io) {
-    let status = await getStatus(paths);
-    if (!status.configExists) {
-        if (options.yes || stdin.isTTY !== true) {
-            io.write(firstRunMessage);
-            if (!options.yes && !(await io.ask('이 프로젝트에 연결할까요?', true))) {
-                io.write('JuTell을 연결하지 않았습니다.');
-                return { cancelled: true };
-            }
-            await setupCommand(paths, { ...options, yes: true, oneCommand: true, activateMcp: true }, io);
+    io.write('\nJuTell을 이 Agent들에 연결할 수 있습니다.');
+    if (!options.yes) {
+        if (stdin.isTTY !== true) {
+            io.write("\n대화형 터미널이 아니어서 확인 없이 연결하지 않았습니다.\n자동으로 연결하려면 'jutell --yes'를 실행하거나, 대화형 터미널에서 'jutell'을 다시 실행해 주세요.");
+            return { cancelled: true };
         }
-        else {
-            const picked = await firstRunWizard(io);
-            await useCommand(paths, { ...options, yes: true, profile: picked.profile }, io, ['use', picked.agent]);
+        const confirmed = await io.ask('JuTell을 지금 연결할까요?', true);
+        if (!confirmed) {
+            io.write("\nJuTell을 연결하지 않았습니다.\n나중에 다시 'jutell'을 실행하면 같은 안내를 볼 수 있습니다.");
+            return { cancelled: true };
         }
     }
-    else if (needsRepair(status)) {
+    io.write('\nJuTell을 연결하는 중...\n');
+    for (const row of offerable) {
+        await useCommand(paths, { ...options, yes: true }, io, ['use', row.provider.id]);
+    }
+    if (conflicted.length) {
+        io.write(`주의: ${conflicted.map((row) => row.provider.label).join(', ')}에 관리되지 않는 기존 MCP 설정이 있어 자동으로 연결하지 않았습니다. 'jutell use <agent>'로 직접 확인해 주세요.`);
+    }
+    return { cancelled: false };
+}
+export async function defaultCommand(paths, options, io) {
+    const status = await getStatus(paths);
+    const statuses = providerRuntimeStatuses(status);
+    const detected = statuses.filter((row) => row.detected);
+    const toConnect = detected.filter((row) => !row.connected);
+    if (detected.length === 0) {
+        io.write(noProvidersMessage);
+        return { cancelled: true };
+    }
+    if (toConnect.length > 0) {
+        const result = await offerAutoConnect(paths, options, io, statuses);
+        if (result.cancelled)
+            return result;
+        // Connected - print a concise summary and return to the shell. Does NOT
+        // auto-launch the dashboard (JUTELL-V1.X-AUTO-SETUP-FOUNDATION-01B): the
+        // user asked to connect, not to open a local browser/server session.
+        // `jutell dashboard` remains the explicit, unchanged, opt-in way to do that.
+        io.write(connectedSummaryMessage(providerRuntimeStatuses(await getStatus(paths))));
+        return { cancelled: false };
+    }
+    if (needsRepair(status)) {
         io.write('JuTell 연결이 일부 준비되지 않았습니다.\nSkill, AGENTS.md, AI Agent Provider 연결 준비를 안전하게 확인할 수 있습니다.');
         if (!options.yes && !(await io.ask('다시 켜고 관리자 화면을 열까요?', true))) {
             io.write('현재 설정을 그대로 두고 관리자 화면을 엽니다.');
@@ -96,8 +155,12 @@ export async function defaultCommand(paths, options, io) {
         else {
             await enableCommand(paths, { ...options, yes: true, oneCommand: true }, io);
         }
+        io.write(readyMessage(await getStatus(paths)));
+        return dashboardCommand(paths, options, io);
     }
-    status = await getStatus(paths);
-    io.write(readyMessage(status));
-    return dashboardCommand(paths, options, io);
+    // Every detected provider is already connected and nothing needs repair -
+    // this is a repeat run, not onboarding. Keep it minimal: no wizard, no
+    // dashboard auto-launch, just a status line and a pointer to --help.
+    io.write(alreadyConfiguredMessage(statuses));
+    return { cancelled: false };
 }

package/dist/commands/provider.js

@@ -58,24 +58,24 @@ async function statusCommand(paths, io) {
     const codex = await readCodexRegistration(codexScopedPaths(paths), packageRoot(), false);
     const opencode = await readOpenCodeRegistration(paths, packageRoot(), false);
     const claude = await readClaudeRegistration(paths, packageRoot(), false);
-    io.write(`JuTell AI Agent Provider 상태
-
-${providerLabel('codex')}
-  감지: ${codexDetected() ? '예' : '직접 확인 필요'}
-  설정 파일: 사용자 전역 Codex 설정 (Codex는 프로젝트 설정을 읽지 않음)
-  MCP 등록: ${codex.registered ? '등록됨' : codex.conflict ? '충돌 확인 필요' : '등록되지 않음'}
-  활성화: ${codex.registered ? (codex.enabled ? '예' : '아니오') : '등록되지 않음'}
-
-${providerLabel('opencode')}
-  감지: ${opencodeDetected() ? '예' : '직접 확인 필요'}
-  설정 파일: ${openCodeScopeLabel(paths)}
-  MCP 등록: ${opencode.registered ? '등록됨' : opencode.conflict ? '충돌 확인 필요' : '등록되지 않음'}
-  활성화: ${opencode.registered ? (opencode.enabled ? '예' : '아니오') : '등록되지 않음'}
-
-${providerLabel('claude-code')}
-  감지: ${claudeDetected() ? '예' : '직접 확인 필요'}
-  설정 파일: ${claudeScopeLabel(paths)}
-  MCP 등록: ${claude.registered ? '등록됨' : '등록되지 않음'}
+    io.write(`JuTell AI Agent Provider 상태
+
+${providerLabel('codex')}
+  감지: ${codexDetected() ? '예' : '직접 확인 필요'}
+  설정 파일: 사용자 전역 Codex 설정 (Codex는 프로젝트 설정을 읽지 않음)
+  MCP 등록: ${codex.registered ? '등록됨' : codex.conflict ? '충돌 확인 필요' : '등록되지 않음'}
+  활성화: ${codex.registered ? (codex.enabled ? '예' : '아니오') : '등록되지 않음'}
+
+${providerLabel('opencode')}
+  감지: ${opencodeDetected() ? '예' : '직접 확인 필요'}
+  설정 파일: ${openCodeScopeLabel(paths)}
+  MCP 등록: ${opencode.registered ? '등록됨' : opencode.conflict ? '충돌 확인 필요' : '등록되지 않음'}
+  활성화: ${opencode.registered ? (opencode.enabled ? '예' : '아니오') : '등록되지 않음'}
+
+${providerLabel('claude-code')}
+  감지: ${claudeDetected() ? '예' : '직접 확인 필요'}
+  설정 파일: ${claudeScopeLabel(paths)}
+  MCP 등록: ${claude.registered ? '등록됨' : '등록되지 않음'}
   활성화: ${claude.registered ? '예' : '등록되지 않음'}`);
 }
 function requireTarget(args) {

package/dist/commands/session/index.js

@@ -35,22 +35,22 @@ export async function sessionStatusCommand(paths, io) {
     return 0;
 }
 export async function sessionHelpCommand(io) {
-    io.write(`Session은 하루 작업 기록을 담는 폴더입니다.
-Page는 Agent·역할별 파일, Work는 Page 안의 작업입니다.
-
-하루 기록 명령
-
-  jutell session         오늘 기록 상태를 봅니다.
-  jutell session new     오늘 Session 폴더를 만듭니다.
-  jutell session page    Agent·역할별 Page 파일을 만듭니다.
-  jutell session work    현재 Page에 다음 번호 작업을 추가합니다.
-  jutell session move    작업할 Page를 이동합니다.
-  jutell session finish  SESSION_SUMMARY.md로 하루를 마감합니다.
-
-운영자용 (보통 사용할 필요가 없습니다)
-
-  jutell session storage                 Session 저장 위치 상태를 확인합니다.
-  jutell session storage set <절대 경로>  Session 저장 위치를 운영자 지정으로 바꿉니다.
+    io.write(`Session은 하루 작업 기록을 담는 폴더입니다.
+Page는 Agent·역할별 파일, Work는 Page 안의 작업입니다.
+
+하루 기록 명령
+
+  jutell session         오늘 기록 상태를 봅니다.
+  jutell session new     오늘 Session 폴더를 만듭니다.
+  jutell session page    Agent·역할별 Page 파일을 만듭니다.
+  jutell session work    현재 Page에 다음 번호 작업을 추가합니다.
+  jutell session move    작업할 Page를 이동합니다.
+  jutell session finish  SESSION_SUMMARY.md로 하루를 마감합니다.
+
+운영자용 (보통 사용할 필요가 없습니다)
+
+  jutell session storage                 Session 저장 위치 상태를 확인합니다.
+  jutell session storage set <절대 경로>  Session 저장 위치를 운영자 지정으로 바꿉니다.
   jutell session storage reset            운영자 지정을 제거하고 기본 위치로 돌아갑니다.`);
     return 0;
 }

package/dist/installer/agents.js

@@ -2,14 +2,16 @@ import { readText, writeTextSafely } from '../config/managed.js';
 import path from 'node:path';
 export const JUTELL_AGENTS_BEGIN = '<!-- BEGIN JUTELL MANAGED BLOCK -->';
 export const JUTELL_AGENTS_END = '<!-- END JUTELL MANAGED BLOCK -->';
-const managedBlock = `${JUTELL_AGENTS_BEGIN}
-## JuTell
-
-- 코드 또는 문서 변경 후 \`.agents/skills/beginner-bridge/SKILL.md\`와 \`.jutell.json\`을 먼저 읽습니다. 소유자 대상 구현/보고 전에는 JuTell 보고 규칙을 먼저 적용해 최종 답변을 작성합니다.
-- JuTell MCP가 보이면 canonical \`jutell\` 서버를 사용합니다. \`jutell\`과 legacy \`beginner_bridge\`가 모두 보이면 \`jutell\`을 우선하고 \`beginner_bridge\`는 호환용으로만 사용합니다.
-- 확인하지 않은 결과를 사실처럼 표현하지 않습니다.
-- 비밀정보를 명령 출력이나 보고서에 포함하지 않습니다.
-- 외부 전송 없이 현재 프로젝트의 로컬 설정을 기준으로 작업합니다.
+const managedBlock = `${JUTELL_AGENTS_BEGIN}
+## JuTell
+
+- 코드 또는 문서 변경 후 \`.agents/skills/beginner-bridge/SKILL.md\`와 \`.jutell.json\`을 먼저 읽습니다. 소유자 대상 구현/보고 전에는 JuTell 보고 규칙을 먼저 적용해 최종 답변을 작성합니다.
+- 실제로 코드나 문서를 바꾸기 전에는, 요청에 결과를 크게 바꿀 수 있는 불확실함이 있는지 SKILL.md의 Intent Bridge 규칙으로 판단합니다. 불확실함이 없거나 \`requestClarificationGuide\`가 꺼져 있으면 평소처럼 바로 진행합니다.
+- JuTell MCP가 보이면 canonical \`jutell\` 서버를 사용합니다. \`jutell\`과 legacy \`beginner_bridge\`가 모두 보이면 \`jutell\`을 우선하고 \`beginner_bridge\`는 호환용으로만 사용합니다.
+- JuTell MCP를 사용할 수 있고 이미 확보한 근거로 보고·검증·핸드오프의 모호함을 줄여줄 때는 그 도구를 우선합니다. 사용할 수 없거나 Provider 정책으로 막혀 있으면 작업을 멈추지 않고 JuTell Skill로 계속합니다. 실제로 호출해 응답을 받은 경우에만 JuTell MCP를 사용했다고 말합니다.
+- 확인하지 않은 결과를 사실처럼 표현하지 않습니다.
+- 비밀정보를 명령 출력이나 보고서에 포함하지 않습니다.
+- 외부 전송 없이 현재 프로젝트의 로컬 설정을 기준으로 작업합니다.
 ${JUTELL_AGENTS_END}`;
 function markerPattern() {
     return new RegExp(`${JUTELL_AGENTS_BEGIN}[\\s\\S]*?${JUTELL_AGENTS_END}`, 'm');

package/dist/output/format.js

@@ -140,48 +140,46 @@ export function parseOptions(args) {
 }
 export function scopeLabel(scope) { return scope === 'global' ? '사용자 전역' : '현재 프로젝트'; }
 export function printHelp(io) {
-    io.write(`JuTell CLI 1.0.1
-
-시작할 때는 jutell만 입력하면 됩니다.
-처음 연결하면 안내에 따라 AI Agent와 보고 방식을 고르고
-연결을 준비한 뒤 관리자 화면을 엽니다.
-
-자주 쓰는 명령
-
-  jutell                처음 시작: 설치·연결·관리자 화면을 준비합니다.
-  jutell use codex      Codex에 연결합니다 (권장).
-  jutell use opencode   OpenCode에 연결합니다.
-  jutell use claude     Claude Code에 연결합니다 (베타).
-  jutell status         현재 연결 상태를 확인합니다.
-  jutell doctor         문제가 있는지 점검합니다.
-  jutell on             연결을 켭니다.
-  jutell off            연결을 끕니다.
-
-연결 후 새 대화를 열면 JuTell이 자동으로 적용됩니다.
-JuTell은 AI Agent를 대신 실행하지 않고 연결과 보고만 도와줍니다.
-
-고급 명령 (보통 사용할 필요가 없습니다)
-
-  jutell dashboard      관리자 화면만 엽니다.
-  jutell setup          설치를 다시 진행합니다.
-  jutell enable         연결을 켭니다 (on과 같음).
-  jutell disable        연결을 끕니다 (off와 같음).
-  jutell provider       Agent 연결 상태를 자세히 봅니다.
-  jutell connect        연결만 추가합니다.
-  jutell disconnect     해당 연결만 끕니다.
-  jutell switch         기본 Agent를 전환합니다.
-  jutell uninstall      설치를 제거합니다.
-  jutell upgrade        설치된 Skill/설정/MCP를 최신으로 새로고침합니다.
-  jutell migrate        레거시 beginner_bridge → jutell 로 안전하게 옮깁니다.
-  jutell migrate --clean 레거시 정리를 수행합니다 (canonical 확인 후).
-
-하루 작업 기록
-
-  jutell session        오늘 기록 상태를 봅니다.
-  jutell session help   하루 기록의 하위 명령을 보여줍니다.
-
-이전 별칭: beginner-bridge
-
-공개 설치: npm install -g jutell
+    io.write(`JuTell CLI 2.0.0
+
+시작할 때는 jutell만 입력하면 됩니다.
+설치된 Coding Agent(Codex, OpenCode, Claude Code)를 찾아 연결하고,
+곧바로 평소 쓰던 화면으로 돌아갑니다. 관리자 화면은 열지 않습니다.
+
+자주 쓰는 명령
+
+  jutell                처음 시작: 설치된 Agent를 찾아 연결합니다.
+  jutell use codex      Codex에 연결합니다 (권장).
+  jutell use opencode   OpenCode에 연결합니다 (베타).
+  jutell use claude     Claude Code에 연결합니다 (베타).
+  jutell status         현재 연결 상태를 확인합니다.
+  jutell doctor         문제가 있는지 점검합니다.
+  jutell on             연결을 켭니다.
+  jutell off            연결을 끕니다.
+
+연결 후 새 대화를 열면 JuTell이 자동으로 적용됩니다.
+JuTell은 AI Agent를 대신 실행하지 않고 연결과 보고만 도와줍니다.
+
+고급 명령 (보통 사용할 필요가 없습니다)
+
+  jutell dashboard      관리자 화면을 엽니다 (필요할 때만 직접 실행).
+  jutell setup          설치를 다시 진행합니다.
+  jutell enable         연결을 켭니다 (on과 같음).
+  jutell disable        연결을 끕니다 (off와 같음).
+  jutell provider       Agent 연결 상태를 자세히 봅니다.
+  jutell connect        연결만 추가합니다.
+  jutell disconnect     해당 연결만 끕니다.
+  jutell switch         기본 Agent를 전환합니다.
+  jutell uninstall      설치를 제거합니다.
+  jutell upgrade        설치된 Skill/설정/MCP를 최신으로 새로고침합니다.
+  jutell migrate        레거시 beginner_bridge → jutell 로 안전하게 옮깁니다. (이전 명령 이름: beginner-bridge)
+  jutell migrate --clean 레거시 정리를 수행합니다 (canonical 확인 후).
+
+하루 작업 기록
+
+  jutell session        오늘 기록 상태를 봅니다.
+  jutell session help   하루 기록의 하위 명령을 보여줍니다.
+
+공개 설치: npm install -g jutell
 업데이트: npm update -g jutell`);
 }

package/dist/process/mcpProbe.js

@@ -6,7 +6,7 @@ const INITIALIZE = JSON.stringify({
     jsonrpc: '2.0',
     id: 1,
     method: 'initialize',
-    params: { protocolVersion: PROTOCOL_VERSION, capabilities: {}, clientInfo: { name: 'jutell-doctor', version: '1.0.1' } },
+    params: { protocolVersion: PROTOCOL_VERSION, capabilities: {}, clientInfo: { name: 'jutell-doctor', version: '2.0.0' } },
 });
 const INITIALIZED = JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized' });
 const TOOLS_LIST = JSON.stringify({ jsonrpc: '2.0', id: 2, method: 'tools/list', params: {} });