jutell 0.3.0

package/dist/output/format.js

@@ -0,0 +1,187 @@
+import readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+export function createIo() {
+    return {
+        write: (message) => console.log(message),
+        error: (message) => console.error(message),
+        ask: async (message, defaultYes = false) => {
+            const rl = readline.createInterface({ input, output });
+            try {
+                const answer = await rl.question(`${message} ${defaultYes ? '(Y/n)' : '(y/N)'} `);
+                return defaultYes ? !/^n(o)?$/i.test(answer.trim()) : /^y(es)?$/i.test(answer.trim());
+            }
+            finally {
+                rl.close();
+            }
+        },
+        choose: async (message, choices, defaultValue) => {
+            const rl = readline.createInterface({ input, output });
+            try {
+                const list = choices.map((choice, index) => `  ${index + 1}. ${choice.label}${choice.note ? ` — ${choice.note}` : ''}`).join('\n');
+                output.write(`${message}\n${list}\n`);
+                const defaultLabel = defaultValue ? choices.find((choice) => choice.value === defaultValue)?.label : undefined;
+                while (true) {
+                    const answer = await rl.question(`선택 (번호 입력${defaultLabel ? `, Enter: ${defaultLabel}` : ''}) > `);
+                    const trimmed = answer.trim();
+                    if (!trimmed) {
+                        if (defaultLabel)
+                            return defaultValue;
+                        output.write('보기 중 하나의 번호를 입력하세요.\n');
+                        continue;
+                    }
+                    const number = Number(trimmed);
+                    if (Number.isInteger(number) && number >= 1 && number <= choices.length)
+                        return choices[number - 1].value;
+                    output.write('보기 중 하나의 번호를 입력하세요.\n');
+                }
+            }
+            finally {
+                rl.close();
+            }
+        },
+    };
+}
+export function parseOptions(args) {
+    let command = 'dashboard';
+    let defaultInvocation = true;
+    let index = 0;
+    const extraArgs = [];
+    if (args[0] && !args[0].startsWith('-')) {
+        command = args[0];
+        defaultInvocation = false;
+        index = 1;
+    }
+    const options = { scope: 'project', yes: false, activateMcp: false, oneCommand: false, statusOnly: false, json: false, verbose: false, openBrowser: true, fix: false, skillOnly: false, mcpOnly: false, disableSkill: false, disableMcp: false, disableAll: false, keepData: false, removeData: false, clean: false };
+    for (; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--project')
+            options.scope = 'project';
+        else if (arg === '--global')
+            options.scope = 'global';
+        else if (arg === '--yes' || arg === '-y')
+            options.yes = true;
+        else if (arg === '--json')
+            options.json = true;
+        else if (arg === '--status-only')
+            options.statusOnly = true;
+        else if (arg === '--verbose')
+            options.verbose = true;
+        else if (arg === '--no-open')
+            options.openBrowser = false;
+        else if (arg === '--fix')
+            options.fix = true;
+        else if (arg === '--skill-only')
+            options.skillOnly = true;
+        else if (arg === '--mcp-only')
+            options.mcpOnly = true;
+        else if (arg === '--skill')
+            options.disableSkill = true;
+        else if (arg === '--mcp')
+            options.disableMcp = true;
+        else if (arg === '--all')
+            options.disableAll = true;
+        else if (arg === '--keep-data')
+            options.keepData = true;
+        else if (arg === '--remove-data')
+            options.removeData = true;
+        else if (arg === '--clean' || arg === '--remove-legacy')
+            options.clean = true;
+        else if (arg === '--profile') {
+            const value = args[index + 1];
+            if (!value)
+                throw new Error('--profile 뒤에 Profile 이름이 필요합니다.');
+            options.profile = value;
+            index += 1;
+        }
+        else if (arg === '--page') {
+            const value = args[index + 1];
+            if (!value || !/^\d+$/.test(value))
+                throw new Error('--page 뒤에 Page 번호가 필요합니다.');
+            options.page = Number(value);
+            index += 1;
+        }
+        else if (arg === '--agent') {
+            const value = args[index + 1];
+            if (!value)
+                throw new Error('--agent 뒤에 Agent 이름이 필요합니다.');
+            options.agent = value;
+            index += 1;
+        }
+        else if (arg === '--role') {
+            const value = args[index + 1];
+            if (!value)
+                throw new Error('--role 뒤에 역할이 필요합니다.');
+            options.role = value;
+            index += 1;
+        }
+        else if (arg === '--title') {
+            const value = args[index + 1];
+            if (!value)
+                throw new Error('--title 뒤에 Page 제목이 필요합니다.');
+            options.title = value;
+            index += 1;
+        }
+        else if (arg === '--help' || arg === '-h')
+            command = 'help';
+        else if (arg.startsWith('-'))
+            throw new Error(`알 수 없는 옵션입니다: ${arg}`);
+        else
+            extraArgs.push(arg);
+    }
+    if (options.skillOnly && options.mcpOnly)
+        throw new Error('--skill-only와 --mcp-only를 동시에 사용할 수 없습니다.');
+    if (options.keepData && options.removeData)
+        throw new Error('--keep-data와 --remove-data를 동시에 사용할 수 없습니다.');
+    if (options.disableAll) {
+        options.disableSkill = true;
+        options.disableMcp = true;
+    }
+    return { command, options, defaultInvocation, extraArgs };
+}
+export function scopeLabel(scope) { return scope === 'global' ? '사용자 전역' : '현재 프로젝트'; }
+export function printHelp(io) {
+    io.write(`JuTell CLI 0.3.0
+
+시작할 때는 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 update -g jutell`);
+}

