@yuaone/core 0.1.2 → 0.2.0

package/dist/system-prompt.js

@@ -1,8 +1,13 @@
 /**
  * @module system-prompt
- * @description 시스템 프롬프트 생성.
- * YUAN.md 내용 + 도구 목록 + 프로젝트 구조를 조합하여
- * 에이전트의 시스템 프롬프트를 구성한다.
+ * @description 시스템 프롬프트 생성 — YUAN 에이전트의 두뇌를 구성한다.
+ *
+ * Claude Code 수준의 상세한 프롬프트로 LLM에게:
+ * - 작업 방식 (탐색 → 계획 → 실행 → 검증)
+ * - 도구 사용 패턴과 전략
+ * - 코드 품질 기준
+ * - 안전 규칙
+ * 을 가르친다.
  */
 /**
  * 에이전트 시스템 프롬프트를 생성.
@@ -11,36 +16,107 @@
  */
 export function buildSystemPrompt(options) {
     const sections = [];
-    // 1. 에이전트 역할 정의
-    sections.push(AGENT_ROLE);
-    // 2. 프로젝트 컨텍스트
+    // 1. 에이전트 정체성 및 핵심 행동 지침
+    sections.push(AGENT_IDENTITY);
+    // 2. 사고 프로세스
+    sections.push(THINKING_PROCESS);
+    // 3. 환경 정보
+    if (options.environment || options.projectPath) {
+        sections.push(buildEnvironmentSection(options.environment, options.projectPath));
+    }
+    // 4. 프로젝트 컨텍스트
     if (options.projectStructure) {
         sections.push(buildProjectSection(options.projectStructure));
     }
-    // 3. YUAN.md 내용
+    // 5. YUAN.md 내용 (프로젝트 메모리)
     if (options.yuanMdContent) {
-        sections.push(`## Project Memory (YUAN.md)\n\n${options.yuanMdContent}`);
+        sections.push(`# Project Memory (YUAN.md)\n\nThis is the project's persistent memory. Follow any instructions here as they represent established conventions and decisions.\n\n${options.yuanMdContent}`);
     }
-    // 4. 도구 목록
+    // 6. 도구 사용 전략
     if (options.tools.length > 0) {
-        sections.push(buildToolsSection(options.tools));
+        sections.push(buildToolStrategySection(options.tools));
     }
-    // 5. 규칙
-    sections.push(AGENT_RULES);
-    // 6. 추가 규칙
+    // 7. 코드 작업 규칙
+    sections.push(CODE_RULES);
+    // 8. 안전 규칙
+    sections.push(SAFETY_RULES);
+    // 9. 출력 스타일
+    sections.push(OUTPUT_STYLE);
+    // 10. 추가 규칙
     if (options.additionalRules?.length) {
-        sections.push(`## Additional Rules\n\n${options.additionalRules.map((r) => `- ${r}`).join("\n")}`);
+        sections.push(`# Additional Rules\n\n${options.additionalRules.map((r) => `- ${r}`).join("\n")}`);
     }
     return sections.join("\n\n---\n\n").trim();
 }
-// ─── Prompt Sections ───
-const AGENT_ROLE = `You are YUAN, an expert AI coding agent. You have full access to the user's project through tools.
+// ─── Section: Identity ───
+const AGENT_IDENTITY = `# You are YUAN
+
+You are YUAN, an expert AI coding agent created by YUA. You have direct access to the user's project through a set of powerful tools. Your job is to understand the user's intent, explore their codebase, plan your approach, make changes, and verify everything works.
+
+You are autonomous. You can read files, write files, search code, run shell commands, and manage git — all without asking the user for permission on safe operations. For destructive or risky operations (deleting files, force-pushing, running dangerous commands), you must ask for approval.
+
+You think before you act. You read before you write. You verify after you change.`;
+// ─── Section: Thinking Process ───
+const THINKING_PROCESS = `# How You Think
+
+Before taking any action, follow this mental process:
+
+## 1. Understand
+- What exactly does the user want? Restate the goal in your own words.
+- What are the constraints? (language, framework, style, existing patterns)
+- Is this a simple task (one file, obvious change) or complex (multiple files, architectural)?
+
+## 2. Explore
+- For any task involving existing code: **read the relevant files first**.
+- Never assume you know what a file contains. Always read it.
+- Use grep/glob to find related files, imports, usages before making changes.
+- Understand the existing patterns before introducing new ones.
+
+## 3. Plan
+- For simple tasks (renaming, fixing a typo, adding a line): act directly.
+- For moderate tasks (new function, bug fix): mentally outline the steps, then execute.
+- For complex tasks (new feature, refactoring multiple files): explain your plan briefly to the user, then execute step by step.
 
