axmap-cli 0.2.0 → 0.3.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "//name": "🔴 npm 의 'axmap' 은 2022년부터 남이 쓰고 있는 다른 꾸러미다(leozin_ 의 Map 라이브러리, 1.1.2). 그래서 `npx axmap` 은 우리 것이 아니고, 누구에게도 그렇게 안내하면 안 된다. 2026-08-28 에 axmap-cli 로 정했다 — 스코프(@사용자/이름)를 쓰지 않는 이유는 스코프가 npm 계정 이름에 묶여서 나중에 팀이나 조직으로 옮길 때 이름이 통째로 바뀌기 때문이다. 사람이 치는 **명령** 이름은 그대로 axmap 이다 (아래 bin) — 꾸러미 이름과 명령 이름은 달라도 된다.",
   "name": "axmap-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "//private": "🔴 여기 있던 \"private\": true 를 2026-08-28 에 지웠다. 그 줄이 있는 동안 npm publish 는 거부됐다. 되돌리려면 다시 넣으면 되지만, 이미 올라간 버전은 그래도 안 사라진다 — npm 은 같은 번호를 덮어쓰지 못하고 삭제도 72시간 안에만 된다. 즉 이 줄을 되살리는 것은 '앞으로 안 올린다' 는 뜻이지 '올린 것을 없앤다' 는 뜻이 아니다.",
   "//publishConfig": "axmap-cli 는 스코프가 없어서 기본이 이미 공개다. 즉 지금은 없어도 된다. 그래도 남겨 두는 이유: 나중에 @조직/axmap 처럼 스코프를 붙이는 날 이 줄이 없으면 publish 가 '유료 플랜이 필요하다'는 엉뚱한 말로 실패한다.",
   "publishConfig": {

package/tools/mcp-register.mjs

@@ -74,12 +74,102 @@ const same = (a, b) => JSON.stringify(a) === JSON.stringify(b)
 
 // ── Claude Code ────────────────────────────────────────────────────────────
 //
-// 할 일이 없다. 저장소의 `.mcp.json` 을 스스로 발견하고 승인만 묻는다.
-// 그래도 한 줄 찍는다 — "내 CLI 는 왜 아무 말이 없지" 를 없애기 위해서다.
-function doClaude(repo) {
+// 🔴 **2026-08-31 — 여기서 전역 등록을 하도록 바꿨다.** 그전에는 저장소의
+//    `.mcp.json` 이 있는지 확인만 하고 아무것도 하지 않았다.
+//
+//    그래서 Claude 만 **저장소에 파일을 커밋해야** 붙는 유일한 CLI 였다. npm 으로
+//    설치해 남의 저장소에서 쓰는 사람은 그 파일을 넣을 권한이 없을 수도 있고,
+//    넣더라도 "도구는 나가고 데이터만 남는다" 는 이 저장소의 방침에 어긋난다.
+//    `mcp/install.ps1` 은 이미 전역 등록을 하고 있었다 — 설치 경로 둘이 서로 다르게
+//    굴어서, 둘 다 돌린 PC 에는 **범위가 충돌하는 항목**이 남았다(claude mcp list 가
+//    "Conflicting scopes" 로 알려 준다). 두 경로를 같은 동작으로 맞춘다.
+//
+// 설정: `~/.claude.json` 의 최상위 `mcpServers` (user 범위)
+// 형식: `claude mcp add <이름> -s user [-e K=V] -- <명령> <인수...>`
+//
+// 🔴 `~/.claude.json` 을 **우리가 쓰지 않는다.** 그 파일에는 Claude Code 의 세션
+//    상태까지 들어 있어 읽고 다시 쓰는 순간 남의 것을 깨뜨릴 위험이 생긴다.
+//    있는지 **읽는 것만** 우리가 하고, 쓰는 일은 claude 자신에게 맡긴다 —
+//    doCodex 와 같은 태도다.
+
+/** `~/.claude.json` 의 user 범위 axmap 항목. 없으면 null, **못 읽으면 undefined**. */
+function claudeUserEntry() {
+  try {
+    const cfg = JSON.parse(fs.readFileSync(path.join(os.homedir(), '.claude.json'), 'utf8'))
+    return (cfg && cfg.mcpServers && cfg.mcpServers.axmap) || null
+  } catch (e) {
+    // 파일이 아예 없는 것은 "등록 안 됨"(null)이고, 있는데 못 읽는 것은 사고(undefined)다.
+    return e && e.code === 'ENOENT' ? null : undefined
+  }
+}
+
+/**
+ * 이미 쓸 만한 항목인가.
+ *
+ * env 는 **우리가 넣는 키만** 본다. 남이 `AXMAP_AGENT` 를 손으로 넣어 뒀을 수 있고,
+ * 그건 그 사람의 이름이라 지우면 안 된다 (install.ps1 이 실제로 넣는다).
+ */
+const sameEntry = (cur, want) =>
+  !!cur && cur.command === want.command &&
+  JSON.stringify(cur.args || []) === JSON.stringify(want.args) &&
+  Object.entries(want.env).every(([k, v]) => ((cur.env || {})[k] === v))
+
+function doClaude(bin, repo) {
+  const run = (args) => spawnSync(bin, args, { encoding: 'utf8', windowsHide: true })
+  const want = entry()
+
+  const cur = claudeUserEntry()
+  if (cur === undefined) {
+    no('claude', '~/.claude.json 을 읽지 못했습니다 — 건드리지 않았습니다')
+    snippetClaude()
+    return
+  }
+  if (sameEntry(cur, want)) { ok('claude', '이미 등록돼 있습니다 (user 범위)'); return }
+
+  // 문서에 있다고 믿고 부르지 않는다 — 먼저 물어본다. doCodex 와 같다.
+  const help = run(['mcp', 'add', '--help'])
+  if (help.status !== 0 || !/--scope/.test(`${help.stdout}${help.stderr}`)) {
+    hm('claude', "'claude mcp add -s user' 를 확인하지 못했습니다 — 손으로 넣으세요")
+    snippetClaude()
+    return
+  }
+
+  const add = ['mcp', 'add', 'axmap', '-s', 'user',
+    ...Object.entries(want.env).flatMap(([k, v]) => ['-e', `${k}=${v}`]),
+    '--', want.command, ...want.args]
+
+  if (DRY) {
+    hm('claude', `(dry-run) ${cur ? 'claude mcp remove axmap -s user 뒤 ' : ''}claude ${add.join(' ')}`)
+    return
+  }
+
+  // 자리를 비워야 add 가 덮어쓴다. 지우는 것은 **우리 이름(`axmap`)의 항목뿐**이다.
+  if (cur) run(['mcp', 'remove', 'axmap', '-s', 'user'])
+
+  const r = run(add)
+  if (r.status === 0 && sameEntry(claudeUserEntry(), want)) {
+    ok('claude', 'user 범위에 등록했습니다 — 어느 폴더에서 열어도 붙습니다')
+  } else {
+    no('claude', `claude mcp add 가 실패했습니다 (${(r.stderr || r.stdout || '').trim().split('\n')[0] || `exit ${r.status}`})`)
+    snippetClaude()
+  }
+
+  // 저장소에 `.mcp.json` 이 남아 있으면 **그쪽이 이긴다.** 조용히 두면 방금 등록한
+  // 것이 왜 안 쓰이는지 아무도 못 찾는다.
   const f = path.join(repo, '.mcp.json')
-  if (fs.existsSync(f)) ok('claude', '.mcp.json — 이 폴더를 열면 스스로 발견합니다 (승인만 누르면 됩니다)')
-  else no('claude', `.mcp.json 이 없습니다: ${f}`)
+  if (fs.existsSync(f)) hm('claude', `저장소의 .mcp.json 이 먼저 쓰입니다 (같은 서버라면 문제 없습니다): ${f}`)
+}
+
+/** 손으로 넣을 한 줄. 경로에 공백이 있을 수 있어 겹따옴표로 감싼다. */
+function snippetClaude() {
+  console.log('')
+  console.log('      아래 한 줄을 치세요:')
+  console.log('')
+  console.log(`        claude mcp add axmap -s user -e AXMAP_ACTOR=agent -e AXMAP_TTL=45m -- node "${SERVER}"`)
+  console.log('')
+  console.log('      AXMAP_AGENT 는 적지 마세요 — 여러 사람이 같은 이름이 되면')
+  console.log('      서로의 선점을 겹침으로 보지 못합니다.')
+  console.log('')
 }
 
 // ── Antigravity CLI (agy) ──────────────────────────────────────────────────
@@ -253,7 +343,7 @@ function main() {
     const bin = resolveBin(a.bin)
     if (!bin) continue
     any = true
-    if (a.id === 'claude') doClaude(root)
+    if (a.id === 'claude') doClaude(bin, root)
     else if (a.id === 'agy') doAgy()
     else if (a.id === 'codex') doCodex(bin)
   }