axmap-cli 1.2.2 → 1.2.4

package/CLAUDE.md

@@ -1,82 +1,83 @@
-# axMap 작업 규칙 — 색인 한 장
-
-이 문서는 **axMap 자체를 고칠 때** 지키는 규칙의 **입구**다. 사람도 AI 에이전트도 읽는다.
-규칙 본문은 **[`rule/`](rule/) 폴더**에 갈래별로 나뉘어 있다. **필요할 때 그 파일을 연다.**
-
-> 🔴 **2026-09-11 에 이렇게 바뀌었다.** 전에는 이 파일 하나에 전부(764줄) 들어 있었고,
-> Claude Code 는 **세션을 켤 때마다 그걸 통째로 읽는다.** 한 번도 안 쓰는 규칙까지
-> 매번 값을 치렀다. 지금은 이 색인만 항상 읽히고, 본문은 **찾아갈 때만** 읽는다.
-> 내용은 지우지 않았다 — 자리만 옮겼다.
-
-**이 문서가 기준이 되게 하려면 `claude` 를 이 폴더에서 켠다.** Claude Code 는 **켠 폴더**를
-기준으로 `CLAUDE.md` 를 읽는다. 팀 저장소 폴더에서 켜고 axMap 파일만 고치면, 읽히는 것은
-팀 규칙이지 이 문서가 아니다.
-
-```bash
-cd C:/Users/SSAFY/Desktop/axMap
-claude
-```
-
-axMap 은 **AI Experience(ax) 의 지도**다 — 에이전트가 코드베이스에서 길을 찾고 서로를
-피해 가는 경험을 만든다. 팀에서는 여행 서비스를 만드는 **도구**로 쓰인다.
-
-> **산문에서는 `axMap`, 식별자·명령·경로·패키지 이름에서는 `axmap`.**
-> 다만 **MCP 도구 이름만 `ax_` 접두사**를 쓴다 (`ax_claim`, `ax_status` …).
-> 환경변수 접두사는 `AXMAP_`, 장부 브랜치는 `axmap/claims` 다.
-
-> 🔴 **팀 규칙은 여기 없다.** axMap 은 독립 저장소이고 팀은 npm 꾸러미 `axmap-cli` 로
-> 받아 쓴다. 팀 규칙은 그 저장소의 `CONTRIBUTING.md` 에 있다 —
-> `https://lab.ssafy.com/s15-bigdata-dist-sub1/S15P21E201`.
-> 상대경로(`../CLAUDE.md`)로 걸지 않는다. 폴더가 옮겨지면 조용히 거짓말이 된다.
-
----
-
-## 시작하기 전에 세 줄
-
-| | |
-|---|---|
-| **개발선** | `team-sync` 다. `main` 이 아니다 → [rule/01](rule/01-이-저장소의-함정.md) |
-| **고치기 전에** | `node bin/axmap.mjs claim <경로> --task … --intent …` → [rule/02](rule/02-선점-작업-반납.md) |
-| **고친 코드를 돌리려면** | `node bin/axmap.mjs …`. 그냥 `axmap` 은 **다른 판**이 돈다 → [rule/01](rule/01-이-저장소의-함정.md) |
-| **싸게 물어볼 일** | `agy --model gemini-3.8-flash-low -p='…'`. 🔴 `-p=` 는 **등호로 붙여** 쓴다 → [rule/08](rule/08-agy-외부-모델.md) |
-
----
-
-## 🔴 하지 말 것 — 한눈에
-
-이 표만은 항상 읽힌다. 나머지는 찾아본다.
-
-| | 왜 |
-|---|---|
-| `git commit --no-verify` | 장부에 없는 변경이 생기고, `audit` 이 나중에 불변식 위반으로 잡는다 |
-| 아무 생각 없이 `git push` | 대상이 `origin`(팀 저장소)일 수 있다. axMap 은 **`personal team-sync`** |
-| `git merge` 로 다른 갈래 가져오기 | 공통 조상이 없어 거부당한다. `git checkout <브랜치> -- <경로>` |
-| `git merge-base` 결과를 파이프로 잇기 | 실패해도 조용하다. 종료 코드를 따로 본다 |
-| 테스트 **개수**를 문서에 적기 | 늘릴 때마다 낡는다. 판정은 종료 코드다 |
-| 실측 안 한 숫자 적기 | 확실하지 않으면 **"확인 못 함"** 이라고 쓴다 |
-| 낡은 실측 지우기 | 정정한 날짜와 함께 **둘 다** 남긴다 |
-| 선점이 방금 풀린 자리에 바로 들어가기 | 선점은 "지금" 만 막는다. 남은 결과물은 안 막는다 |
-| 새 의존성 추가 | 추가하기 전에 **사람에게 묻는다** |
-| 세기·고르기를 모델에게 시키기 | 스크립트가 토큰 0으로 **더 정확히** 한다 → [rule/08](rule/08-agy-외부-모델.md) |
-| `setx` 로 PATH 고치기 | 1024자에서 **자른다.** 잘린 줄은 경고 없이 사라진다 → [rule/08](rule/08-agy-외부-모델.md) |
-
----
-
-## 규칙 본문 — 이럴 때 이 파일을 연다
-
-문서 안에서 **"2절"** 이라고 하면 **`rule/02-…`** 를 말한다. 번호는 그대로 남겼다.
-
-| 파일 | 언제 여나 |
-|---|---|
-| [00 — 백그라운드 에이전트](rule/00-백그라운드-에이전트.md) | 일을 대화에서 직접 할지 넘길지 가를 때. 프롬프트에 무엇을 박아야 하나 |
-| [01 — 이 저장소의 함정](rule/01-이-저장소의-함정.md) | git 이 이상하게 굴 때. remote 이름·개발선·무관한 역사·`partOf()`·어느 `axmap` 이 도나 |
-| [02 — 선점 → 작업 → 반납](rule/02-선점-작업-반납.md) | 파일을 고치기 전. 거부당했을 때. 커밋 훅이 막을 때. 쪽지 주고받기 |
-| [03 — 검증](rule/03-검증.md) | 끝내기 전. 무엇을 돌려야 끝난 것인가. 화면 코드를 건드렸을 때 |
-| [04 — 코드 규칙](rule/04-코드-규칙.md) | 코드를 쓸 때. 의존성·순수 로직·fail-closed·SPEC·불변식·버전 |
-| [05 — 코드를 쓰기 전에](rule/05-코드를-쓰기-전에.md) | 무엇을 만들지 아직 안 정했을 때. 단순함·외과적 변경·선택지로 확인받기 |
-| [06 — 답변과 문서](rule/06-답변과-문서.md) | 사람에게 답할 때. 터미널에 전부·두 가지까지·기호로만 부르지 않기·용어 풀기 |
-| [07 — NotebookLM 자료 폴더](rule/07-notebooklm-자료폴더.md) | *"LM 에 넣게 자료 만들어줘"* 라는 말을 들었을 때 |
-| [08 — `agy` 로 바깥 모델 부르기](rule/08-agy-외부-모델.md) | 토큰을 아끼고 싶을 때. **부르기 전에 "모델이 정말 필요한가" 부터** |
-
-고칠 것이 있으면 **`rule/` 안의 그 파일**을 고친다. 여기에 본문을 되돌려 놓지 않는다 —
-두 벌이 되는 순간 어느 쪽이 진짜인지 아무도 모르게 된다.
+# axMap 작업 규칙 — 색인 한 장
+
+이 문서는 **axMap 자체를 고칠 때** 지키는 규칙의 **입구**다. 사람도 AI 에이전트도 읽는다.
+규칙 본문은 **[`rule/`](rule/) 폴더**에 갈래별로 나뉘어 있다. **필요할 때 그 파일을 연다.**
+
+> 🔴 **2026-09-11 에 이렇게 바뀌었다.** 전에는 이 파일 하나에 전부(764줄) 들어 있었고,
+> Claude Code 는 **세션을 켤 때마다 그걸 통째로 읽는다.** 한 번도 안 쓰는 규칙까지
+> 매번 값을 치렀다. 지금은 이 색인만 항상 읽히고, 본문은 **찾아갈 때만** 읽는다.
+> 내용은 지우지 않았다 — 자리만 옮겼다.
+
+**이 문서가 기준이 되게 하려면 `claude` 를 이 폴더에서 켠다.** Claude Code 는 **켠 폴더**를
+기준으로 `CLAUDE.md` 를 읽는다. 팀 저장소 폴더에서 켜고 axMap 파일만 고치면, 읽히는 것은
+팀 규칙이지 이 문서가 아니다.
+
+```bash
+cd C:/Users/SSAFY/Desktop/axMap
+claude
+```
+
+axMap 은 **AI Experience(ax) 의 지도**다 — 에이전트가 코드베이스에서 길을 찾고 서로를
+피해 가는 경험을 만든다. 팀에서는 여행 서비스를 만드는 **도구**로 쓰인다.
+
+> **산문에서는 `axMap`, 식별자·명령·경로·패키지 이름에서는 `axmap`.**
+> 다만 **MCP 도구 이름만 `ax_` 접두사**를 쓴다 (`ax_claim`, `ax_status` …).
+> 환경변수 접두사는 `AXMAP_`, 장부 브랜치는 `axmap/claims` 다.
+
+> 🔴 **팀 규칙은 여기 없다.** axMap 은 독립 저장소이고 팀은 npm 꾸러미 `axmap-cli` 로
+> 받아 쓴다. 팀 규칙은 그 저장소의 `CONTRIBUTING.md` 에 있다 —
+> `https://lab.ssafy.com/s15-bigdata-dist-sub1/S15P21E201`.
+> 상대경로(`../CLAUDE.md`)로 걸지 않는다. 폴더가 옮겨지면 조용히 거짓말이 된다.
+
+---
+
+## 시작하기 전에 세 줄
+
+| | |
+|---|---|
+| **개발선** | `team-sync` 다. `main` 이 아니다 → [rule/01](rule/01-이-저장소의-함정.md) |
+| **고치기 전에** | `node bin/axmap.mjs claim <경로> --task … --intent …` → [rule/02](rule/02-선점-작업-반납.md) |
+| **고친 코드를 돌리려면** | `node bin/axmap.mjs …`. 그냥 `axmap` 은 **다른 판**이 돈다 → [rule/01](rule/01-이-저장소의-함정.md) |
+| **싸게 물어볼 일** | `agy --model gemini-3.8-flash-low -p='…'`. 🔴 `-p=` 는 **등호로 붙여** 쓴다 → [rule/08](rule/08-agy-외부-모델.md) |
+
+---
+
+## 🔴 하지 말 것 — 한눈에
+
+이 표만은 항상 읽힌다. 나머지는 찾아본다.
+
+| | 왜 |
+|---|---|
+| `git commit --no-verify` | 장부에 없는 변경이 생기고, `audit` 이 나중에 불변식 위반으로 잡는다 |
+| 아무 생각 없이 `git push` | 대상이 `origin`(팀 저장소)일 수 있다. axMap 은 **`personal team-sync`** |
+| `git merge` 로 다른 갈래 가져오기 | 공통 조상이 없어 거부당한다. `git checkout <브랜치> -- <경로>` |
+| `git merge-base` 결과를 파이프로 잇기 | 실패해도 조용하다. 종료 코드를 따로 본다 |
+| 테스트 **개수**를 문서에 적기 | 늘릴 때마다 낡는다. 판정은 종료 코드다 |
+| 실측 안 한 숫자 적기 | 확실하지 않으면 **"확인 못 함"** 이라고 쓴다 |
+| 낡은 실측 지우기 | 정정한 날짜와 함께 **둘 다** 남긴다 |
+| 선점이 방금 풀린 자리에 바로 들어가기 | 선점은 "지금" 만 막는다. 남은 결과물은 안 막는다 |
+| 새 의존성 추가 | 추가하기 전에 **사람에게 묻는다** |
+| 세기·고르기를 모델에게 시키기 | 스크립트가 토큰 0으로 **더 정확히** 한다 → [rule/08](rule/08-agy-외부-모델.md) |
+| `setx` 로 PATH 고치기 | 1024자에서 **자른다.** 잘린 줄은 경고 없이 사라진다 → [rule/08](rule/08-agy-외부-모델.md) |
+
+---
+
+## 규칙 본문 — 이럴 때 이 파일을 연다
+
+문서 안에서 **"2절"** 이라고 하면 **`rule/02-…`** 를 말한다. 번호는 그대로 남겼다.
+
+| 파일 | 언제 여나 |
+|---|---|
+| [00 — 백그라운드 에이전트](rule/00-백그라운드-에이전트.md) | 일을 대화에서 직접 할지 넘길지 가를 때. 프롬프트에 무엇을 박아야 하나 |
+| [01 — 이 저장소의 함정](rule/01-이-저장소의-함정.md) | git 이 이상하게 굴 때. remote 이름·개발선·무관한 역사·`partOf()`·어느 `axmap` 이 도나 |
+| [02 — 선점 → 작업 → 반납](rule/02-선점-작업-반납.md) | 파일을 고치기 전. 거부당했을 때. 커밋 훅이 막을 때. 쪽지 주고받기 |
+| [03 — 검증](rule/03-검증.md) | 끝내기 전. 무엇을 돌려야 끝난 것인가. 화면 코드를 건드렸을 때 |
+| [04 — 코드 규칙](rule/04-코드-규칙.md) | 코드를 쓸 때. 의존성·순수 로직·fail-closed·SPEC·불변식·버전 |
+| [05 — 코드를 쓰기 전에](rule/05-코드를-쓰기-전에.md) | 무엇을 만들지 아직 안 정했을 때. 단순함·외과적 변경·선택지로 확인받기 |
+| [06 — 답변과 문서](rule/06-답변과-문서.md) | 사람에게 답할 때. 터미널에 전부·두 가지까지·기호로만 부르지 않기·용어 풀기 |
+| [07 — NotebookLM 자료 폴더](rule/07-notebooklm-자료폴더.md) | *"LM 에 넣게 자료 만들어줘"* 라는 말을 들었을 때 |
+| [08 — `agy` 로 바깥 모델 부르기](rule/08-agy-외부-모델.md) | 토큰을 아끼고 싶을 때. **부르기 전에 "모델이 정말 필요한가" 부터** |
+| [09 — 거버넌스와 권한](rule/09-거버넌스와-권한.md) | 머지 권한·봇·장부 브랜치를 건드릴 때. **왜 사람이 아니라 봇이 누르는가** |
+
+고칠 것이 있으면 **`rule/` 안의 그 파일**을 고친다. 여기에 본문을 되돌려 놓지 않는다 —
+두 벌이 되는 순간 어느 쪽이 진짜인지 아무도 모르게 된다.

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('  🔴 저절로 바뀌지 않습니다. 위 한 줄을 직접 실행할 때만 바뀝니다.')
+  } 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

