@tuzi-ince/hi-loop 0.3.0 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuzi-ince/hi-loop",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "CLI와 MCP 모드를 지원하는 초경량 자율형 자가 치유 엔진",
   "type": "module",
   "license": "MIT",

package/src/mcp-server.js

@@ -14,6 +14,17 @@ const log = (line) => process.stderr.write(`[hi-loop-mcp] ${line}\n`);
 const text = (t) => ({ content: [{ type: 'text', text: t }] });
 const fail = (t) => ({ content: [{ type: 'text', text: t }], isError: true });
 
+/**
+ * MCP 경로의 기본 작업 디렉터리.
+ *
+ * CLI 는 `process.cwd()` 만 본다 — 터미널에서 cd 한 곳이 곧 사용자의 명시 의도이기 때문이다.
+ * 그러나 MCP 는 호스트(클로드코드/커서)가 서버를 띄우는 경로이고, "어느 프로젝트인가"의
+ * 정답은 호스트가 주입하는 `CLAUDE_PROJECT_DIR` 다. 서버 프로세스의 cwd 가 프로젝트 루트와
+ * 다른 호스트에서도 올바른 루트를 잡으려면 이 env 를 먼저 본다. 호출자가 cwd 를 명시하면
+ * 그것이 최우선이다(각 핸들러의 인자가 이 기본값을 덮는다).
+ */
+const defaultCwd = () => process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
 /** 도구 구현 (SDK 없이도 단위 테스트 가능하도록 분리) */
 export const tools = {
   hiloop_run: {
@@ -28,7 +39,7 @@ export const tools = {
       ship,
       watch,
       stopAfter,
-      cwd = process.cwd(),
+      cwd = defaultCwd(),
     }) => {
       if (!goal) return fail('goal 은 필수입니다.');
       const result = await runLoop({
@@ -66,7 +77,7 @@ export const tools = {
   hiloop_answer: {
     description:
       'hiloop_run 이 반환한 대기 중인 질문에 답한다. choice 는 제시된 선택지의 키(a, b, ...)이고, note 로 자유 서술을 덧붙이거나 대신할 수 있다. 답한 뒤 hiloop_run 을 같은 goal 로 다시 호출하면 이어서 진행된다.',
-    handler: async ({ choice, note = '', cwd = process.cwd() } = {}) => {
+    handler: async ({ choice, note = '', cwd = defaultCwd() } = {}) => {
       const statePath = statePathFor(cwd);
       const state = loadState(statePath);
       if (!state?.ask) return fail('대기 중인 질문이 없습니다.');
@@ -79,17 +90,17 @@ export const tools = {
   },
   hiloop_status: {
     description: '현재 워크스페이스의 .agent-state.json 루프 상태 요약을 반환한다.',
-    handler: async ({ cwd = process.cwd() } = {}) => text(summarizeState(loadState(statePathFor(cwd)))),
+    handler: async ({ cwd = defaultCwd() } = {}) => text(summarizeState(loadState(statePathFor(cwd)))),
   },
   hiloop_reset: {
     description: '.agent-state.json 을 삭제해 루프 상태를 초기화한다.',
-    handler: async ({ cwd = process.cwd() } = {}) =>
+    handler: async ({ cwd = defaultCwd() } = {}) =>
       text(resetState(statePathFor(cwd)) ? '상태를 초기화했습니다.' : '초기화할 상태가 없습니다.'),
   },
   hiloop_rollback: {
     description:
       'git 체크포인트로 파일을 되돌린다. to(회차)를 주면 그 회차 직전 스냅샷으로, 없으면 가장 최근 체크포인트로 복원한다.',
-    handler: async ({ to, cwd = process.cwd() } = {}) => {
+    handler: async ({ to, cwd = defaultCwd() } = {}) => {
       const state = loadState(statePathFor(cwd));
       const checkpoints = state?.checkpoints ?? [];
       if (checkpoints.length === 0)
@@ -112,7 +123,7 @@ export const tools = {
   hiloop_setup: {
     description:
       '프로젝트에 hi-loop 설정(.mcp.json MCP 서버 등록, .gitignore 항목, docs/tests 디렉터리)을 자동 주입한다. dryRun 이면 변경 없이 계획만 보여준다.',
-    handler: async ({ dryRun = false, cwd = process.cwd() } = {}) => {
+    handler: async ({ dryRun = false, cwd = defaultCwd() } = {}) => {
       const report = runSetup({ cwd, dryRun: Boolean(dryRun) });
       return text(report.lines.join('\n'));
     },
@@ -147,7 +158,10 @@ export async function startMcpServer({ version = '0.1.0' } = {}) {
   }
 
   const server = new McpServer({ name: 'hi-loop', version });
-  const cwdSchema = z.string().optional().describe('작업 디렉터리 (기본: 서버 프로세스의 cwd)');
+  const cwdSchema = z
+    .string()
+    .optional()
+    .describe('작업 디렉터리 (기본: CLAUDE_PROJECT_DIR → 없으면 서버 프로세스의 cwd)');
 
   server.registerTool(
     'hiloop_run',