axmap-cli 1.5.0 → 1.7.0

package/src/pipeline-mcp.mjs

@@ -0,0 +1,111 @@
+// Generated from src/pipeline-mcp.mts. Edit the .mts source and run npm run build.
+/** Portable MCP observation: structured snapshots, plain text and progress share one source. */
+import { createMonitor, terminalText, fitTerminal } from './monitor.mjs';
+import { dispatchRequest, requestResult } from './bridge.mjs';
+const labels = { sending: '전달 중', submitted: '응답 대기', completed: '완료 확인', unknown: '전송 확인 필요', failed: '실패', superseded: '다른 입력으로 대체됨' };
+const pending = new Set(['sending', 'submitted', 'unknown']);
+export function pipelineView(snapshot) {
+    return {
+        schemaVersion: 1, type: 'pipeline', cwd: snapshot.cwd, checkedAt: snapshot.checkedAt,
+        sessions: snapshot.sessions.map(s => ({ id: s.id, provider: s.provider, state: s.state, connection: s.connection,
+            model: s.model ?? null, transport: s.transport ?? null, conversationId: s.conversationId ?? null,
+            role: fitTerminal(s.role, 120), usage: s.usage ?? null, pendingApproval: !!s.pendingApproval })),
+        requests: snapshot.requests.map(r => ({ id: r.id, to: r.to, from: terminalText(r.from), state: r.state,
+            task: fitTerminal(r.prompt, 200), createdAt: r.createdAt, completedAt: r.completedAt, usage: r.usage ?? null,
+            latencyMs: r.completedAt ? Math.max(0, Date.parse(r.completedAt) - Date.parse(r.createdAt)) : null, error: fitTerminal(r.error, 240) })),
+        dialogues: snapshot.dialogues.map(d => ({ id: d.id, state: d.state, turns: d.turns.length,
+            maxTurns: d.limits?.maxTurns, usage: d.usage ?? null, usagePending: d.usagePending })),
+        claims: snapshot.claims.slice(0, 10).map(c => ({ agent: terminalText(c.agent), task: fitTerminal(c.intent || c.task, 160),
+            paths: c.paths.slice(0, 6).map(terminalText), pathCount: c.paths.length })),
+        events: snapshot.events.slice(0, 15).map(e => ({ ...e, label: terminalText(e.label) })),
+        issues: snapshot.issues.map(terminalText),
+    };
+}
+export function pipelineText(view) {
+    const active = view.requests.filter(r => pending.has(r.state));
+    const lines = [`axMap · 진행 확인 ${active.length}개 · ${view.sessions.length}개 세션`, `저장소: ${terminalText(view.cwd)}`];
+    for (const session of view.sessions.slice(0, 5))
+        lines.push(`${session.provider} ${session.id.slice(0, 8)} · ${session.pendingApproval ? '사용자 승인 필요' : session.state} · ${session.connection}`);
+    const selected = [...active, ...view.requests.filter(r => !pending.has(r.state))].slice(0, 3);
+    for (const request of selected) {
+        lines.push(`${request.from} → ${request.to.slice(0, 8)} · ${labels[request.state] || request.state}`);
+        lines.push(request.state === 'completed' ? '접수 ✓ → 전달 ✓ → 응답 ✓ → 완료 확인 ✓' :
+            request.state === 'submitted' ? '접수 ✓ → 전달 ✓ → 응답 대기 → 완료 미확정' :
+                request.state === 'unknown' ? '접수 ✓ → 전달 여부 확인 필요 → 완료 미확정' : `접수 → ${labels[request.state] || request.state} → 완료 미확정`);
+        lines.push(`작업: ${request.task}`);
+        if (request.error)
+            lines.push(`사유: ${request.error}`);
+    }
+    if (!selected.length)
+        lines.push('새 요청을 기다리는 중');
+    for (const issue of view.issues.slice(0, 2))
+        lines.push(`확인 필요: ${issue}`);
+    return lines.join('\n');
+}
+function integer(value, fallback, min, max, name) {
+    const result = value === undefined ? fallback : value;
+    if (typeof result !== 'number' || !Number.isInteger(result) || result < min || result > max)
+        throw new Error(`${name}: ${min}~${max} 정수여야 합니다.`);
+    return result;
+}
+const delay = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+const textResult = (text, structuredContent, isError = false) => ({ content: [{ type: 'text', text }], structuredContent, isError });
+export async function runPipelineOperation(action, args, emit = () => { }, cancelled = () => false) {
+    const cwd = process.cwd(), progress = args.__progress === true;
+    if (action === 'snapshot' || action === 'watch') {
+        const duration = integer(args.duration_ms, action === 'watch' ? 5000 : 0, 0, 25000, 'duration_ms');
+        const interval = integer(args.interval_ms, 1000, 500, 5000, 'interval_ms');
+        const collect = createMonitor(cwd), deadline = Date.now() + (progress ? duration : 0);
+        let view;
+        do {
+            view = pipelineView(await collect());
+            if (progress) {
+                const active = view.requests.filter(r => pending.has(r.state));
+                emit(active.length ? active.slice(0, 3).map(r => `${r.id.slice(0, 8)} ${labels[r.state]}`).join(' · ') : 'axMap · 진행 중인 요청 없음');
+            }
+            if (cancelled() || Date.now() >= deadline)
+                break;
+            await delay(Math.min(interval, Math.max(0, deadline - Date.now())));
+            if (cancelled())
+                break;
+        } while (true);
+        const note = action === 'watch' && !progress ? '\n클라이언트가 progressToken을 제공하지 않아 현재 상태를 한 번 반환했습니다.' : '';
+        return textResult(pipelineText(view) + note + (cancelled() ? '\n관측 대기를 중단했습니다. 이미 전달한 작업은 계속 실행될 수 있습니다.' : ''), view, cancelled());
+    }
+    if (action === 'dispatch' || action === 'result') {
+        // Validate the wait budget before any irreversible submission.
+        const waitMs = integer(args.wait_ms, 0, 0, 30000, 'wait-ms');
+        let request;
+        if (action === 'dispatch') {
+            if (typeof args.to !== 'string' || typeof args.prompt !== 'string')
+                throw new Error('to와 prompt 문자열이 필요합니다.');
+            if (progress)
+                emit('axMap · 대상 세션과 입력 상태 확인');
+            request = dispatchRequest({ to: args.to, prompt: args.prompt, cwd, from: process.env.AXMAP_AGENT || 'axmap' });
+        }
+        else {
+            if (typeof args.id !== 'string')
+                throw new Error('요청 UUID가 필요합니다.');
+            request = requestResult(args.id, cwd);
+        }
+        const deadline = Date.now() + waitMs;
+        let lastMessage = '', lastAt = 0;
+        do {
+            const message = `axMap · ${request.id.slice(0, 8)} · ${labels[request.state] || request.state}`;
+            if (progress && (message !== lastMessage || Date.now() - lastAt >= 1000)) {
+                emit(message);
+                lastMessage = message;
+                lastAt = Date.now();
+            }
+            if (cancelled() || request.state !== 'submitted' || Date.now() >= deadline)
+                break;
+            await delay(Math.min(200, Math.max(0, deadline - Date.now())));
+            if (cancelled())
+                break;
+            request = requestResult(request.id, cwd);
+        } while (true);
+        return textResult(JSON.stringify(request, null, 2), { schemaVersion: 1, type: 'request', request,
+            observationCancelled: cancelled() }, action === 'dispatch' && request.state === 'unknown');
+    }
+    throw new Error(`지원하지 않는 파이프라인 동작: ${action}`);
+}

