choavis-agent 1.5.23 → 1.5.25

package/CLAUDE.md

@@ -32,6 +32,41 @@ Slack은 단순한 UI일 뿐이다. 너는 이 프로젝트 루트에서 동작
 - `src/slack/` - Slack 연동 (Bolt.js Socket Mode)
 - `src/agent/` - Claude CLI subprocess 관리
 
+## Skills 시스템
+
+`skills/` 디렉토리에 마크다운 파일로 자연어 워크플로우를 정의할 수 있다. 에이전트 실행 시 자동으로 로드되어 systemPrompt에 주입된다.
+
+### 스킬 파일 작성법
+
+`skills/` 디렉토리에 `.md` 파일을 생성한다:
+
+```markdown
+# 스킬 이름
+
+> 트리거: "키워드1", "키워드2"
+
+## 워크플로우
+
+1. 단계 1
+2. 단계 2
+
+## 참고사항
+- 주의점
+```
+
+### 경로 우선순위
+
+1. `AGENT_WORK_DIR/skills/` — 프로젝트별 커스텀 스킬 (우선)
+2. 패키지 내장 `skills/` — 기본 스킬
+
+동일 파일명이면 프로젝트 스킬이 내장 스킬을 덮어쓴다.
+
+### 내장 스킬
+
+- `sprint-review.md` — 스프린트 리뷰 리포트
+- `code-review.md` — 코드 리뷰
+- `incident-report.md` — 장애 포스트모템
+
 ## 응답 스타일
 
 - 간결하고 명확하게 응답

package/dist/agent/adapters/claude.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Claude Adapter
+ *
+ * Claude Code의 StreamEvent를 통합 SessionEvent로 변환하는 어댑터.
+ * runner.ts의 raw NDJSON 스트림을 받아 protocol.ts의 SessionEvent로 emit.
+ */
+import type { StreamEvent } from '../runner.js';
+import type { SessionEvent } from '../protocol.js';
+/**
+ * Claude Code의 StreamEvent async generator를 SessionEvent로 변환
+ */
+export declare function adaptClaude(rawStream: AsyncGenerator<StreamEvent>): AsyncGenerator<SessionEvent>;
+//# sourceMappingURL=claude.d.ts.map

package/dist/agent/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/agent/adapters/claude.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAgC,MAAM,gBAAgB,CAAC;AAiEjF;;GAEG;AACH,wBAAuB,WAAW,CAChC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GACrC,cAAc,CAAC,YAAY,CAAC,CA2J9B"}

package/dist/agent/adapters/claude.js