@@ -71,7 +71,7 @@ import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { agentNameError } from '../src/protocol.mjs'
 import {
-  EXIT, DEFAULT_POLICY_PATH, voteNoteRule, voteNoteProblem,
+  EXIT, DEFAULT_POLICY_PATH, voteNoteRule, voteNoteProblem, selfVoteMode, DEFAULT_SELF_VOTE,
 } from '../src/governance.mjs'
 
 const VOTES_BRANCH = 'axmap/votes'
@@ -350,6 +350,35 @@ function votesHead() {
  * 최근 200 커밋으로 떨어지고, **어느 범위를 봤는지 경고에 함께 적는다** —
  * 근거를 안 적으면 사람이 경고를 믿을지 말지 판단할 수 없다.
  */
+/**
+ * 이번 판정의 `self_vote` 모드. **세는 쪽과 같은 함수로 읽는다.**
+ *
+ * 🔴 이 함수가 없어서 버그가 났다 (1.2.3 에서 고침). 세는 쪽
+ *    (`src/governance.mjs` 의 `excludedAuthors`)은 `selfVoteMode(policy)` 를 읽어
+ *    `"tip"` 이면 **맨 위 커밋 author 한 명만** 빼는데, 쓰는 쪽인 이 파일은 정책을
+ *    아예 안 보고 **언제나 모든 author** 를 막았다. 그래서 **세어질 표를 던지기도
+ *    전에 exit 으로 막았다.**
+ *
+ *    실측 (팀 저장소 S15P21E201, `common/dev → main`, 2026-09-12): 정책이
+ *    `"tip"` 이라 던질 수 있는 사람이 5명인데, 이 함수가 없어서 2명으로 보였다.
+ *    정족수가 2표라 **그 2명이 둘 다 던져야만** 통과하는 상태였다.
+ *
+ *    더 아픈 것은 `policy.json` 이 **정확히 그 교착을 피하려고** `"tip"` 으로
+ *    바꿔 두었다는 점이다 (2026-09-09). 정책은 고쳤는데 도구가 그 정책을 안 읽어서,
+ *    고친 줄 알고 지나갈 뻔했다. 바로 아래 `g1WaiverFor` 의 주석이 경고한
+ *    *"같은 규칙을 두 곳에 적으면 그 어긋남이 그대로 다시 난다"* 가 한 번 더 난 것이다.
+ *
+ * 🔴 **fail-closed.** 못 읽거나 값이 이상하면 가장 엄한 `authors` 로 떨어진다.
+ *    모를 때 풀어 주면 G1 은 성질이 아니라 스위치가 된다.
+ */
+function selfVoteModeSafe(policy) {
+  try {
+    return selfVoteMode(policy)
+  } catch {
+    return DEFAULT_SELF_VOTE
+  }
+}
+
 function selfVoteRange(branch, targetName) {
   const t = git(['rev-parse', '--verify', '--quiet', `${targetName}^{commit}`])
   if (t.code === 0 && t.out) {
@@ -390,8 +419,63 @@ function g1WaiverFor(branch, targetName, policyFlag) {
   return { eligibleCount, threshold }
 }
 
-function warnIfSelfVote(branch, targetName, email, force, policyFlag) {
-  const range = selfVoteRange(branch, targetName)
+/**
+ * **판정에 물어본다 — "이 사람이 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 자체를 끈 것이다. 막을 것도 경고할 것도 없다.
+  if (mode === 'off') return
+
+  // `tip` 은 **맨 위 커밋 하나만** 본다. 오래 쌓이는 <파트>/dev 에서 옛 커밋 때문에
+  // 막히지 않게 하려고 정책이 고른 값이고, 세는 쪽이 정확히 그렇게 센다.
+  const range = mode === 'tip'
+    ? { args: ['-n', '1', branch], label: `${branch} 의 맨 위 커밋` }
+    : selfVoteRange(branch, targetName)
+
   const r = git(['log', '--format=%aE', ...range.args])
   if (r.code !== 0) {
     console.error(`경고: 소스 브랜치의 author 를 읽지 못해 자기 표인지 확인하지 못했습니다.\n  ${r.err.split('\n')[0]}`)
@@ -400,6 +484,21 @@ function warnIfSelfVote(branch, targetName, email, force, policyFlag) {
   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) {
@@ -414,7 +513,10 @@ function warnIfSelfVote(branch, targetName, email, force, policyFlag) {
 
   console.error(
     `이 표는 자기 표라 세지지 않습니다 (G1 — 자기가 쓴 코드에 자기가 찬성할 수 없습니다).\n`
-    + `  ${email} 이(가) ${range.label} 의 author 목록에 있습니다.\n\n`
+    + (seen
+      ? `  ${email} 이(가) ${seen.label} 의 author 목록에 있습니다.\n`
+        + `  배제 범위는 정책의 self_vote = "${seen.mode}" 가 정합니다.\n\n`
+      : `  ${email} 을(를) ${targetName} 기준 판정이 자기 표로 셉니다.\n\n`)
     + '  그래도 남기려면 --force 를 붙이세요. 파일은 남고 판정문에는 "안 센 표" 로 보입니다.\n'
     + '  조용히 무효표를 쌓지 않는 이유: 던졌다고 믿는 사람이 아무도 안 세는 표를 기다립니다.',
   )
@@ -718,7 +820,7 @@ const nameErr = agentNameError(voter)
 if (nameErr) die(`${nameErr}\n  git config user.name 을 고치세요.`)
 
 warnIfNotAVoter(roster, targetName, email)
-warnIfSelfVote(branch, targetName, email, flags.force === true, str(flags.policy))
+warnIfSelfVote(branch, targetName, email, flags.force === true, str(flags.policy), policy)
 
 // ── 이유 없는 표는 여기서 거부한다 ─────────────────────────────────────────
 //

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.2",
+  "version": "1.2.4",
   "//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/.claude/settings.local.json

@@ -1,32 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(sed -i 's|/\\\\*\\\\* 궤도 모드에서 허용하는 yaw 한계 \\(약 35°\\). cos 이 0.82 아래로 내려가지 않는다. \\\\*/\\\\nconst YAW_LIMIT = 0.62|X|' app/web/graph.js)",
-      "Bash(sed -i 's|const YAW_LIMIT = 0.62|const TILT_LIMIT = 0.62|; s|허용하는 yaw 한계|허용하는 기울기 한계 \\(yaw · pitch 공통\\)|' app/web/graph.js)",
-      "Bash(sed -i 's|인코딩은 인코딩이 아니다. cos\\(TILT_LIMIT\\)=0.82 이면 고리의 화면 반지름이\\\\n   \\\\* \\\\[0.82R, R\\\\] 안에 머물러 이웃 단계와 절대 겹치지 않는다.|X|' app/web/graph.js)",
-      "Bash(sed -n '/인코딩은 인코딩이 아니다/,+2p' app/web/graph.js)",
-      "Bash(sed -i 's|import { applyEdits, draft, editRecord } from|import { applyEdits, draft } from|' app/server.mjs)",
-      "Bash(sed -i 's|\"test\": \"node --test test/protocol.test.mjs test/model.test.mjs test/analyze.test.mjs\"|\"test\": \"node --test test/protocol.test.mjs test/model.test.mjs test/analyze.test.mjs test/features.test.mjs\"|' package.json)",
-      "Bash(npm test *)",
-      "Bash(sed -i 's|        .filter\\(\\(\\\\[t\\\\]\\) => t !== name \\\\&\\\\& !taken.has\\(t\\)\\)|        .filter\\(\\([t]\\) => t !== name \\\\&\\\\& !taken.has\\(t\\) \\\\&\\\\& !tooCommon\\(t\\)\\)|' app/lib/features.mjs)",
-      "Bash(node -e ' *)",
-      "Bash(npm run *)",
-      "Bash(export AXMAP_AGENT=claude-fix GIT_AUTHOR_NAME=claude-fix GIT_AUTHOR_EMAIL=claude-fix@local GIT_COMMITTER_NAME=claude-fix GIT_COMMITTER_EMAIL=claude-fix@local)",
-      "Bash(node bin/axmap.mjs claim app/web/app.js app/web/graph.js app/web/style.css --task fix-click-color --intent \"이름 클릭=강조/더블클릭=이름변경, 단계 없을 때 색 회귀 수정\" --actor agent)",
-      "Bash(sed 's/\\\\$$//')",
-      "Bash(python -)",
-      "Bash(sed -n '/import 를 뽑을 수 있는 언어 이름/,/^\\\\]\\)/p' app/lib/analyze.mjs)",
-      "Bash(export AXMAP_AGENT=janghyojoon)",
-      "Bash(node bin/axmap.mjs release)",
-      "Bash(echo \"// 테스트\")",
-      "Bash(git add *)",
-      "Bash(git commit *)",
-      "Bash(git reset *)",
-      "Bash(git checkout *)"
-    ]
-  },
-  "enabledMcpjsonServers": [
-    "axmap"
-  ],
-  "enableAllProjectMcpServers": true
-}