axmap-cli 1.2.3 → 1.2.5

package/bin/axmap.mjs

@@ -43,6 +43,7 @@ import {
   noticeLine,
   registryUrl,
 } from '../src/update.mjs'
+import { stateDir } from '../src/repotarget.mjs'
 import { homeRegistrations } from '../src/mcpstate.mjs'
 import { compareBranchFor, formatOverlap } from '../src/overlap.mjs'
 
@@ -2612,6 +2613,19 @@ function cmdRun(name) {
  * 아래에 찍히는 한 줄을 직접 실행하는 것으로만 일어난다.
  *
  * 종료 코드: 0 물어봤다 (최신이든 아니든) · 1 못 물어봤다
+ *
+ * 🔴 **이 명령만은 `process.exit()` 로 끝내지 않는다 (2026-09-10).**
+ *
+ *    레지스트리에 묻는 순간 fetch 가 소켓을 연다. 답을 다 읽은 뒤에도 그 소켓은
+ *    아직 **닫히는 중**이고, 그 상태에서 `process.exit()` 를 부르면 Windows 의
+ *    node 가 `Assertion failed: !(handle->flags & UV_HANDLE_CLOSING)` 로 스스로
+ *    중단한다. 화면에는 "최신입니다" 가 이미 찍힌 뒤라 **사람 눈에는 정상인데
+ *    종료 코드가 127** 이다. 판정을 종료 코드로 하는 이 저장소에서 그건 조용한
+ *    실패고, 이 명령을 검사에 넣는 순간 언제나 빨개진다.
+ *
+ *    한 틱 미루는 것(`setImmediate`)으로는 안 된다 — 재봤을 때 똑같이 죽었다.
+ *    이벤트 루프가 실제로 비워질 때까지 기다려야 한다. 그래서 `process.exitCode`
+ *    만 세우고 돌아간다. 느려지지 않는다 (둘 다 230ms 안쪽이었다).
  */
 async function cmdUpdate(flags) {
   const current = selfVersion()
@@ -2643,23 +2657,74 @@ async function cmdUpdate(flags) {
     console.error(`새 버전을 확인하지 못했습니다: ${e.message}`)
     console.error('네트워크가 안 되거나, 아직 배포된 적이 없는 꾸러미일 수 있습니다.')
     console.error('')
-    process.exit(1)
+    process.exitCode = 1
+    return
   }
 
   writeCache({ latest, current, checkedAt: Date.now(), registry })
 
   const notice = noticeLine(current, latest)
   console.log(`최신 버전: ${latest}`)
+
+  // 🔴 **훅이 부르는 사본도 같이 본다 (2026-09-12).**
+  //
+  //    판이 이 PC 에 **두 군데** 있다. `axmap` 명령(전역 설치)과 git 훅이 부르는
+  //    사본(`~/.axmap/app`)이다. `npm i -g` 는 앞의 것만 올리고 뒤의 것은 `setup`
+  //    이 올린다 — 서로 안 따라간다.
+  //
+  //    그런데 이 명령은 **자기 판만 보고** "최신입니다" 라고 답했다. 훅이 부르는
+  //    사본이 옛 판인데도 그랬다. 막는 것보다 나쁘다 — **괜찮다고 말하고 넘어간다.**
+  //    실측 (2026-09-12): `npm i -g` 로 전역이 1.2.3 이 된 직후 이 명령이
+  //    "최신입니다" 라고 했는데 훅이 부르는 사본은 1.2.2 였다.
+  const installed = installedAppVersion()
+  const skewed = Boolean(installed && current && installed !== current)
+  if (skewed) {
+    console.log('')
+    console.log(`🔴 git 훅이 부르는 사본은 아직 ${installed} 입니다 (이 명령은 ${current}).`)
+    console.log('   둘은 따로 움직입니다 — 전역은 `npm i -g`, 사본은 `axmap setup` 이 올립니다.')
+    console.log('')
+    console.log('   맞추려면:  axmap setup')
+  }
+
   console.log('')
   if (notice) {
     for (const l of notice.split('\n')) console.log(l)
     console.log('')
-    console.log('  🔴 저절로 바뀌지 않습니다. 위 한 줄을 직접 실행할 때만 바뀝니다.')
+    console.log('  🔴 저절로 바뀌지 않습니다. 위 명령을 직접 실행할 때만 바뀝니다.')
+  } else if (skewed) {
+    // 여기서 "최신입니다" 라고 말하면 거짓이 된다. 이 PC 의 실력은 **가장 낡은 것**이다.
+    console.log('레지스트리 기준으로는 최신이지만, 위 사본이 아직 안 맞습니다.')
   } else {
     console.log('최신입니다.')
   }
   console.log('')
-  process.exit(0)
+}
+
+/**
+ * git 훅이 실제로 부르는 사본(`~/.axmap/app`)의 판. 없거나 못 읽으면 `null`.
+ *
+ * 🔴 **`selfVersion()` 과 다른 것을 본다.** `selfVersion()` 은 *"지금 이 코드"* 의
+ *    판이고, 이 함수는 *"커밋할 때마다 실제로 도는 코드"* 의 판이다. 둘이 갈릴 수
+ *    있다는 것이 이 PC 구조의 사실이므로, 하나만 보고 답하면 거짓말이 된다.
+ *
+ * 🔴 자리를 여기서 새로 정하지 않는다 — `stateDir()` 을 쓴다. 그래야
+ *    `AXMAP_STATE_DIR` 이 여기에도 걸린다. 그 환경변수가 있는 이유가
+ *    `src/repotarget.mjs` 에 적혀 있다 — *"테스트가 사람의 작업 환경을 고치는
+ *    것은 어떤 이유로도 정당하지 않다."* `os.homedir()` 를 직접 부르면 이 명령의
+ *    출력이 **돌리는 사람의 PC 상태에 따라 달라지고**, 그러면 시험이 사람마다
+ *    다른 답을 낸다 (실제로 그렇게 깨졌다).
+ *
+ * 🔴 못 읽으면 `null` 을 돌려 **아무 말도 안 한다.** 사본을 안 쓰는 설치도 있고
+ *    (팀 저장소 안의 벤더링 사본은 위에서 이미 걸러진다), 없는 것을 낡았다고
+ *    말하면 그 경고는 곧 아무도 안 읽는 잡음이 된다.
+ */
+function installedAppVersion() {
+  try {
+    const p = path.join(stateDir(), 'app', 'package.json')
+    return JSON.parse(fs.readFileSync(p, 'utf8'))?.version ?? null
+  } catch {
+    return null
+  }
 }
 
 /**

package/governance/vote.mjs

@@ -419,8 +419,52 @@ function g1WaiverFor(branch, targetName, policyFlag) {
   return { eligibleCount, threshold }
 }
 
+/**
+ * **판정에 물어본다 — "이 사람이 G1 으로 빠지나?"**
+ *
+ * 🔴 이것이 1.2.4 의 요점이다. 1.2.3 까지는 쓰는 쪽이 같은 규칙을 **자기가
+ *    계산**했고, 그 어긋남이 **두 번** 났다 — 2026-09-07 의 G1 해제(세는 쪽만
+ *    알았다), 2026-09-12 의 `self_vote` 모드(쓰는 쪽이 정책을 안 읽었다).
+ *    같은 규칙을 두 곳에 적으면 몇 번을 고쳐도 또 난다. **판정자는 하나여야 한다.**
+ *
+ * 🔴 **`null` 은 "모른다" 다 — 통과도 거부도 아니다.** 게이트를 못 돌린 경우
+ *    (저장소가 아직 그럴 상태가 아니거나, 정책이 없거나, 타임아웃)에는 부르는
+ *    쪽이 직접 보는 길로 떨어진다. 여기서 `false` 를 돌려 조용히 통과시키면,
+ *    게이트가 잠깐 안 도는 것만으로 G1 이 꺼진다.
+ *
+ * 🔴 **해제와 섞지 않는다.** 이 함수가 답하는 것은 *"자기 표인가"* 하나다.
+ *    *"자기 표인데 그래도 세는가"* 는 `g1WaiverFor` 가 따로 답한다. 둘을 합치면
+ *    부르는 쪽이 **"자기 표가 아니다" 와 "자기 표인데 해제됐다" 를 구별 못 하고**,
+ *    그러면 해제로 통과한 사람에게 왜 그냥 써 줬는지 말해 줄 수 없다.
+ *
+ * @returns {{self:boolean, mode:string|null}|null} 못 물어봤으면 `null`
+ */
+function selfVoteByGate(branch, targetName, email, policyFlag) {
+  const v = runGate(branch, targetName, policyFlag)
+  if (!v || v.stage !== 'count' || !v.tally) return null
+  const list = v.tally.selfVoteEmails
+  // 옛 게이트(1.2.3 이하)는 이 칸을 안 낸다. 없는 것을 "자기 표가 아니다" 로
+  // 읽으면 판이 섞인 팀에서 G1 이 조용히 꺼진다 — 모른다고 답한다.
+  if (!Array.isArray(list)) return null
+  return {
+    self: list.includes(String(email ?? '').trim().toLowerCase()),
+    mode: typeof v.tally.selfVoteMode === 'string' ? v.tally.selfVoteMode : null,
+  }
+}
+
 function warnIfSelfVote(branch, targetName, email, force, policyFlag, policy) {
-  // 🔴 **세는 쪽과 같은 값을 본다.** 여기서 조건을 다시 적으면 어긋난다.
+  // ── 1. 먼저 판정에 물어본다 ──────────────────────────────────────────────
+  const asked = selfVoteByGate(branch, targetName, email, policyFlag)
+  if (asked && !asked.self) return     // 판정이 "자기 표가 아니다" 고 했다. 끝.
+  if (asked && asked.self) {
+    return reportSelfVote(branch, targetName, email, force, policyFlag, {
+      label: `${targetName} 기준 판정`,
+      mode: asked.mode,
+    })
+  }
+
+  // ── 2. 못 물어봤으면 직접 본다 ───────────────────────────────────────────
+  // 🔴 **세는 쪽과 같은 함수로** 정책을 읽는다. 여기서 조건을 다시 적으면 어긋난다.
   const mode = selfVoteModeSafe(policy)
 
   // `off` 는 G1 자체를 끈 것이다. 막을 것도 경고할 것도 없다.
@@ -440,6 +484,21 @@ function warnIfSelfVote(branch, targetName, email, force, policyFlag, policy) {
   const authors = new Set(r.out.split('\n').map((s) => s.trim().toLowerCase()).filter(Boolean))
   if (!authors.has(email.toLowerCase())) return
 
+  reportSelfVote(branch, targetName, email, force, policyFlag, { label: range.label, mode })
+}
+
+/**
+ * **자기 표인 것이 확인된 뒤**, 그것을 사람에게 어떻게 말하고 막을지.
+ *
+ * 🔴 두 길(판정에 물어본 길·직접 본 길)이 **같은 코드로 끝나야 한다.** 여기를
+ *    두 벌로 두면 "판정이 답한 날" 과 "게이트를 못 돌린 날" 의 안내가 갈린다 —
+ *    그 갈라짐이 이 파일에서 이미 두 번 사고를 냈다.
+ *
+ * @param {{label:string, mode:string}|null} seen 직접 본 길만 채운다. 판정에
+ *        물어본 길에서는 `null` — 그때는 무엇을 봤는지 이 파일이 모르고,
+ *        **모르는 것을 지어내 적지 않는다.**
+ */
+function reportSelfVote(branch, targetName, email, force, policyFlag, seen) {
   // 자기 표는 맞다. 그런데 **이 판정에서는 세어지는가?** 세는 쪽에 물어본다.
   const waiver = g1WaiverFor(branch, targetName, policyFlag)
   if (waiver) {
@@ -454,8 +513,10 @@ function warnIfSelfVote(branch, targetName, email, force, policyFlag, policy) {
 
   console.error(
     `이 표는 자기 표라 세지지 않습니다 (G1 — 자기가 쓴 코드에 자기가 찬성할 수 없습니다).\n`
-    + `  ${email} 이(가) ${range.label} 의 author 목록에 있습니다.\n`
-    + `  배제 범위는 정책의 self_vote = "${mode}" 가 정합니다.\n\n`
+    + (seen
+      ? `  ${email} 이(가) ${seen.label} 의 author 목록에 있습니다.\n`
+        + `  배제 범위는 정책의 self_vote = "${seen.mode}" 가 정합니다.\n\n`
+      : `  ${email} 을(를) ${targetName} 기준 판정이 자기 표로 셉니다.\n\n`)
     + '  그래도 남기려면 --force 를 붙이세요. 파일은 남고 판정문에는 "안 센 표" 로 보입니다.\n'
     + '  조용히 무효표를 쌓지 않는 이유: 던졌다고 믿는 사람이 아무도 안 세는 표를 기다립니다.',
   )

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": "1.2.3",
+  "version": "1.2.5",
   "//private": "🔴 여기 있던 \"private\": true 를 2026-08-28 에 지웠다. 그 줄이 있는 동안 npm publish 는 거부됐다. 되돌리려면 다시 넣으면 되지만, 이미 올라간 버전은 그래도 안 사라진다 — npm 은 같은 번호를 덮어쓰지 못하고 삭제도 72시간 안에만 된다. 즉 이 줄을 되살리는 것은 '앞으로 안 올린다' 는 뜻이지 '올린 것을 없앤다' 는 뜻이 아니다.",
   "//publishConfig": "axmap-cli 는 스코프가 없어서 기본이 이미 공개다. 즉 지금은 없어도 된다. 그래도 남겨 두는 이유: 나중에 @조직/axmap 처럼 스코프를 붙이는 날 이 줄이 없으면 publish 가 '유료 플랜이 필요하다'는 엉뚱한 말로 실패한다.",
   "publishConfig": {

package/src/governance.mjs

@@ -1064,6 +1064,29 @@ export function countVotes({
     eligibleCount,
     threshold: need,
     selfVoted,
+    // ── 🔴 G1 이 배제하는 email 들 (2026-09-12) ──────────────────────────
+    //
+    // 쓰는 쪽(`governance/vote.mjs`)이 *"내 표가 세어지나"* 를 **여기에 물어볼 수
+    // 있게** 한다. 그러지 않으면 쓰는 쪽이 같은 규칙을 자기가 계산해야 하고,
+    // 그 어긋남이 실제로 **두 번** 났다 — 2026-09-07 의 G1 해제, 2026-09-12 의
+    // `self_vote` 모드. 판정자는 하나여야 한다.
+    //
+    // 🔴 **명단으로 거르지 않는다.** 여기 담기는 것은 `excludedAuthors` 가 낸
+    //    집합 그대로다. 명단으로 좁히면 명단 밖 사람에게는 경고가 안 가고, 그
+    //    사람은 **아무도 안 세는 표를 던져 놓고 기다리게 된다** — 이 저장소가
+    //    자기 표를 조용히 쌓지 않기로 한 이유가 그것이다.
+    //    (명단에 있나 없나는 `warnIfNotAVoter` 가 따로, 막지 않고 알린다.)
+    //
+    // 🔴 **해제(`g1Waived`)가 걸려도 비우지 않는다.** 이 칸은 *"이 판정에서
+    //    누가 자기 표인가"* 이고, 해제는 *"그 자기 표를 그래도 세는가"* 다.
+    //    둘은 다른 사실이라 따로 내야 한다 — 합쳐서 비워 버리면 읽는 쪽이
+    //    "자기 표가 아니다" 와 "자기 표인데 해제됐다" 를 **구별할 수 없고**,
+    //    그러면 해제로 통과한 사람에게 *왜* 그냥 써 줬는지 말해 줄 수 없다.
+    //    (읽는 쪽은 이 칸과 `g1Waived` 를 같이 본다.)
+    selfVoteEmails: [...authors],
+    // 어느 규칙으로 위 집합을 만들었는가. 막힌 사람에게 **왜** 막혔는지 말해 주려면
+    // 읽는 쪽이 이 값을 알아야 한다 — 모르면 "자기 표라서" 까지밖에 못 말한다.
+    selfVoteMode: selfVote,
   }
 }
 

package/src/update.mjs

@@ -131,15 +131,33 @@ export const isStale = (rec, nowMs, interval = CHECK_INTERVAL_MS) =>
   !rec || typeof rec.checkedAt !== 'number' || nowMs - rec.checkedAt >= interval
 
 /**
- * 사람에게 보여줄 한 줄. 알릴 것이 없으면 `null`.
+ * 사람에게 보여줄 안내. 알릴 것이 없으면 `null`.
  *
  * 🔴 부르는 쪽은 이것을 **stderr 로** 낸다. stdout 은 `--json` 이 쓰는 자리라,
  *    여기에 사람이 읽는 글을 섞으면 그 출력을 파싱하는 쪽이 조용히 깨진다.
+ *
+ * 🔴 **두 줄을 다 낸다 (2026-09-12).** 이 PC 에 판이 두 군데 있기 때문이다 —
+ *    `axmap` 명령(전역 설치)과 git 훅이 부르는 사본(`~/.axmap/app`). 서로 안
+ *    따라간다.
+ *
+ *    전에는 `npx … setup` 한 줄만 안내했다. 그런데 **`setup` 은 전역 설치를 전혀
+ *    건드리지 않는다** (`tools/setup.mjs` 에 `npm i` 가 0건이다 — 거기 있는
+ *    `--commands global` 의 "global" 은 슬래시 명령을 어디 둘지이지 전역 설치가
+ *    아니다). 그래서 그 안내를 그대로 따르면 **사본만 새 판이 되고 `axmap` 명령은
+ *    옛 판으로 남는다.**
+ *
+ *    그건 이 명령이 1.2.4 에서 고친 문제(사본이 낡았는데 "최신입니다" 라고 한 것)를
+ *    **안내가 스스로 만들어 내는 것**이다. 반쪽짜리 안내는 틀린 안내보다 낫지
+ *    않다 — 시킨 대로 했는데 안 고쳐지면 사람은 도구를 안 믿게 된다.
  */
 export function noticeLine(current, latest) {
   if (!current || !latest) return null
   if (compareVersions(latest, current) <= 0) return null
-  return `새 버전이 있습니다: ${current} → ${latest}\n  받으려면:  npx -y ${PACKAGE_NAME}@latest setup`
+  return `새 버전이 있습니다: ${current} → ${latest}\n`
+    + `  받으려면:  npm i -g ${PACKAGE_NAME}@latest\n`
+    + `             npx -y ${PACKAGE_NAME}@latest setup\n`
+    + '  🔴 두 줄 다 필요합니다 — 앞은 axmap 명령을, 뒤는 git 훅이 부르는 사본을\n'
+    + '     올립니다. 서로 안 따라갑니다.'
 }
 
 /**