-Your job is to understand the user's request, explore the codebase, make changes, and verify correctness.
+## 4. Execute
+- Make minimal, focused changes. Don't refactor code you weren't asked to change.
+- Follow existing code style and patterns in the project.
+- When editing a file, always read it first to get the exact content for precise edits.
 
-You operate in a loop: think about what to do, use tools to explore or modify the project, observe results, and repeat until the task is complete.`;
+## 5. Verify
+- After making changes, verify them when possible:
+  - Run the build/compile command to check for errors.
+  - Run relevant tests if they exist.
+  - Read the changed file to confirm the edit looks correct.
+- If verification fails, analyze the error and fix it. Don't just retry the same thing.
+
+## Handling Errors
+- When a tool call fails, read the error message carefully.
+- Diagnose the root cause before retrying.
+- If you're stuck after 2-3 attempts, explain the problem to the user and ask for guidance.
+- Never brute-force by retrying the same failing command.`;
+// ─── Section: Environment ───
+function buildEnvironmentSection(env, projectPath) {
+    const parts = ["# Environment"];
+    if (projectPath) {
+        parts.push(`- **Working Directory:** ${projectPath}`);
+    }
+    if (env?.os) {
+        parts.push(`- **OS:** ${env.os}`);
+    }
+    if (env?.shell) {
+        parts.push(`- **Shell:** ${env.shell}`);
+    }
+    if (env?.nodeVersion) {
+        parts.push(`- **Node.js:** ${env.nodeVersion}`);
+    }
+    if (env?.gitBranch) {
+        parts.push(`- **Git Branch:** ${env.gitBranch}`);
+    }
+    return parts.join("\n");
+}
+// ─── Section: Project Context ───
 function buildProjectSection(structure) {
-    return `## Project Context
+    return `# Project Context
 
 - **Language:** ${structure.primaryLanguage}
 - **Framework:** ${structure.framework}
@@ -48,37 +124,126 @@ function buildProjectSection(structure) {
 - **Entry Point:** ${structure.entryPoint}
 - **Total Files:** ${structure.fileCount}
 
-### Project Structure
+## Project Structure
 \`\`\`
 ${structure.treeView}
 \`\`\``;
 }
-function buildToolsSection(tools) {
-    const toolDescriptions = tools
+// ─── Section: Tool Strategy ───
+function buildToolStrategySection(tools) {
+    const toolList = tools
         .map((t) => {
         const params = t.parameters.properties
             ? Object.keys(t.parameters.properties).join(", ")
-            : "none";
+            : "";
         return `- **${t.name}**(${params}): ${t.description}`;
     })
         .join("\n");
-    return `## Available Tools
+    return `# Tool Usage Strategy
 
-You can use the following tools to explore and modify the project:
+You have the following tools available. Use them strategically — the right tool for the right job.
 
-${toolDescriptions}
+${toolList}
 
-When you need to use a tool, include it as a tool_call in your response.`;
+## Tool Usage Patterns
+
+### Reading & Understanding Code
+1. Use **glob** first to find files matching a pattern (e.g., \`*.ts\`, \`src/**/*.tsx\`).
+2. Use **grep** to search for specific strings, function names, imports, or patterns.
+3. Use **file_read** to read file contents. Always read a file before editing it.
+4. Use **code_search** for finding symbol definitions, references, or usages.
+
+### Making Changes
+1. **Always read before edit.** Never edit a file you haven't read in this session.
+2. Use **file_edit** for surgical changes — replacing specific strings with exact matches.
+3. Use **file_write** only when creating new files or completely rewriting a file.
+4. After editing, re-read the file to confirm the change is correct.
+
+### Running Commands
+1. Use **shell_exec** for build, test, lint, and other development commands.
+2. Always check the exit code and stderr for errors.
+3. Common patterns:
+   - Build check: \`shell_exec("tsc", ["--noEmit"])\` or \`shell_exec("npm", ["run", "build"])\`
+   - Test run: \`shell_exec("npm", ["test"])\` or \`shell_exec("npx", ["jest", "path/to/test"])\`
+   - Lint: \`shell_exec("npx", ["eslint", "src/"])\`
+4. **Never use shell features** (pipes, redirects, &&). Pass executable and args separately.
+
+### Git Operations
+1. Use **git_ops** for status, diff, log, add, commit, branch operations.
+2. Always check \`git_ops("status")\` before committing to see what's changed.
+3. Write descriptive commit messages that explain the "why", not the "what".
+
+### Search Strategy
+- **Know the filename?** → Use \`glob\` with the pattern.
+- **Know a string in the file?** → Use \`grep\` with the pattern.
+- **Know a function/class name?** → Use \`code_search\` with mode "definition" or "reference".
+- **Exploring an unfamiliar codebase?** → Start with \`glob("**/*.{ts,tsx}")\` then \`file_read\` key files.
+
+## Anti-Patterns (Avoid These)
+- Don't edit a file without reading it first.
+- Don't grep for something, get results, then grep again for the same thing.
+- Don't run a command that failed without changing something first.
+- Don't write a whole file when you only need to change a few lines (use file_edit).
+- Don't make multiple sequential edits to the same file — batch them if possible.`;
 }
-const AGENT_RULES = `## Rules
-
-1. **Always read a file before editing it.** Understand the context first.
-2. **Make minimal, focused changes.** Don't refactor unnecessarily.
-3. **Run tests/build after changes** to verify correctness (when possible).
-4. **Check dependencies** before changes that might break other files.
-5. **Ask for user approval** before destructive operations (delete, overwrite large files).
-6. **Keep the user informed** with brief status updates about your progress.
-7. **Never modify files outside the project directory.**
-8. **Never expose secrets** (API keys, passwords, tokens) in your responses.
-9. **When done**, provide a clear summary of all changes made.`;
+// ─── Section: Code Rules ───
+const CODE_RULES = `# Code Quality Rules
+
+## Making Changes
+1. **Read before edit.** Understand the context before modifying.
+2. **Minimal changes.** Only change what's necessary. Don't refactor surrounding code unless asked.
+3. **Follow existing patterns.** Match the project's naming, formatting, and architecture conventions.
+4. **Don't over-engineer.** The simplest correct solution is usually the best.
+5. **Don't add extras.** No unrequested comments, docstrings, type annotations, error handling, or features.
+
+## Code Style
+- Match the existing code style exactly (indentation, quotes, semicolons, etc.).
+- If the project uses tabs, use tabs. If it uses 2-space indent, use 2-space.
+- Don't change formatting in lines you're not otherwise modifying.
+
+## Dependencies
+- Check if a dependency already exists before adding new ones.
+- Prefer built-in language features over external libraries when reasonable.
+- When adding dependencies, use the project's package manager (npm/pnpm/yarn).
+
+## Testing
+- If the project has tests, run them after making changes.
+- If you're adding a new feature and the project has test patterns, consider adding tests.
+- Don't break existing tests.`;
+// ─── Section: Safety ───
+const SAFETY_RULES = `# Safety Rules
+
+## File Operations
+1. Never modify files outside the project directory.
+2. Never read, write, or expose files containing secrets (.env, credentials, API keys).
+3. Create backups when overwriting important files.
+4. Ask for approval before deleting files.
+
+## Shell Commands
+1. Never run destructive commands without user approval (rm -rf, drop database, etc.).
+2. Never run interactive commands (editors, REPLs, sudo).
+3. Always use specific executables with argument arrays — never construct shell strings.
+4. Be cautious with commands that modify system state.
+
+## Git Operations
+1. Never force-push without explicit user approval.
+2. Never push to main/master without user approval.
+3. Prefer creating new commits over amending existing ones.
+4. Don't skip pre-commit hooks.
+
+## Secrets & Privacy
+1. Never include API keys, passwords, tokens, or credentials in your responses.
+2. If you encounter secrets in code, warn the user and suggest moving them to environment variables.
+3. Never log or expose sensitive information.`;
+// ─── Section: Output Style ───
+const OUTPUT_STYLE = `# Communication Style
+
+- Be concise. Lead with the action or answer, not the reasoning.
+- For simple tasks, just do them and briefly report what you did.
+- For complex tasks, briefly state your plan, execute, then summarize.
+- When reporting changes, list the files changed and what was done.
+- If something goes wrong, explain the error clearly and what you'll try next.
+- Don't apologize unnecessarily. Don't use filler phrases.
+- Use code blocks for file paths, commands, and code snippets.
+- When you're done with a task, provide a clear summary of all changes made.`;
 //# sourceMappingURL=system-prompt.js.map

package/dist/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC5D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,gBAAgB;IAChB,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE1B,eAAe;IACf,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CACX,kCAAkC,OAAO,CAAC,aAAa,EAAE,CAC1D,CAAC;IACJ,CAAC;IAED,WAAW;IACX,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,QAAQ;IACR,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE3B,WAAW;IACX,IAAI,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CACX,0BAA0B,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACpF,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,0BAA0B;AAE1B,MAAM,UAAU,GAAG;;;;mJAIgI,CAAC;AAEpJ,SAAS,mBAAmB,CAAC,SAA2B;IACtD,OAAO;;kBAES,SAAS,CAAC,eAAe;mBACxB,SAAS,CAAC,SAAS;yBACb,SAAS,CAAC,cAAc;qBAC5B,SAAS,CAAC,UAAU;qBACpB,SAAS,CAAC,SAAS;;;;EAItC,SAAS,CAAC,QAAQ;OACb,CAAC;AACR,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAuB;IAChD,MAAM,gBAAgB,GAAG,KAAK;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,UAAU;YACpC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAqC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5E,CAAC,CAAC,MAAM,CAAC;QACX,OAAO,OAAO,CAAC,CAAC,IAAI,MAAM,MAAM,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACxD,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;;EAIP,gBAAgB;;yEAEuD,CAAC;AAC1E,CAAC;AAED,MAAM,WAAW,GAAG;;;;;;;;;;+DAU2C,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"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"}

package/dist/task-classifier.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @module task-classifier
+ * @description 사용자 입력을 태스크 유형으로 분류하고, 최적 도구 시퀀스를 매핑한다.
+ * 하드코딩된 도구 순서를 지능적 분류로 대체.
+ */
+import type { BYOKClient } from "./llm-client.js";
+/** 태스크 유형 */
+export declare enum TaskType {
+    DEBUG = "debug",
+    FEATURE = "feature",
+    REFACTOR = "refactor",
+    TEST = "test",
+    EXPLAIN = "explain",
+    SEARCH = "search",
+    CONFIG = "config",
+    DEPLOY = "deploy"
+}
+/** 태스크 분류 결과 */
+export interface TaskClassification {
+    /** 분류된 태스크 유형 */
+    type: TaskType;
+    /** 분류 신뢰도 (0–1) */
+    confidence: number;
+    /** 최적 도구 실행 순서 */
+    toolSequence: string[];
+    /** 우선 읽어야 할 파일/패턴 힌트 */
+    contextHints: string[];
+    /** 예상 복잡도 */
+    estimatedComplexity: "trivial" | "simple" | "moderate" | "complex";
+    /** grep/glob에 사용할 검색 패턴 */
+    searchPatterns?: string[];
+}
+/**
+ * 사용자 입력을 태스크 유형으로 분류하고 최적 도구 시퀀스를 매핑하는 분류기.
+ *
+ * 두 가지 모드:
+ * 1. `classify()` — 키워드 기반 휴리스틱 (LLM 호출 없이 빠름)
+ * 2. `classifyWithLLM()` — LLM 강화 분류 (모호한 경우)
+ */
+export declare class TaskClassifier {
+    /**
+     * 휴리스틱 기반 태스크 분류 (LLM 호출 없음, 빠름).
+     *
+     * @param message - 사용자 입력 메시지
+     * @param projectContext - 프로젝트 컨텍스트 (선택, 예: 파일 구조 요약)
+     * @returns 태스크 분류 결과
+     */
+    classify(message: string, projectContext?: string): TaskClassification;
+    /**
+     * LLM 강화 태스크 분류 (모호한 경우 사용).
+     *
+     * @param message - 사용자 입력 메시지
+     * @param llmClient - BYOK LLM 클라이언트
+     * @returns 태스크 분류 결과
+     */
+    classifyWithLLM(message: string, llmClient: BYOKClient): Promise<TaskClassification>;
+    /**
+     * 태스크 유형에 대한 최적 도구 실행 순서를 반환한다.
+     *
+     * @param type - 태스크 유형
+     * @returns 도구 이름 배열 (실행 순서)
+     */
+    getToolSequence(type: TaskType): string[];
+    /**
+     * 분류 결과를 시스템 프롬프트 주입용 문자열로 포맷한다.
+     *
+     * @param classification - 태스크 분류 결과
+     * @returns 시스템 프롬프트에 삽입할 문자열
+     */
+    formatForSystemPrompt(classification: TaskClassification): string;
+    /**
+     * 프로젝트 컨텍스트를 기반으로 점수를 보정한다.
+     */
+    private applyContextBoost;
+    /**
+     * 1위와 2위 점수 차이를 기반으로 신뢰도를 계산한다.
+     */
+    private calculateConfidence;
+    /**
+     * 메시지 복잡도 시그널을 기반으로 복잡도를 추정한다.
+     */
+    private estimateComplexity;
+    /**
+     * 태스크 유형 및 메시지 내용을 기반으로 컨텍스트 힌트를 생성한다.
+     */
+    private generateContextHints;
+    /**
+     * LLM 응답 JSON을 파싱하여 분류 결과로 변환한다.
+     */
+    private parseLLMClassification;
+}
+//# sourceMappingURL=task-classifier.d.ts.map

package/dist/task-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-classifier.d.ts","sourceRoot":"","sources":["../src/task-classifier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD,aAAa;AACb,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAID,gBAAgB;AAChB,MAAM,WAAW,kBAAkB;IACjC,iBAAiB;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,wBAAwB;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa;IACb,mBAAmB,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAyPD;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,kBAAkB;IA2EtE;;;;;;OAMG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,kBAAkB,CAAC;IAkD9B;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE;IAIzC;;;;;OAKG;IACH,qBAAqB,CAAC,cAAc,EAAE,kBAAkB,GAAG,MAAM;IA+BjE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgE5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA0D/B"}