package/src/pipeline-mcp.mts

@@ -0,0 +1,105 @@
+/** Portable MCP observation: structured snapshots, plain text and progress share one source. */
+import { createMonitor, terminalText, fitTerminal } from './monitor.mjs'
+import { dispatchRequest, requestResult } from './bridge.mjs'
+import type { MonitorSnapshot } from './monitor.mjs'
+import type { RequestRecord } from './session-types.mjs'
+
+export interface PipelineOutput {
+  content: Array<{ type: 'text'; text: string }>
+  structuredContent?: Record<string, unknown>
+  isError: boolean
+}
+export type PipelineEmit = (message: string) => void
+const labels: Record<string, string> = { sending: '전달 중', submitted: '응답 대기', completed: '완료 확인', unknown: '전송 확인 필요', failed: '실패', superseded: '다른 입력으로 대체됨' }
+const pending = new Set(['sending', 'submitted', 'unknown'])
+
+export function pipelineView(snapshot: MonitorSnapshot) {
+  return {
+    schemaVersion: 1, type: 'pipeline', cwd: snapshot.cwd, checkedAt: snapshot.checkedAt,
+    sessions: snapshot.sessions.map(s => ({ id: s.id, provider: s.provider, state: s.state, connection: s.connection,
+      model: s.model ?? null, transport: s.transport ?? null, conversationId: s.conversationId ?? null,
+      role: fitTerminal(s.role, 120), usage: s.usage ?? null, pendingApproval: !!s.pendingApproval })),
+    requests: snapshot.requests.map(r => ({ id: r.id, to: r.to, from: terminalText(r.from), state: r.state,
+      task: fitTerminal(r.prompt, 200), createdAt: r.createdAt, completedAt: r.completedAt, usage: r.usage ?? null,
+      latencyMs: r.completedAt ? Math.max(0, Date.parse(r.completedAt) - Date.parse(r.createdAt)) : null, error: fitTerminal(r.error, 240) })),
+    dialogues: snapshot.dialogues.map(d => ({ id: d.id, state: d.state, turns: d.turns.length,
+      maxTurns: d.limits?.maxTurns, usage: d.usage ?? null, usagePending: d.usagePending })),
+    claims: snapshot.claims.slice(0, 10).map(c => ({ agent: terminalText(c.agent), task: fitTerminal(c.intent || c.task, 160),
+      paths: c.paths.slice(0, 6).map(terminalText), pathCount: c.paths.length })),
+    events: snapshot.events.slice(0, 15).map(e => ({ ...e, label: terminalText(e.label) })),
+    issues: snapshot.issues.map(terminalText),
+  }
+}
+export type PipelineView = ReturnType<typeof pipelineView>
+export function pipelineText(view: PipelineView): string {
+  const active = view.requests.filter(r => pending.has(r.state))
+  const lines = [`axMap · 진행 확인 ${active.length}개 · ${view.sessions.length}개 세션`, `저장소: ${terminalText(view.cwd)}`]
+  for (const session of view.sessions.slice(0, 5)) lines.push(`${session.provider} ${session.id.slice(0, 8)} · ${session.pendingApproval ? '사용자 승인 필요' : session.state} · ${session.connection}`)
+  const selected = [...active, ...view.requests.filter(r => !pending.has(r.state))].slice(0, 3)
+  for (const request of selected) {
+    lines.push(`${request.from} → ${request.to.slice(0, 8)} · ${labels[request.state] || request.state}`)
+    lines.push(request.state === 'completed' ? '접수 ✓ → 전달 ✓ → 응답 ✓ → 완료 확인 ✓' :
+      request.state === 'submitted' ? '접수 ✓ → 전달 ✓ → 응답 대기 → 완료 미확정' :
+      request.state === 'unknown' ? '접수 ✓ → 전달 여부 확인 필요 → 완료 미확정' : `접수 → ${labels[request.state] || request.state} → 완료 미확정`)
+    lines.push(`작업: ${request.task}`)
+    if (request.error) lines.push(`사유: ${request.error}`)
+  }
+  if (!selected.length) lines.push('새 요청을 기다리는 중')
+  for (const issue of view.issues.slice(0, 2)) lines.push(`확인 필요: ${issue}`)
+  return lines.join('\n')
+}
+function integer(value: unknown, fallback: number, min: number, max: number, name: string): number {
+  const result = value === undefined ? fallback : value
+  if (typeof result !== 'number' || !Number.isInteger(result) || result < min || result > max) throw new Error(`${name}: ${min}~${max} 정수여야 합니다.`)
+  return result
+}
+const delay = (ms: number) => new Promise<void>(resolve => setTimeout(resolve, ms))
+const textResult = (text: string, structuredContent?: Record<string, unknown>, isError = false): PipelineOutput => ({ content: [{ type: 'text', text }], structuredContent, isError })
+
+export async function runPipelineOperation(action: string, args: Record<string, unknown>, emit: PipelineEmit = () => {}, cancelled: () => boolean = () => false): Promise<PipelineOutput> {
+  const cwd = process.cwd(), progress = args.__progress === true
+  if (action === 'snapshot' || action === 'watch') {
+    const duration = integer(args.duration_ms, action === 'watch' ? 5000 : 0, 0, 25000, 'duration_ms')
+    const interval = integer(args.interval_ms, 1000, 500, 5000, 'interval_ms')
+    const collect = createMonitor(cwd), deadline = Date.now() + (progress ? duration : 0)
+    let view: PipelineView
+    do {
+      view = pipelineView(await collect())
+      if (progress) {
+        const active = view.requests.filter(r => pending.has(r.state))
+        emit(active.length ? active.slice(0, 3).map(r => `${r.id.slice(0, 8)} ${labels[r.state]}`).join(' · ') : 'axMap · 진행 중인 요청 없음')
+      }
+      if (cancelled() || Date.now() >= deadline) break
+      await delay(Math.min(interval, Math.max(0, deadline - Date.now())))
+      if (cancelled()) break
+    } while (true)
+    const note = action === 'watch' && !progress ? '\n클라이언트가 progressToken을 제공하지 않아 현재 상태를 한 번 반환했습니다.' : ''
+    return textResult(pipelineText(view) + note + (cancelled() ? '\n관측 대기를 중단했습니다. 이미 전달한 작업은 계속 실행될 수 있습니다.' : ''), view, cancelled())
+  }
+  if (action === 'dispatch' || action === 'result') {
+    // Validate the wait budget before any irreversible submission.
+    const waitMs = integer(args.wait_ms, 0, 0, 30000, 'wait-ms')
+    let request: RequestRecord
+    if (action === 'dispatch') {
+      if (typeof args.to !== 'string' || typeof args.prompt !== 'string') throw new Error('to와 prompt 문자열이 필요합니다.')
+      if (progress) emit('axMap · 대상 세션과 입력 상태 확인')
+      request = dispatchRequest({ to: args.to, prompt: args.prompt, cwd, from: process.env.AXMAP_AGENT || 'axmap' })
+    } else {
+      if (typeof args.id !== 'string') throw new Error('요청 UUID가 필요합니다.')
+      request = requestResult(args.id, cwd)
+    }
+    const deadline = Date.now() + waitMs
+    let lastMessage = '', lastAt = 0
+    do {
+      const message = `axMap · ${request.id.slice(0, 8)} · ${labels[request.state] || request.state}`
+      if (progress && (message !== lastMessage || Date.now() - lastAt >= 1000)) { emit(message); lastMessage = message; lastAt = Date.now() }
+      if (cancelled() || request.state !== 'submitted' || Date.now() >= deadline) break
+      await delay(Math.min(200, Math.max(0, deadline - Date.now())))
+      if (cancelled()) break
+      request = requestResult(request.id, cwd)
+    } while (true)
+    return textResult(JSON.stringify(request, null, 2), { schemaVersion: 1, type: 'request', request,
+      observationCancelled: cancelled() }, action === 'dispatch' && request.state === 'unknown')
+  }
+  throw new Error(`지원하지 않는 파이프라인 동작: ${action}`)
+}

