deel-local-cli 0.5.0 → 0.8.0

package/src/commands.js

@@ -1,13 +1,20 @@
 // 슬래시 명령. 이름은 Claude Code / Codex 관례에 맞춘다.
 import { writeFileSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
-import { c, say, rule, pad, bar, mark, width } from './ui/ansi.js';
+import { c, say, rule, pad, bar, mark, width, clip } from './ui/ansi.js';
+import { compact } from './agent/compact.js';
+import { allowEndpoint } from './safety/network.js';
 import { pick } from './ui/prompt.js';
-import { load, save, resolveKey } from './config.js';
+import { load, save, resolveKey, upsert } from './config.js';
 import { TOOLS } from './tools/index.js';
-import { loadCommand } from './skills/discover.js';
-
-const THINK_LEVELS = ['off', 'low', 'medium', 'high', 'max'];
+import { loadCommand, discover } from './skills/discover.js';
+import { install, list, remove, pack } from './plugins/manage.js';
+import { spin } from './ui/spinner.js';
+import { PROFILES, LEVELS as THINK_LEVELS, normalizeProfile, table as effortTable } from './agent/effort.js';
+import { scanLocal, toProfiles } from './backend/scan.js';
+import { list as listSessions } from './agent/store.js';
+import { MODES as WORK_MODES, ORDER as WORK_ORDER, normalize as normWork, get as getWork, canWrite } from './agent/modes.js';
+import { LEVELS, ORDER as LEVEL_ORDER, DEFAULT as LEVEL_DEFAULT, normalize as normLevel, shows as levelShows } from './ui/level.js';
 const MODES = {
   auto: '자율 — 전부 알아서. 되돌리기가 안전망',
   confirm: '확인 — 되돌릴 수 없는 것만 물어봄',
@@ -21,12 +28,23 @@ export const COMMANDS = {
   compact: { desc: '오래된 대화 줄이기' },
   model:   { desc: '모델·연결 바꾸기' },
   think:   { desc: '추론 강도 (off/low/medium/high/max)', arg: '<수준>' },
-  mode:    { desc: '실행 모드 (auto/confirm/strict)', arg: '<모드>' },
+  mode:    { desc: '승인 정책 — 얼마나 물어보나 (auto/confirm/strict)', arg: '<모드>' },
+  work:    { desc: '작업 모드 — 무슨 일을 하는 중인가', arg: '[모드]' },
+  code:    { desc: '작업 모드 → 코드 (고치고 만든다)' },
+  plan:    { desc: '작업 모드 → 계획 (먼저 계획만)' },
+  architect:{ desc: '작업 모드 → 설계 (구조를 짠다)' },
+  debug:   { desc: '작업 모드 → 디버그 (원인을 찾는다)' },
+  ask:     { desc: '작업 모드 → 묻기 (설명만)' },
+  orchestrator: { desc: '작업 모드 → 총괄 (큰 일을 쪼개서)' },
   undo:    { desc: '직전 작업 되돌리기', arg: '[턴수]' },
   tools:   { desc: '쓸 수 있는 도구 보기' },
   skills:  { desc: '스킬 보기·검색·골라 올리기', arg: '[검색어|all|off]' },
+  plugin:  { desc: '플러그인 목록·설치·삭제·반입묶음', arg: '[install|remove|pack]' },
   cost:    { desc: '이번 세션 사용량' },
   status:  { desc: '연결 상태' },
+  scan:    { desc: '이 PC 의 로컬 모델 서버 훑기', arg: '[save]' },
+  sessions:{ desc: '이 폴더의 지난 대화 목록' },
+  level:   { desc: '사용자 수준 (쉬움/개발자)', arg: '[수준]' },
   init:    { desc: 'DEEL.md 규칙 파일 만들기' },
   exit:    { desc: '끝내기' },
   quit:    { desc: '끝내기' },
@@ -40,7 +58,8 @@ export async function handle(line, session, ctx) {
   const arg = rest.join(' ');
 
   switch (name) {
-    case 'help': return help(), { handled: true };
+    case 'help': return help(session), { handled: true };
+    case 'level': return showLevel(session, arg), { handled: true };
     case 'exit':
     case 'quit': return { handled: true, exit: true };
 
@@ -53,10 +72,21 @@ export async function handle(line, session, ctx) {
     case 'context': return showContext(session), { handled: true };
 
     case 'compact': {
-      const n = session.trim();
-      say(n
-        ? `  ${mark.ok} 오래된 대화 ${n}개를 줄였습니다.`
-        : `  ${c.gray('줄일 만큼 쌓이지 않았습니다.')}`);
+      const s = spin('앞선 대화를 요약해 접는 중…');
+      const r = await compact(session);
+      if (!r.ok) {
+        s.stop(`  ${c.gray(r.why ?? '접지 못했습니다.')}`);
+        say('');
+        return { handled: true };
+      }
+      const 줄인 = r.before - r.after;
+      s.stop(`  ${mark.ok} 대화 ${r.folded}개를 요약으로 접었습니다.`);
+      say(`     ${c.gray(r.before.toLocaleString())} ${c.gray('→')} ${c.white(r.after.toLocaleString())} ${c.gray('토큰')}  ${c.green(`${Math.round((줄인 / Math.max(1, r.before)) * 100)}% 줄어듦`)}`);
+      if (r.fallback) say(`     ${c.yellow('요약을 못 받아 그냥 줄였습니다.')}`);
+      else if (r.summary) {
+        say('');
+        for (const line of r.summary.split('\n').slice(0, 14)) say(`     ${c.gray(clip(line, 76))}`);
+      }
       say('');
       return { handled: true };
     }
@@ -64,18 +94,25 @@ export async function handle(line, session, ctx) {
     case 'model': return await switchModel(session, ctx), { handled: true };
 
     case 'think': {
+      const asProfile = normalizeProfile(arg);
+      if (asProfile) {
+        session.effort = asProfile;
+        session.effortSet = true;   // 사용자가 직접 정했다 — 작업 모드보다 우선한다
+        say(`  ${mark.ok} 배분 ${c.bold(PROFILES[asProfile].name)} ${c.gray('— ' + PROFILES[asProfile].desc)}`);
+        showThink(session);
+        return { handled: true };
+      }
       if (!THINK_LEVELS.includes(arg)) {
-        say(`  ${c.gray('지금')} ${c.bold(session.think)}   ${c.gray('고를 수 있는 값:')} ${THINK_LEVELS.join(' · ')}`);
-        say(`  ${c.gray('예')} /think high`);
-        say('');
+        showThink(session);
         return { handled: true };
       }
       session.think = arg;
+      session.thinkSet = true;      // 사용자가 직접 정했다 — 작업 모드보다 우선한다
       say(`  ${mark.ok} 추론 강도 ${c.bold(arg)}`);
       if (!session.conn.think && arg !== 'off') {
         say(`     ${c.yellow('이 연결은 모델 층 조절이 안 먹습니다.')} ${c.gray('루프 층(도구 호출 상한)으로만 조절됩니다.')}`);
       }
-      say('');
+      showThink(session);
       return { handled: true };
     }
 
@@ -146,6 +183,75 @@ export async function handle(line, session, ctx) {
       return { handled: true };
     }
 
+    case 'work':
+    case 'code': case 'plan': case 'architect':
+    case 'debug': case 'ask': case 'orchestrator': {
+      const 원하는 = name === 'work' ? normWork(arg) : name;
+      if (name === 'work' && !원하는) { showWork(session); return { handled: true }; }
+      const 골라진 = normWork(원하는);
+      if (!골라진) {
+        say(`  ${mark.warn} 그런 모드는 없습니다: ${c.white(arg)}`);
+        say(`  ${c.gray('쓸 수 있는 것:')} ${WORK_ORDER.map((k) => c.cyan(WORK_MODES[k].name)).join(c.gray(' · '))}`);
+        say('');
+        return { handled: true };
+      }
+      session.work = 골라진;
+      const w = getWork(골라진);
+      say('');
+      say(`  ${c.hcyan(w.glyph)} ${c.bold(w.name)} ${c.gray('(' + w.en + ')')}  ${c.gray(w.hint)}`);
+      say(`  ${c.gray('도구')}    ${canWrite(골라진) ? c.yellow('읽기 + 파일 바꾸기') : c.green('읽기만 — 파일을 못 바꿉니다')}`);
+      say(`  ${c.gray('생각')}    ${c.white(w.think ?? session.think)}${c.gray('·')}${c.magenta(w.effort)}   ${c.gray('최대 ' + w.steps + '걸음')}`);
+      say('');
+      return { handled: true };
+    }
+
+    case 'scan': {
+      const s2 = spin('이 PC 의 로컬 서버를 찾는 중…');
+      const found = await scanLocal({ timeout: 1500 });
+      s2.stop(`  ${found.length ? mark.ok : mark.warn} ${found.length}곳 찾음`);
+      if (!found.length) {
+        say(`  ${c.gray('떠 있는 로컬 서버가 없습니다. 다른 포트라면')} ${c.cyan('deel scan --ports ...')}`);
+        say('');
+        return { handled: true };
+      }
+      for (const f of found) {
+        say(`  ${c.hcyan('◆')} ${c.bold(pad(f.runtime, 12))}${c.gray(pad(`${f.host}:${f.port}`, 22))}${c.gray(`모델 ${f.models.length}개`)}`);
+        for (const m of f.models.slice(0, 6)) say(`      ${c.gray('·')} ${clip(m.id, 44)}`);
+        if (f.models.length > 6) say(`      ${c.gray(`… 그 밖에 ${f.models.length - 6}개`)}`);
+      }
+      say('');
+      if (arg === 'save') {
+        const cfg2 = load();
+        const ps = toProfiles(found, cfg2.profiles);
+        for (const x of ps) upsert(cfg2, x);
+        save(cfg2);
+        say(`  ${mark.ok} ${ps.length}개 등록했습니다. ${c.cyan('/model')} 로 고르세요.`);
+      } else {
+        say(`  ${c.gray('등록하려면')} ${c.cyan('/scan save')}   ${c.gray('고르려면')} ${c.cyan('/model')}`);
+      }
+      say('');
+      return { handled: true };
+    }
+
+    case 'sessions': {
+      const rows = listSessions(session.root, { limit: 12 });
+      rule('이 폴더의 지난 대화', 70);
+      if (!rows.length) {
+        say(`  ${c.gray('아직 없습니다. 지금 이 대화가 첫 번째입니다.')}`);
+        say('');
+        return { handled: true };
+      }
+      for (const [i, r] of rows.entries()) {
+        say(`  ${i === 0 ? c.hgreen('●') : c.gray('·')} ${c.bold(pad(r.id, 17))}${c.gray(pad(`${r.turns}턴`, 6, 'right'))}  ${c.gray(clip(r.model, 22))}`);
+        say(`      ${c.gray(clip(r.first, 66))}`);
+      }
+      say('');
+      say(`  ${c.gray('이어하려면 나갔다가')} ${c.cyan('deel --continue')} ${c.gray('또는')} ${c.cyan(`deel --resume ${rows[0].id}`)}`);
+      say(`  ${c.gray('지금 대화는 나가지 않아도 계속 저장되고 있습니다.')}`);
+      say('');
+      return { handled: true };
+    }
+
     case 'init': {
       const p = join(session.root, 'DEEL.md');
       if (existsSync(p)) {
@@ -162,6 +268,9 @@ export async function handle(line, session, ctx) {
 
     case 'skills': return showSkills(session, arg), { handled: true };
 
+    case 'plugin':
+    case 'plugins': return await doPlugin(session, arg), { handled: true };
+
     default: {
       // 이 PC 에서 찾은 슬래시 명령인지 본다. 있으면 그 내용을 모델에게 보낸다.
       const found = (session.commands ?? []).find((x) => x.name === raw)
@@ -185,6 +294,97 @@ export async function handle(line, session, ctx) {
   }
 }
 
+async function doPlugin(session, arg) {
+  const [sub = '', ...rest] = arg.trim().split(/\s+/);
+  const param = rest.join(' ').trim();
+
+  // 설치·삭제 뒤에는 다시 훑어 이번 대화에 바로 반영한다.
+  const rescan = () => {
+    const f = discover(session.root);
+    session.skills = f.skills;
+    session.commands = f.commands;
+    session.plugins = f.plugins;
+    return f;
+  };
+
+  if (sub === 'install' || sub === 'add') {
+    if (!param) {
+      say(`  ${c.gray('예')} /plugin install affaan-m/ECC`);
+      say(`  ${c.gray('  ')} /plugin install owner/repo#가지이름`);
+      say('');
+      return;
+    }
+    say('');
+    const s = spin(`${param} 받는 중...`);
+    const r = await install(param, { onStep: (m) => {} });
+    if (r.error) {
+      s.stop(`  ${mark.no} ${c.red(r.error.split('\n')[0])}`);
+      for (const line of r.error.split('\n').slice(1)) say(`     ${c.gray(line.trim())}`);
+      say(`     ${c.gray('오프라인이면 zip 을 ~/.deel/plugins/ 에 직접 풀면 됩니다.')}`);
+      say('');
+      return;
+    }
+    s.stop(`  ${mark.ok} ${c.bold(r.name)}${r.version ? ' ' + c.gray(r.version) : ''} ${c.gray(`(${r.license ?? '라이선스 미상'})`)}`);
+    say(`     ${c.gray('스킬')} ${r.skills}개  ${c.gray('명령')} ${r.commands}개  ${c.gray(`· ${r.how} 로 받음`)}`);
+    if (r.hooks) say(`     ${mark.warn} ${c.yellow(`실행 스크립트 ${r.hooks}개는 쓰지 않습니다`)} ${c.gray('(hook 미지원 · 반입 심사 대상)')}`);
+    const f = rescan();
+    say(`     ${c.gray(`이제 스킬 ${f.skills.length}개 · 명령 ${f.commands.length}개`)}`);
+    say('');
+    return;
+  }
+
+  if (sub === 'remove' || sub === 'rm' || sub === 'uninstall') {
+    if (!param) { say(`  ${c.gray('예')} /plugin remove ecc`); say(''); return; }
+    const r = remove(param);
+    if (r.error) { say(`  ${mark.no} ${c.red(r.error)}`); say(''); return; }
+    const f = rescan();
+    say(`  ${mark.ok} ${c.bold(r.removed)} 지웠습니다. ${c.gray(`이제 스킬 ${f.skills.length}개`)}`);
+    say('');
+    return;
+  }
+
+  if (sub === 'pack') {
+    const stamp = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+    const out = param || join(session.root, `deel-plugins-${stamp}.zip`);
+    const r = pack(out, { only: null });
+    if (r.error) { say(`  ${mark.no} ${c.red(r.error)}`); say(''); return; }
+    say('');
+    say(`  ${mark.ok} ${c.cyan(r.out)}`);
+    say(`     ${c.gray('플러그인')} ${r.plugins.length}개 ${c.gray('· 파일')} ${r.files}개 ${c.gray('·')} ${(r.bytes / 1024).toFixed(0)}KB`);
+    if (r.skipped) say(`     ${c.gray(`실행 스크립트 ${r.skipped}개는 뺐습니다`)}`);
+    say('');
+    rule('담긴 것', 74);
+    for (const p of r.plugins) {
+      say(`  ${c.cyan(pad(p.name, 22))} ${c.gray(pad(p.version || '-', 9))} ${c.gray(pad(p.license || '미상', 14))} ${c.gray(`스킬 ${p.skills} · 명령 ${p.commands}`)}`);
+    }
+    say('');
+    say(`  ${c.gray('오프라인 기기의')} ~/.deel/plugins/ ${c.gray('에 풀면 바로 인식됩니다. 설치 명령은 필요 없습니다.')}`);
+    say(`  ${c.gray('묶음 안에 라이선스 표가 담긴 사용안내.txt 가 함께 들어 있습니다.')}`);
+    say('');
+    return;
+  }
+
+  // 인자 없으면 목록
+  const items = list();
+  if (!items.length) {
+    say('');
+    say(`  ${c.gray('설치된 플러그인이 없습니다.')}`);
+    say(`  ${c.gray('받기')}  /plugin install owner/repo`);
+    say(`  ${c.gray('직접')}  ~/.deel/plugins/ 에 폴더를 풀어 넣어도 됩니다`);
+    say('');
+    return;
+  }
+  say('');
+  rule('플러그인', 74);
+  for (const p of items) {
+    say(`  ${c.cyan(pad(p.name, 22))} ${c.gray(pad(p.version || '-', 9))} ${c.gray(pad(p.license || '미상', 14))} ${c.gray(`스킬 ${p.skills} · 명령 ${p.commands}`)}`);
+    say(`    ${c.gray(p.from)}`);
+  }
+  say('');
+  say(`  ${c.gray('/plugin install <owner/repo>   /plugin remove <이름>   /plugin pack [파일]')}`);
+  say('');
+}
+
 function showSkills(session, arg) {
   const all = session.skills ?? [];
   if (!all.length) {
@@ -248,18 +448,88 @@ function showSkills(session, arg) {
   say('');
 }
 
-function help() {
+function help(session) {
+  const level = session?.level ?? LEVEL_DEFAULT;
+  const 쉬움 = !levelShows(level, '__전부__');   // 개발자면 show 가 null 이라 전부 참
   say('');
-  rule('명령', 70);
+  rule(쉬움 ? '명령 (자주 쓰는 것)' : '명령', 70);
+  let 감춘수 = 0;
   for (const [n, m] of Object.entries(COMMANDS)) {
     if (n === 'quit') continue;
+    if (!levelShows(level, n)) { 감춘수++; continue; }
     say(`  ${c.cyan(pad('/' + n + (m.arg ? ' ' + m.arg : ''), 22))} ${c.gray(m.desc)}`);
   }
   say('');
+  // 감춘 것은 '못 쓰는 것' 이 아니다. 그 말을 분명히 해 둔다.
+  if (감춘수) {
+    say(`  ${c.gray(`이 밖에 ${감춘수}개가 더 있습니다 — 쳐 넣으면 그대로 먹습니다.`)}`);
+    say(`  ${c.gray('전부 보려면')} ${c.cyan('/level 개발자')}`);
+    say('');
+  }
   say(`  ${c.gray('그 밖의 입력은 모델에게 보냅니다. 빈 줄에서 Ctrl+C 로 끝냅니다.')}`);
   say('');
 }
 
+// /level — 수준 보기·바꾸기. 설정 파일에 남겨 다음에도 그대로 쓴다.
+function showLevel(session, arg) {
+  if (!arg) {
+    rule('사용자 수준', 70);
+    for (const k of LEVEL_ORDER) {
+      const lv = LEVELS[k];
+      const 지금 = k === (normLevel(session.level) ?? LEVEL_DEFAULT);
+      say(`  ${지금 ? c.hgreen('●') : c.gray('·')} ${지금 ? c.bold(c.white(pad(lv.name, 10))) : c.gray(pad(lv.name, 10))}${c.gray(lv.hint)}`);
+    }
+    say('');
+    say(`  ${c.gray('안전 장치는 두 수준이 똑같습니다 — 되돌리기·작업 범위·위험 명령 차단.')}`);
+    say(`  ${c.gray('수준은 무엇을 보여줄지만 정합니다.')}`);
+    say('');
+    say(`  ${c.gray('바꾸려면')} ${c.cyan('/level 쉬움')} ${c.gray('또는')} ${c.cyan('/level 개발자')}`);
+    say('');
+    return;
+  }
+  const 골라진 = normLevel(arg);
+  if (!골라진) {
+    say(`  ${mark.warn} 그런 수준은 없습니다: ${c.white(arg)}  ${c.gray('(쉬움 · 개발자)')}`);
+    say('');
+    return;
+  }
+  session.level = 골라진;
+  try {
+    const cfg = load();
+    cfg.level = 골라진;
+    save(cfg);
+  } catch { /* 못 남겨도 이번 세션에는 먹는다 */ }
+  const lv = LEVELS[골라진];
+  say('');
+  say(`  ${mark.ok} ${c.bold(lv.name)} ${c.gray('— ' + lv.hint)}`);
+  say(`  ${c.gray('안전 장치는 그대로입니다.')}`);
+  say('');
+}
+
+// 추론 강도는 값 하나가 아니라 '단계별 배분' 이다. 그 배분을 눈에 보이게 그린다.
+function showThink(session) {
+  const b = session.breakdown();
+  const t = effortTable(session.think, session.effort, { ctx: b.total, used: b.used, max: session.conn.maxTokens ?? null });
+  say('');
+  rule('추론 강도', 70);
+  say(`  기준 ${c.bold(session.think)}   배분 ${c.bold(t.name)}   ${c.gray(t.desc)}`);
+  say(`  ${c.gray('상한은 이 모델 기준으로 계산합니다 — 컨텍스트')} ${c.white(t.ctx.toLocaleString())}${c.gray(', 지금 찬 양')} ${c.white(t.used.toLocaleString())}`);
+  say('');
+  say(`  ${c.gray(pad('단계', 12) + pad('강도', 10) + pad('출력상한', 10) + '언제')}`);
+  for (const r of t.rows) {
+    const 화살 = r.moved > 0 ? c.yellow('↑') : r.moved < 0 ? c.cyan('↓') : c.gray('·');
+    say(`  ${pad(r.label, 12)}${화살} ${pad(r.level, 8)}${pad(r.cap.toLocaleString(), 10, 'right')}  ${c.gray(r.why)}`);
+  }
+  say('');
+  say(`  ${c.gray('강도')}  ${THINK_LEVELS.join(' · ')}            ${c.gray('예')} ${c.cyan('/think high')}`);
+  say(`  ${c.gray('배분')}  ${Object.entries(PROFILES).map(([k, v]) => `${k}(${v.name})`).join(' · ')}   ${c.gray('예')} ${c.cyan('/think save')}`);
+  if (!session.conn.think && session.think !== 'off') {
+    say('');
+    say(`  ${c.yellow('이 연결은 모델 층 강도 조절이 안 먹습니다.')} ${c.gray('출력 상한만 단계별로 적용됩니다.')}`);
+  }
+  say('');
+}
+
 function showContext(session) {
   const b = session.breakdown();
   say('');
@@ -302,6 +572,9 @@ async function switchModel(session, ctx) {
     kind: p.kind, base: p.baseUrl, auth: p.auth, key: resolveKey(p), model: p.model,
     ctx: p.ctx, streaming: p.streaming, tools: p.tools, json: p.json, think: p.think,
   });
+  // 자물쇠도 같이 옮긴다. 이걸 빼먹으면 옛 주소가 열린 채로 남고 새 주소는 막혀
+  // 다음 한마디에서 바로 "허용되지 않은 주소" 가 난다.
+  allowEndpoint(p.baseUrl);
   say(`  ${mark.ok} ${c.bold(p.name)} ${c.gray(p.model)} 로 바꿨습니다. 대화는 이어집니다.`);
   say('');
 }
@@ -325,3 +598,20 @@ const INIT_TEMPLATE = `# DEEL.md
 - 고치기 전에 관련 파일을 먼저 읽는다
 - (프로젝트에 맞는 규칙을 적으세요)
 `;
+
+// /work 를 인자 없이 부르면 지금 모드와 고를 수 있는 것들을 보여 준다.
+function showWork(session) {
+  rule('작업 모드', 70);
+  for (const k of WORK_ORDER) {
+    const w = WORK_MODES[k];
+    const 지금 = k === (normWork(session.work) ?? 'code');
+    const 표 = 지금 ? c.hgreen('●') : c.gray('·');
+    const 이름 = 지금 ? c.bold(c.white(pad(w.name, 8))) : c.gray(pad(w.name, 8));
+    say(`  ${표} ${c.hcyan(w.glyph)} ${이름}${c.gray(pad(w.en, 14))}${c.gray(w.hint)}`);
+    say(`        ${canWrite(k) ? c.gray('파일 바꿈') : c.green('읽기만')}${c.gray('  ·  생각 ' + (w.think ?? '그대로') + '·' + w.effort + '  ·  최대 ' + w.steps + '걸음')}`);
+  }
+  say('');
+  say(`  ${c.gray('바꾸려면')} ${c.cyan('/plan')} ${c.cyan('/code')} ${c.cyan('/debug')} ${c.gray('…  또는')} ${c.cyan('Shift+Tab')} ${c.gray('으로 차례로')}`);
+  say(`  ${c.gray('이건 승인 정책(')}${c.cyan('/mode')}${c.gray(')과 다른 축입니다 — 무엇을 하느냐 / 얼마나 물어보냐.')}`);
+  say('');
+}

package/src/config.js

@@ -1,15 +1,28 @@
 // 연결 프로필 저장/읽기.  ~/.deel/config.json  (프로젝트 폴더의 .deel/config.json 이 우선)
 import { homedir } from 'node:os';
-import { join, dirname } from 'node:path';
+import { join, dirname, resolve } from 'node:path';
 import { readFileSync, writeFileSync, mkdirSync, existsSync, chmodSync } from 'node:fs';
 
-const USER_DIR = join(homedir(), '.deel');
-const PROJECT_DIR = join(process.cwd(), '.deel');
+// 설정이 놓이는 자리.
+//
+// DEEL_HOME 을 주면 그 폴더를 쓴다. 두 군데서 필요했다 —
+//   1) 사내에서 USB·공유폴더에 통째로 넣어 쓰는 휴대용 설치.
+//      집 폴더가 로밍 프로필이면 설정이 엉뚱한 데로 따라다닌다.
+//   2) 검사. 예전에는 검사가 진짜 설정 파일에 값을 써 버렸다.
+//      실제로 /level 검사가 사용자 설정을 바꾼 것을 보고 이걸 넣었다.
+//
+// 모듈을 읽을 때가 아니라 쓸 때마다 본다. 그래야 부르는 쪽에서 언제 정하든 먹는다.
+function userDir() {
+  return process.env.DEEL_HOME ? resolve(process.env.DEEL_HOME) : join(homedir(), '.deel');
+}
+function projectDir() {
+  return join(process.cwd(), '.deel');
+}
 
 export function configPath() {
-  const local = join(PROJECT_DIR, 'config.json');
+  const local = join(projectDir(), 'config.json');
   if (existsSync(local)) return local;
-  return join(USER_DIR, 'config.json');
+  return join(userDir(), 'config.json');
 }
 
 const EMPTY = { version: 1, active: null, profiles: [] };
@@ -26,7 +39,7 @@ export function load() {
 }
 
 export function save(cfg, { toProject = false } = {}) {
-  const dir = toProject ? PROJECT_DIR : USER_DIR;
+  const dir = toProject ? projectDir() : userDir();
   const p = join(dir, 'config.json');
   mkdirSync(dir, { recursive: true });
   writeFileSync(p, JSON.stringify(cfg, null, 2) + '\n', 'utf8');