@@ -0,0 +1,199 @@
+/**
+ * Claude Adapter
+ *
+ * Claude Code의 StreamEvent를 통합 SessionEvent로 변환하는 어댑터.
+ * runner.ts의 raw NDJSON 스트림을 받아 protocol.ts의 SessionEvent로 emit.
+ */
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('adapter:claude');
+/** 파일 관련 도구에서 경로와 액션을 추출 */
+function extractFileInfo(toolName, toolInput) {
+    const filePath = toolInput.file_path ||
+        toolInput.notebook_path ||
+        null;
+    if (!filePath)
+        return null;
+    const actionMap = {
+        Read: 'read',
+        Write: 'write',
+        Edit: 'edit',
+        MultiEdit: 'edit',
+        NotebookEdit: 'edit',
+    };
+    const action = actionMap[toolName];
+    if (!action)
+        return null;
+    return { path: filePath, action };
+}
+/** tool use 이벤트에서 도구 이름과 입력을 추출 (여러 형식 지원) */
+function extractToolUse(raw) {
+    // 형식 1: type === 'tool_use' (tool_name/tool_input)
+    if (raw.type === 'tool_use') {
+        const toolName = raw.tool_name || raw.name || 'unknown';
+        const toolInput = (raw.tool_input || raw.input || {});
+        return { toolName, toolInput };
+    }
+    // 형식 2: content_block_start + content_block.type === 'tool_use'
+    if (raw.type === 'content_block_start') {
+        const block = raw.content_block;
+        if (block?.type === 'tool_use' && block.name) {
+            return {
+                toolName: block.name,
+                toolInput: (block.input || {}),
+            };
+        }
+    }
+    return null;
+}
+/** 에러 이벤트에서 텍스트 메시지를 추출 */
+function extractErrorText(event) {
+    const content = event.message?.content;
+    if (!Array.isArray(content))
+        return 'Unknown error';
+    return content
+        .filter((c) => c.type === 'text')
+        .map((c) => c.text || '')
+        .join('');
+}
+/**
+ * Claude Code의 StreamEvent async generator를 SessionEvent로 변환
+ */
+export async function* adaptClaude(rawStream) {
+    let didEmitTurnStart = false;
+    for await (const raw of rawStream) {
+        const ts = Date.now();
+        // system/init → start
+        if (raw.type === 'system' && raw.subtype === 'init') {
+            yield {
+                type: 'start',
+                timestamp: ts,
+                sessionId: raw.session_id,
+                _raw: raw,
+            };
+            continue;
+        }
+        // assistant → turn-start (첫 번째만) + text(replace: true)
+        if (raw.type === 'assistant') {
+            if (!didEmitTurnStart) {
+                didEmitTurnStart = true;
+                yield { type: 'turn-start', timestamp: ts };
+            }
+            const msg = raw.message;
+            if (msg?.content && Array.isArray(msg.content)) {
+                const fullText = msg.content
+                    .filter((block) => block.type === 'text' && block.text)
+                    .map((block) => block.text)
+                    .join('');
+                if (fullText) {
+                    yield {
+                        type: 'text',
+                        timestamp: ts,
+                        text: { content: fullText, replace: true },
+                        _raw: raw,
+                    };
+                }
+                // assistant 메시지 content에서 tool_use 블록도 추출
+                for (const block of msg.content) {
+                    if (block.type === 'tool_use' && block.name) {
+                        const toolInput = (block.input || {});
+                        yield {
+                            type: 'tool-call-start',
+                            timestamp: ts,
+                            tool: { toolName: block.name, toolInput },
+                        };
+                        const fileInfo = extractFileInfo(block.name, toolInput);
+                        if (fileInfo) {
+                            yield { type: 'file', timestamp: ts, file: fileInfo };
+                        }
+                    }
+                }
+            }
+            continue;
+        }
+        // content_block_delta → text(replace: false)
+        if (raw.type === 'content_block_delta' && raw.delta?.text) {
+            if (!didEmitTurnStart) {
+                didEmitTurnStart = true;
+                yield { type: 'turn-start', timestamp: ts };
+            }
+            yield {
+                type: 'text',
+                timestamp: ts,
+                text: { content: raw.delta.text, replace: false },
+                _raw: raw,
+            };
+            continue;
+        }
+        // tool_use → tool-call-start + optional file
+        // Claude Code stream-json은 여러 형식으로 tool use를 보낼 수 있음:
+        // 1. type: 'tool_use' (tool_name/tool_input 또는 name/input)
+        // 2. type: 'content_block_start' + content_block.type === 'tool_use'
+        {
+            const toolInfo = extractToolUse(raw);
+            if (toolInfo) {
+                yield {
+                    type: 'tool-call-start',
+                    timestamp: ts,
+                    tool: toolInfo,
+                    _raw: raw,
+                };
+                // 파일 관련 도구면 file 이벤트도 emit
+                const fileInfo = extractFileInfo(toolInfo.toolName, toolInfo.toolInput);
+                if (fileInfo) {
+                    yield {
+                        type: 'file',
+                        timestamp: ts,
+                        file: fileInfo,
+                    };
+                }
+                continue;
+            }
+        }
+        // result → turn-end
+        if (raw.type === 'result') {
+            const turnEnd = {
+                type: 'turn-end',
+                timestamp: ts,
+                sessionId: raw.session_id,
+                turn: {
+                    result: raw.result,
+                },
+                _raw: raw,
+            };
+            if (raw.usage) {
+                turnEnd.turn.usage = {
+                    inputTokens: raw.usage.input_tokens || 0,
+                    outputTokens: raw.usage.output_tokens || 0,
+                    model: raw.model,
+                };
+            }
+            yield turnEnd;
+            // 다음 턴을 위해 리셋
+            didEmitTurnStart = false;
+            continue;
+        }
+        // error → service
+        if (raw.type === 'error') {
+            const message = extractErrorText(raw);
+            const errorType = raw.errorType;
+            const retryable = errorType === 'transient';
+            yield {
+                type: 'service',
+                timestamp: ts,
+                service: {
+                    message,
+                    severity: 'error',
+                    errorType,
+                    retryable,
+                },
+                _raw: raw,
+            };
+            continue;
+        }
+        // 그 외 이벤트 디버그 로그 (tool_use 관련 이벤트를 놓치고 있는지 확인용)
+        if (raw.type !== 'content_block_delta' && raw.type !== 'content_block_stop') {
+            log.info('unhandled event', { type: raw.type, subtype: raw.subtype });
+        }
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/agent/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/agent/adapters/claude.ts"],"names":[],"mappings":"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"}

package/dist/agent/memory.d.ts

@@ -0,0 +1,13 @@
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    createdAt: string;
+}
+export interface MemoryStore {
+    entries: MemoryEntry[];
+}
+export declare function addMemory(baseDir: string, content: string): Promise<MemoryEntry>;
+export declare function listMemories(baseDir: string): Promise<MemoryEntry[]>;
+export declare function deleteMemory(baseDir: string, memoryId: string): Promise<boolean>;
+export declare function buildMemoryContext(baseDir: string): Promise<string>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/agent/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/agent/memory.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AA+BD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAYtF;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAI1E;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQtF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASzE"}

package/dist/agent/memory.js

@@ -0,0 +1,70 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('memory');
+function getFilePath(baseDir) {
+    return join(baseDir, 'memories.json');
+}
+async function ensureDir(baseDir) {
+    if (!existsSync(baseDir)) {
+        await mkdir(baseDir, { recursive: true });
+    }
+}
+async function loadStore(filePath) {
+    if (!existsSync(filePath))
+        return { entries: [] };
+    try {
+        const data = await readFile(filePath, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        log.warn('메모리 파일 파싱 실패', { filePath });
+        return { entries: [] };
+    }
+}
+async function saveStore(filePath, store) {
+    await writeFile(filePath, JSON.stringify(store, null, 2));
+}
+function generateId() {
+    return Date.now().toString(36) + Math.random().toString(36).slice(2, 6);
+}
+export async function addMemory(baseDir, content) {
+    await ensureDir(baseDir);
+    const filePath = getFilePath(baseDir);
+    const store = await loadStore(filePath);
+    const entry = {
+        id: generateId(),
+        content,
+        createdAt: new Date().toISOString(),
+    };
+    store.entries.push(entry);
+    await saveStore(filePath, store);
+    return entry;
+}
+export async function listMemories(baseDir) {
+    const filePath = getFilePath(baseDir);
+    const store = await loadStore(filePath);
+    return store.entries;
+}
+export async function deleteMemory(baseDir, memoryId) {
+    const filePath = getFilePath(baseDir);
+    const store = await loadStore(filePath);
+    const idx = store.entries.findIndex((e) => e.id === memoryId);
+    if (idx === -1)
+        return false;
+    store.entries.splice(idx, 1);
+    await saveStore(filePath, store);
+    return true;
+}
+export async function buildMemoryContext(baseDir) {
+    const entries = await listMemories(baseDir);
+    if (entries.length === 0)
+        return '';
+    const lines = ['[기억 컨텍스트]'];
+    for (const e of entries) {
+        lines.push(`- ${e.content}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=memory.js.map

package/dist/agent/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/agent/memory.ts"],"names":[],"mappings":"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"}

package/dist/agent/process-pool.d.ts

@@ -0,0 +1,61 @@
+import { type ChildProcess } from 'node:child_process';
+import { type Interface } from 'node:readline';
+import type { StreamEvent } from './runner.js';
+export interface SpawnOptions {
+    sessionId?: string;
+    workDir?: string;
+    permissionMode?: string;
+    allowedTools?: string[];
+    approvalPort?: number;
+}
+export interface PoolEntry {
+    proc: ChildProcess;
+    rl: Interface;
+    threadTs: string;
+    idleTimer: NodeJS.Timeout | null;
+    lastActivityAt: number;
+    spawnOptions: SpawnOptions;
+    /** 현재 턴의 라인 콜백 (null이면 턴 진행 중 아님) */
+    lineHandler: ((line: string) => void) | null;
+    /** 프로세스 종료 콜백 */
+    closeHandler: ((code: number | null) => void) | null;
+    stderrChunks: string[];
+    stderrBytes: number;
+}
+export declare class ProcessPool {
+    private pool;
+    /** 풀에 해당 threadTs의 프로세스가 존재하는지 */
+    has(threadTs: string): boolean;
+    /** 현재 풀 크기 */
+    get size(): number;
+    /**
+     * threadTs에 해당하는 프로세스를 반환한다.
+     * 기존 프로세스가 살아있으면 재사용하고, 없거나 죽었으면 새로 spawn한다.
+     */
+    acquire(threadTs: string, spawnOptions: SpawnOptions): PoolEntry;
+    /**
+     * threadTs 프로세스를 idle 상태로 전환한다.
+     * processIdleTimeout 후에 자동으로 프로세스를 종료한다.
+     */
+    release(threadTs: string): void;
+    /**
+     * threadTs 프로세스를 강제 종료하고 pool에서 제거한다.
+     * SIGTERM → 5초 후 SIGKILL 순서.
+     */
+    kill(threadTs: string): void;
+    /**
+     * 모든 프로세스를 종료한다 (graceful shutdown).
+     */
+    cleanup(): void;
+    private spawnProcess;
+    private removeEntry;
+}
+/**
+ * entry의 stdin에 user_message를 쓰고,
+ * stdout에서 NDJSON 라인을 읽어 StreamEvent로 yield한다.
+ * `result` 타입 이벤트를 만나면 yield 후 return (턴 종료).
+ * 프로세스가 종료되면 에러 이벤트를 yield한다.
+ */
+export declare function sendTurn(entry: PoolEntry, prompt: string, abortSignal?: AbortSignal): AsyncGenerator<StreamEvent>;
+export declare const processPool: ProcessPool;
+//# sourceMappingURL=process-pool.d.ts.map

package/dist/agent/process-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-pool.d.ts","sourceRoot":"","sources":["../../src/agent/process-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAGhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU/C,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,SAAS,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,qCAAqC;IACrC,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7C,iBAAiB;IACjB,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACrD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAgC;IAE5C,kCAAkC;IAClC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B,cAAc;IACd,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,SAAS;IA2ChE;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAmB/B;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IA0B5B;;OAEG;IACH,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,YAAY;IA2FpB,OAAO,CAAC,WAAW;CAepB;AAMD;;;;;GAKG;AACH,wBAAuB,QAAQ,CAC7B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,WAAW,GACxB,cAAc,CAAC,WAAW,CAAC,CAgH7B;AAMD,eAAO,MAAM,WAAW,aAAoB,CAAC"}