package/dist/process/mcpProbe.js

@@ -0,0 +1,122 @@
+import { spawn } from 'node:child_process';
+const PROTOCOL_VERSION = '2025-03-26';
+const TIMEOUT_MS = 15000;
+const SHUTDOWN_GRACE_MS = 1500;
+const INITIALIZE = JSON.stringify({
+    jsonrpc: '2.0',
+    id: 1,
+    method: 'initialize',
+    params: { protocolVersion: PROTOCOL_VERSION, capabilities: {}, clientInfo: { name: 'jutell-doctor', version: '0.3.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: {} });
+function tryParse(line) {
+    try {
+        return JSON.parse(line.trim());
+    }
+    catch {
+        return undefined;
+    }
+}
+export function probeMcpServer(entry) {
+    return new Promise((resolve) => {
+        const child = spawn(process.execPath, [entry], { stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+        let buffer = '';
+        let stderrText = '';
+        let settled;
+        let initializedSent = false;
+        let toolsListSent = false;
+        let receivedInitialize = false;
+        let receivedTools = false;
+        let serverName = '';
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = result;
+            clearTimeout(timeout);
+            try {
+                child.stdin.end();
+            }
+            catch { /* stdin already closed */ }
+            try {
+                child.kill();
+            }
+            catch { /* already exited */ }
+            const fallback = setTimeout(() => resolve(result), SHUTDOWN_GRACE_MS);
+            child.once('exit', () => { clearTimeout(fallback); resolve(result); });
+        };
+        const timeout = setTimeout(() => {
+            const phase = !receivedInitialize ? 'initialize 응답' : !receivedTools ? 'tools/list 응답' : '종료';
+            const detail = stderrText.trim().slice(0, 200);
+            finish({ ok: false, toolCount: 0, serverName, error: `${phase} 시간 초과${detail ? `: ${detail}` : ''}` });
+        }, TIMEOUT_MS);
+        const handleMessage = (message) => {
+            if (message.id === 1) {
+                receivedInitialize = true;
+                if (message.error) {
+                    finish({ ok: false, toolCount: 0, serverName, error: `initialize 실패: ${message.error.message ?? '알 수 없는 오류'}` });
+                    return;
+                }
+                const name = message.result?.serverInfo?.name;
+                if (typeof name === 'string')
+                    serverName = name;
+                if (!initializedSent) {
+                    initializedSent = true;
+                    try {
+                        child.stdin.write(`${INITIALIZED}\n`);
+                    }
+                    catch { /* closed */ }
+                }
+                if (!toolsListSent) {
+                    toolsListSent = true;
+                    try {
+                        child.stdin.write(`${TOOLS_LIST}\n`);
+                    }
+                    catch { /* closed */ }
+                }
+                return;
+            }
+            if (message.id === 2) {
+                receivedTools = true;
+                if (message.error) {
+                    finish({ ok: false, toolCount: 0, serverName, error: `tools/list 실패: ${message.error.message ?? '알 수 없는 오류'}` });
+                    return;
+                }
+                const tools = message.result?.tools ?? [];
+                finish({ ok: true, toolCount: tools.length, serverName });
+                return;
+            }
+        };
+        child.stdout.on('data', (chunk) => {
+            buffer += String(chunk);
+            let newlineIndex = buffer.indexOf('\n');
+            while (newlineIndex !== -1) {
+                const line = buffer.slice(0, newlineIndex);
+                buffer = buffer.slice(newlineIndex + 1);
+                if (line.trim()) {
+                    const message = tryParse(line);
+                    if (message)
+                        handleMessage(message);
+                }
+                newlineIndex = buffer.indexOf('\n');
+            }
+        });
+        child.stderr.on('data', (chunk) => { stderrText += String(chunk); });
+        child.once('error', (error) => {
+            finish({ ok: false, toolCount: 0, serverName, error: `프로세스 시작 실패: ${error.message}` });
+        });
+        child.once('exit', (code) => {
+            if (settled)
+                return;
+            const detail = stderrText.trim().slice(0, 200);
+            const phase = !receivedInitialize ? 'initialize 전' : !receivedTools ? 'tools/list 전' : '응답 후';
+            finish({ ok: false, toolCount: 0, serverName, error: `프로세스가 ${phase} 종료됨(code ${code})${detail ? `: ${detail}` : ''}` });
+        });
+        try {
+            child.stdin.write(`${INITIALIZE}\n`);
+        }
+        catch (error) {
+            finish({ ok: false, toolCount: 0, serverName, error: `initialize 전송 실패: ${error instanceof Error ? error.message : String(error)}` });
+        }
+    });
+}

package/dist/process/system.js

@@ -0,0 +1,34 @@
+import { spawn, spawnSync } from 'node:child_process';
+import os from 'node:os';
+export function codexDetected() {
+    const result = spawnSync('codex', ['--version'], { stdio: 'ignore', windowsHide: true, shell: process.platform === 'win32' || undefined });
+    return result.status === 0 && !result.error;
+}
+export function claudeDetected() {
+    const result = spawnSync('claude', ['--version'], { stdio: 'ignore', windowsHide: true, shell: process.platform === 'win32' || undefined });
+    return result.status === 0 && !result.error;
+}
+export function nodeMajorVersion() {
+    const match = process.versions.node.match(/^(\d+)/);
+    return match ? Number(match[1]) : 0;
+}
+export function operatingSystem() {
+    if (process.platform === 'win32')
+        return 'Windows';
+    if (process.platform === 'darwin')
+        return 'macOS';
+    if (process.platform === 'linux')
+        return 'Linux';
+    return os.platform();
+}
+export async function openBrowser(url, io) {
+    try {
+        const command = process.platform === 'win32' ? 'cmd' : process.platform === 'darwin' ? 'open' : 'xdg-open';
+        const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
+        const child = spawn(command, args, { detached: true, stdio: 'ignore', windowsHide: true });
+        child.unref();
+    }
+    catch {
+        io.write('기본 브라우저를 열지 못했습니다. 위 URL을 직접 열어주세요.');
+    }
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "jutell",
+  "version": "0.3.0",
+  "description": "JuTell by Ju0 — non-developer harness for AI coding agents (Skill, MCP, local dashboard)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ju0o/jutell.git"
+  },
+  "homepage": "https://github.com/ju0o/jutell#readme",
+  "bugs": {
+    "url": "https://github.com/ju0o/jutell/issues"
+  },
+  "keywords": [
+    "jutell",
+    "ai",
+    "agent",
+    "harness",
+    "mcp",
+    "skill",
+    "codex",
+    "opencode",
+    "claude-code"
+  ],
+  "author": "Ju0",
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "module",
+  "bin": {
+    "jutell": "dist/index.js",
+    "beginner-bridge": "dist/compat.js"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/build-assets.mjs",
+    "test": "vitest run",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "esbuild": "^0.24.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.9"
+  }
+}