package/src/pipeline-statusline.mjs

@@ -0,0 +1,135 @@
+// Generated from src/pipeline-statusline.mts. Edit the .mts source and run npm run build.
+/** Native CLI adapter. Reads local records only and preserves the user's old status command. */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { randomUUID } from 'node:crypto';
+import { bridgeHome, repoKey, readJSON, writeJSON } from './bridge.mjs';
+import { createMonitor, fitTerminal, terminalText } from './monitor.mjs';
+const root = fileURLToPath(new URL('../', import.meta.url));
+const savedFile = (home, provider) => path.join(home, '.axmap', 'bridge', `statusline-${provider}.json`);
+function client(value) { if (value !== 'claude' && value !== 'agy')
+    throw new Error('claude 또는 agy를 지정하세요.'); return value; }
+function settings(home, provider) { return provider === 'claude' ? path.join(home, '.claude', 'settings.json') : path.join(home, '.gemini', 'antigravity-cli', 'settings.json'); }
+export function installPipelineStatusline(providerName, home = os.homedir(), remove = false) {
+    const provider = client(providerName), target = settings(home, provider), file = savedFile(home, provider);
+    const original = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : null;
+    const config = original === null ? {} : JSON.parse(original);
+    if (!config || typeof config !== 'object' || Array.isArray(config))
+        throw new Error('기존 설정을 읽지 못했습니다. 변경하지 않았습니다.');
+    const current = config.statusLine;
+    if (current !== undefined && (!current || typeof current !== 'object' || Array.isArray(current)))
+        throw new Error('기존 statusLine 설정이 객체가 아닙니다. 변경하지 않았습니다.');
+    const owned = typeof current?.command === 'string' && current.command.includes(`axmap-statusline-${provider}`);
+    if (remove && !owned)
+        return { provider, changed: false, note: '다른 상태줄 설정을 유지합니다.' };
+    const saved = fs.existsSync(file) ? readJSON(file) : null;
+    if (owned && !saved)
+        throw new Error('기존 상태줄 복원 정보를 찾지 못했습니다. 변경하지 않았습니다.');
+    const previous = owned ? saved.previous : current;
+    const script = path.join(root, 'tools', 'pipeline.mjs');
+    const wrapper = path.join(home, '.axmap', 'bridge', `axmap-statusline-${provider}${process.platform === 'win32' ? '.cmd' : '.sh'}`);
+    if (process.platform === 'win32' && [process.execPath, script, wrapper].some(p => /["\r\n%&|<>^!]/.test(p)))
+        throw new Error('상태줄 실행 경로에 지원하지 않는 셸 문자가 있습니다.');
+    if (process.platform === 'win32' && /\s/.test(wrapper))
+        throw new Error('이 Windows 상태줄 실행 경로에는 공백을 사용할 수 없습니다. 기존 설정을 유지합니다.');
+    const backup = `${target}.axmap-${randomUUID()}.bak`;
+    if (original !== null)
+        fs.writeFileSync(backup, original, { mode: 0o600 });
+    writeJSON(file, { previous, active: !remove });
+    if (remove) {
+        if (previous === undefined)
+            delete config.statusLine;
+        else
+            config.statusLine = previous;
+    }
+    else {
+        fs.mkdirSync(path.dirname(wrapper), { recursive: true });
+        const quote = (s) => `'${s.replaceAll("'", "'\\''")}'`;
+        const command = process.platform === 'win32'
+            ? `@echo off\r\n"${process.execPath}" "${script}" statusline --provider ${provider}\r\n`
+            : `#!/bin/sh\nexec ${quote(process.execPath)} ${quote(script)} statusline --provider ${provider}\n`;
+        fs.writeFileSync(wrapper, command, { mode: 0o700 });
+        config.statusLine = { ...previous, type: 'command',
+            command: provider === 'claude' ? `"${wrapper.replaceAll('\\', '/')}"` : process.platform === 'win32' ? wrapper : quote(wrapper),
+            ...(provider === 'claude' ? { refreshInterval: previous?.refreshInterval ?? 2 } : { enabled: true, stack_with_default: previous?.stack_with_default ?? true }) };
+    }
+    writeJSON(target, config);
+    return { provider, changed: true, settings: target, backup: original === null ? null : backup,
+        previousPreserved: !!previous, installed: !remove };
+}
+function previousOutput(provider, home, input, previous) {
+    if (typeof previous?.command !== 'string' || !previous.command.trim())
+        return '';
+    let executable, args;
+    if (process.platform === 'win32' && provider === 'claude') {
+        const bash = [process.env.CLAUDE_CODE_GIT_BASH_PATH, path.join(process.env.ProgramFiles || 'C:\\Program Files', 'Git', 'bin', 'bash.exe')].find(p => p && fs.existsSync(p));
+        if (!bash)
+            return '기존 상태줄: Git Bash 경로 확인 필요\n';
+        executable = bash;
+        args = ['-c', previous.command];
+    }
+    else if (process.platform === 'win32') {
+        executable = process.env.ComSpec || 'cmd.exe';
+        args = ['/d', '/s', '/c', previous.command];
+    }
+    else {
+        executable = '/bin/sh';
+        args = ['-c', previous.command];
+    }
+    // Only the user's pre-existing command is executed; provider JSON stays on stdin.
+    const options = { input, encoding: 'utf8', windowsHide: true, timeout: 1500, maxBuffer: 65536 };
+    const result = process.platform === 'win32' && provider === 'agy'
+        ? spawnSync(previous.command, { ...options, shell: process.env.ComSpec || 'cmd.exe' })
+        : spawnSync(executable, args, options);
+    return result.stdout || '';
+}
+export async function pipelineStatusline(providerName, input, home = os.homedir()) {
+    const provider = client(providerName), file = savedFile(home, provider);
+    const saved = fs.existsSync(file) ? readJSON(file) : null;
+    const prior = previousOutput(provider, home, input, saved?.previous);
+    if (saved?.active === false)
+        return prior;
+    const payload = JSON.parse(input);
+    const candidates = new Set([payload.workspace?.current_dir, payload.cwd].filter((p) => typeof p === 'string' && path.isAbsolute(p)));
+    const conversationId = payload.conversation_id || payload.session_id;
+    if (conversationId) {
+        const directory = path.join(bridgeHome(), 'sessions');
+        if (fs.existsSync(directory))
+            for (const name of fs.readdirSync(directory).filter(n => /^[0-9a-f-]{36}\.json$/i.test(n))) {
+                try {
+                    const s = readJSON(path.join(directory, name));
+                    if (s.conversationId === conversationId && s.workspaces?.length === 1)
+                        candidates.add(s.workspaces[0]);
+                }
+                catch { /* a partial record cannot establish scope */ }
+            }
+    }
+    let cwd;
+    for (const candidate of candidates) {
+        try {
+            repoKey(candidate);
+            cwd = candidate;
+            break;
+        }
+        catch { /* try an explicitly attached workspace */ }
+    }
+    const width = Math.max(20, Math.min(240, Number(payload.terminal_width || process.env.COLUMNS) || 100));
+    let line = 'axMap · 이 대화는 Git 저장소에 연결되지 않았습니다.';
+    if (cwd) {
+        const snapshot = await createMonitor(cwd, { probe: async () => [],
+            resolve: id => readJSON(path.join(bridgeHome(), 'requests', `${id}.json`)) })();
+        const active = snapshot.requests.find(r => ['sending', 'submitted', 'unknown'].includes(r.state));
+        const request = active || snapshot.requests[0];
+        const state = payload.tool_confirmation_pending ? '승인 필요' : { working: '작업 중', tool_use: '도구 실행', reviewing: '검토 중', idle: '대기', error: '오류', initializing: '시작 중', authenticating: '인증 중' }[payload.agent_state || ''];
+        const spin = ['◐', '◓', '◑', '◒'][Math.floor(Date.now() / 300) % 4];
+        const flow = !request ? '새 요청 대기' : request.state === 'completed' ? '접수 ✓ → 전달 ✓ → 응답 ✓ → 완료 ✓' : request.state === 'submitted'
+            ? `접수 ✓ → 전달 ✓ → ${spin} 응답 대기 → 완료 미확정` : request.state === 'sending' ? `${spin} 전달 중 → 응답 대기` : request.state === 'unknown' ? '전달 확인 필요 → 완료 미확정' : `${request.state} → 완료 미확정`;
+        line = `axMap${state ? ` · ${provider} ${state}` : ''} · ${!active && request ? '최근 요청 · ' : ''}${flow}`;
+        if (snapshot.issues.length)
+            line += ' · 기록 확인 필요';
+    }
+    return prior + (prior && !prior.endsWith('\n') ? '\n' : '') + fitTerminal(terminalText(line), width) + '\n';
+}

package/src/pipeline-statusline.mts

@@ -0,0 +1,106 @@
+/** Native CLI adapter. Reads local records only and preserves the user's old status command. */
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+import { randomUUID } from 'node:crypto'
+import { bridgeHome, repoKey, readJSON, writeJSON } from './bridge.mjs'
+import { createMonitor, fitTerminal, terminalText } from './monitor.mjs'
+import type { RequestRecord } from './session-types.mjs'
+
+type Client = 'claude' | 'agy'
+interface StatusConfig { command?: string; [key: string]: unknown }
+interface SavedStatus { previous?: StatusConfig; active: boolean }
+const root = fileURLToPath(new URL('../', import.meta.url))
+const savedFile = (home: string, provider: Client) => path.join(home, '.axmap', 'bridge', `statusline-${provider}.json`)
+function client(value: string): Client { if (value !== 'claude' && value !== 'agy') throw new Error('claude 또는 agy를 지정하세요.'); return value }
+function settings(home: string, provider: Client) { return provider === 'claude' ? path.join(home, '.claude', 'settings.json') : path.join(home, '.gemini', 'antigravity-cli', 'settings.json') }
+
+export function installPipelineStatusline(providerName: string, home = os.homedir(), remove = false) {
+  const provider = client(providerName), target = settings(home, provider), file = savedFile(home, provider)
+  const original = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : null
+  const config: Record<string, unknown> = original === null ? {} : JSON.parse(original)
+  if (!config || typeof config !== 'object' || Array.isArray(config)) throw new Error('기존 설정을 읽지 못했습니다. 변경하지 않았습니다.')
+  const current = config.statusLine as StatusConfig | undefined
+  if (current !== undefined && (!current || typeof current !== 'object' || Array.isArray(current))) throw new Error('기존 statusLine 설정이 객체가 아닙니다. 변경하지 않았습니다.')
+  const owned = typeof current?.command === 'string' && current.command.includes(`axmap-statusline-${provider}`)
+  if (remove && !owned) return { provider, changed: false, note: '다른 상태줄 설정을 유지합니다.' }
+  const saved = fs.existsSync(file) ? readJSON<SavedStatus>(file) : null
+  if (owned && !saved) throw new Error('기존 상태줄 복원 정보를 찾지 못했습니다. 변경하지 않았습니다.')
+  const previous = owned ? saved!.previous : current
+  const script = path.join(root, 'tools', 'pipeline.mjs')
+  const wrapper = path.join(home, '.axmap', 'bridge', `axmap-statusline-${provider}${process.platform === 'win32' ? '.cmd' : '.sh'}`)
+  if (process.platform === 'win32' && [process.execPath, script, wrapper].some(p => /["\r\n%&|<>^!]/.test(p))) throw new Error('상태줄 실행 경로에 지원하지 않는 셸 문자가 있습니다.')
+  if (process.platform === 'win32' && /\s/.test(wrapper)) throw new Error('이 Windows 상태줄 실행 경로에는 공백을 사용할 수 없습니다. 기존 설정을 유지합니다.')
+  const backup = `${target}.axmap-${randomUUID()}.bak`
+  if (original !== null) fs.writeFileSync(backup, original, { mode: 0o600 })
+  writeJSON(file, { previous, active: !remove })
+  if (remove) {
+    if (previous === undefined) delete config.statusLine; else config.statusLine = previous
+  } else {
+    fs.mkdirSync(path.dirname(wrapper), { recursive: true })
+    const quote = (s: string) => `'${s.replaceAll("'", "'\\''")}'`
+    const command = process.platform === 'win32'
+      ? `@echo off\r\n"${process.execPath}" "${script}" statusline --provider ${provider}\r\n`
+      : `#!/bin/sh\nexec ${quote(process.execPath)} ${quote(script)} statusline --provider ${provider}\n`
+    fs.writeFileSync(wrapper, command, { mode: 0o700 })
+    config.statusLine = { ...previous, type: 'command',
+      command: provider === 'claude' ? `"${wrapper.replaceAll('\\', '/')}"` : process.platform === 'win32' ? wrapper : quote(wrapper),
+      ...(provider === 'claude' ? { refreshInterval: previous?.refreshInterval ?? 2 } : { enabled: true, stack_with_default: previous?.stack_with_default ?? true }) }
+  }
+  writeJSON(target, config)
+  return { provider, changed: true, settings: target, backup: original === null ? null : backup,
+    previousPreserved: !!previous, installed: !remove }
+}
+
+function previousOutput(provider: Client, home: string, input: string, previous?: StatusConfig): string {
+  if (typeof previous?.command !== 'string' || !previous.command.trim()) return ''
+  let executable: string, args: string[]
+  if (process.platform === 'win32' && provider === 'claude') {
+    const bash = [process.env.CLAUDE_CODE_GIT_BASH_PATH, path.join(process.env.ProgramFiles || 'C:\\Program Files', 'Git', 'bin', 'bash.exe')].find(p => p && fs.existsSync(p))
+    if (!bash) return '기존 상태줄: Git Bash 경로 확인 필요\n'
+    executable = bash; args = ['-c', previous.command]
+  } else if (process.platform === 'win32') { executable = process.env.ComSpec || 'cmd.exe'; args = ['/d', '/s', '/c', previous.command] }
+  else { executable = '/bin/sh'; args = ['-c', previous.command] }
+  // Only the user's pre-existing command is executed; provider JSON stays on stdin.
+  const options = { input, encoding: 'utf8' as const, windowsHide: true, timeout: 1500, maxBuffer: 65536 }
+  const result = process.platform === 'win32' && provider === 'agy'
+    ? spawnSync(previous.command, { ...options, shell: process.env.ComSpec || 'cmd.exe' })
+    : spawnSync(executable, args, options)
+  return result.stdout || ''
+}
+
+export async function pipelineStatusline(providerName: string, input: string, home = os.homedir()): Promise<string> {
+  const provider = client(providerName), file = savedFile(home, provider)
+  const saved = fs.existsSync(file) ? readJSON<SavedStatus>(file) : null
+  const prior = previousOutput(provider, home, input, saved?.previous)
+  if (saved?.active === false) return prior
+  const payload = JSON.parse(input) as { cwd?: string; workspace?: { current_dir?: string }; conversation_id?: string; session_id?: string;
+    terminal_width?: number; agent_state?: string; tool_confirmation_pending?: boolean }
+  const candidates = new Set([payload.workspace?.current_dir, payload.cwd].filter((p): p is string => typeof p === 'string' && path.isAbsolute(p)))
+  const conversationId = payload.conversation_id || payload.session_id
+  if (conversationId) {
+    const directory = path.join(bridgeHome(), 'sessions')
+    if (fs.existsSync(directory)) for (const name of fs.readdirSync(directory).filter(n => /^[0-9a-f-]{36}\.json$/i.test(n))) {
+      try { const s = readJSON<{ conversationId?: string; workspaces?: string[] }>(path.join(directory, name)); if (s.conversationId === conversationId && s.workspaces?.length === 1) candidates.add(s.workspaces[0]!) } catch { /* a partial record cannot establish scope */ }
+    }
+  }
+  let cwd: string | undefined
+  for (const candidate of candidates) { try { repoKey(candidate); cwd = candidate; break } catch { /* try an explicitly attached workspace */ } }
+  const width = Math.max(20, Math.min(240, Number(payload.terminal_width || process.env.COLUMNS) || 100))
+  let line = 'axMap · 이 대화는 Git 저장소에 연결되지 않았습니다.'
+  if (cwd) {
+    const snapshot = await createMonitor(cwd, { probe: async () => [],
+      resolve: id => readJSON<RequestRecord>(path.join(bridgeHome(), 'requests', `${id}.json`)) })()
+    const active = snapshot.requests.find(r => ['sending', 'submitted', 'unknown'].includes(r.state))
+    const request = active || snapshot.requests[0]
+    const state = payload.tool_confirmation_pending ? '승인 필요' : ({ working: '작업 중', tool_use: '도구 실행', reviewing: '검토 중', idle: '대기', error: '오류', initializing: '시작 중', authenticating: '인증 중' } as Record<string, string>)[payload.agent_state || '']
+    const spin = ['◐', '◓', '◑', '◒'][Math.floor(Date.now() / 300) % 4]
+    const flow = !request ? '새 요청 대기' : request.state === 'completed' ? '접수 ✓ → 전달 ✓ → 응답 ✓ → 완료 ✓' : request.state === 'submitted'
+      ? `접수 ✓ → 전달 ✓ → ${spin} 응답 대기 → 완료 미확정` : request.state === 'sending' ? `${spin} 전달 중 → 응답 대기` : request.state === 'unknown' ? '전달 확인 필요 → 완료 미확정' : `${request.state} → 완료 미확정`
+    line = `axMap${state ? ` · ${provider} ${state}` : ''} · ${!active && request ? '최근 요청 · ' : ''}${flow}`
+    if (snapshot.issues.length) line += ' · 기록 확인 필요'
+  }
+  return prior + (prior && !prior.endsWith('\n') ? '\n' : '') + fitTerminal(terminalText(line), width) + '\n'
+}

package/src/pipeline-web.mjs

@@ -0,0 +1,56 @@
+// Generated from src/pipeline-web.mts. Edit the .mts source and run npm run build.
+/** Read-only loopback view for clients that cannot embed MCP Apps. */
+import http from 'node:http';
+import fs from 'node:fs';
+import { createMonitor } from './monitor.mjs';
+import { pipelineView } from './pipeline-mcp.mjs';
+export async function startPipelineWeb(cwd, port = 0) {
+    if (!Number.isInteger(port) || port < 0 || port > 65535)
+        throw new Error('port must be 0..65535');
+    const collect = createMonitor(cwd);
+    const html = fs.readFileSync(new URL('../mcp/pipeline.html', import.meta.url), 'utf8')
+        .replace('<html lang="ko">', '<html lang="ko" data-axmap-local="true">')
+        .replace('<script>', '<script>window.axmapLocalRead=()=>fetch("/api/snapshot",{cache:"no-store"}).then(r=>{if(!r.ok)throw new Error("Local observation failed");return r.json()});</script><script>');
+    let collecting = null, url = '';
+    const server = http.createServer(async (req, res) => {
+        res.setHeader('Cache-Control', 'no-store');
+        res.setHeader('X-Content-Type-Options', 'nosniff');
+        if (req.headers.host !== new URL(url).host || req.headers.origin && req.headers.origin !== url || req.headers['sec-fetch-site'] === 'cross-site') {
+            res.writeHead(403);
+            res.end('Local origin required');
+            return;
+        }
+        if (req.method !== 'GET') {
+            res.writeHead(405);
+            res.end('Read-only');
+            return;
+        }
+        if (req.url === '/' || req.url === '/pipeline') {
+            res.setHeader('Content-Type', 'text/html; charset=utf-8');
+            res.end(html);
+            return;
+        }
+        if (req.url !== '/api/snapshot') {
+            res.writeHead(404);
+            res.end();
+            return;
+        }
+        try {
+            // Concurrent browser refreshes share observation; none submit a model turn.
+            collecting ??= collect().finally(() => { collecting = null; });
+            const snapshot = await collecting;
+            res.setHeader('Content-Type', 'application/json; charset=utf-8');
+            res.end(JSON.stringify({ structuredContent: pipelineView(snapshot), isError: false }));
+        }
+        catch {
+            res.writeHead(503);
+            res.end(JSON.stringify({ isError: true, content: [{ type: 'text', text: 'Local observation failed' }] }));
+        }
+    });
+    await new Promise((resolve, reject) => { server.once('error', reject); server.listen(port, '127.0.0.1', resolve); });
+    const address = server.address();
+    if (!address || typeof address === 'string')
+        throw new Error('Local listener unavailable');
+    url = `http://127.0.0.1:${address.port}`;
+    return { url: `${url}/pipeline`, close: () => new Promise((resolve, reject) => { server.close(error => error ? reject(error) : resolve()); server.closeIdleConnections(); }) };
+}

package/src/pipeline-web.mts

@@ -0,0 +1,31 @@
+/** Read-only loopback view for clients that cannot embed MCP Apps. */
+import http from 'node:http'
+import fs from 'node:fs'
+import { createMonitor } from './monitor.mjs'
+import { pipelineView } from './pipeline-mcp.mjs'
+export async function startPipelineWeb(cwd: string, port = 0) {
+  if (!Number.isInteger(port) || port < 0 || port > 65535) throw new Error('port must be 0..65535')
+  const collect = createMonitor(cwd)
+  const html = fs.readFileSync(new URL('../mcp/pipeline.html', import.meta.url), 'utf8')
+    .replace('<html lang="ko">', '<html lang="ko" data-axmap-local="true">')
+    .replace('<script>', '<script>window.axmapLocalRead=()=>fetch("/api/snapshot",{cache:"no-store"}).then(r=>{if(!r.ok)throw new Error("Local observation failed");return r.json()});</script><script>')
+  let collecting: ReturnType<typeof collect> | null = null, url = ''
+  const server = http.createServer(async (req, res) => {
+    res.setHeader('Cache-Control', 'no-store'); res.setHeader('X-Content-Type-Options', 'nosniff')
+    if (req.headers.host !== new URL(url).host || req.headers.origin && req.headers.origin !== url || req.headers['sec-fetch-site'] === 'cross-site') { res.writeHead(403); res.end('Local origin required'); return }
+    if (req.method !== 'GET') { res.writeHead(405); res.end('Read-only'); return }
+    if (req.url === '/' || req.url === '/pipeline') { res.setHeader('Content-Type', 'text/html; charset=utf-8'); res.end(html); return }
+    if (req.url !== '/api/snapshot') { res.writeHead(404); res.end(); return }
+    try {
+      // Concurrent browser refreshes share observation; none submit a model turn.
+      collecting ??= collect().finally(() => { collecting = null })
+      const snapshot = await collecting
+      res.setHeader('Content-Type', 'application/json; charset=utf-8'); res.end(JSON.stringify({ structuredContent: pipelineView(snapshot), isError: false }))
+    } catch { res.writeHead(503); res.end(JSON.stringify({ isError: true, content: [{ type: 'text', text: 'Local observation failed' }] })) }
+  })
+  await new Promise<void>((resolve, reject) => { server.once('error', reject); server.listen(port, '127.0.0.1', resolve) })
+  const address = server.address()
+  if (!address || typeof address === 'string') throw new Error('Local listener unavailable')
+  url = `http://127.0.0.1:${address.port}`
+  return { url: `${url}/pipeline`, close: () => new Promise<void>((resolve, reject) => { server.close(error => error ? reject(error) : resolve()); server.closeIdleConnections() }) }
+}