@kaydash9999/banker-plugins 0.7.0 → 0.8.0

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Claude Code skills + commands — QA, audit, docs, architecture, dependency setup, and wiki; the banker plugin marketplace.",
-    "version": "0.7.0"
+    "version": "0.8.0"
   },
   "plugins": [
     {

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "banker",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Claude Code plugin: QA/audit/docs/architecture skills + commands, a /banker:setup installer for OS dependencies (playwright, etc.), and wiki compaction.",
   "author": {
     "name": "smallOpenSource",

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## [0.8.0] - 2026-07-17
+
+### Added
+- README 에 npm 월간 다운로드 배지와 GitHub stars 배지를 추가했다.
+- `banker setup` 최초 실행 시 GitHub 저장소 별(star)을 요청하는 프롬프트를 추가했다(양 런타임 공통·홍보 목적·카운팅 opt-out 여부와 무관).
+- **업데이트-체크 서비스**: 이전 초안(opt-in 익명 텔레메트리 클라이언트, 기본값 미수집)은 동의자가 거의 없어 사용량 가시성이라는 목표를 달성하지 못한다고 판단해 두 기능으로 재구성(피벗)했다.
+  - **업데이트 알림**: 공개 npm 레지스트리(`registry.npmjs.org/@kaydash9999/banker-plugins/latest`)를 조회해 세션 시작 시 새 버전이 있으면 알린다. 조회 요청의 수신자는 npm(GitHub/Microsoft)이고, banker 유지보수자는 이 조회를 받지 않는다. 기본값 켜짐, `BANKER_NO_UPDATE_CHECK` 환경변수 또는 `config.updateCheck=false` 로 끌 수 있다.
+  - **사용량 카운팅(count-default-on)**: 하루 1회 스킬/커맨드별 호출 수를 시간대(hour-of-day)별로 버킷화해 플러그인 버전·OS 종류와 함께 유지보수자가 운영하는 외부 엔드포인트로 익명 체크인한다. 집계는 사용자가 직접 입력한 `/banker:*` 커맨드와 모델이 자동 호출한 스킬 양쪽을 서로 다른 두 훅으로 겹침 없이 포착한다. 기본값 켜짐, `BANKER_NO_TELEMETRY` 환경변수·`config.telemetry=false`·`banker telemetry off` 로 끌 수 있다.
+  - **기본 카운팅 엔드포인트 내장**: 배포에 기본 엔드포인트(`banker.banker-plugins.workers.dev`, 유지보수자의 Cloudflare Worker)를 박아 `endpoint()` 가 env·config 미설정이어도 이를 반환한다. 그 결과 `countingActive()` 가 실제로 default-on 이 되어 opt-out 하지 않은 모든 설치에서 카운팅이 활성이다(이전엔 엔드포인트 미설정이라 사실상 유지보수자 셸만 잡혔다). 자가호스팅/override 는 `BANKER_TELEMETRY_ENDPOINT` 환경변수로 한다.
+  - 두 기능 모두 Claude Code 전용이다. Codex CLI는 샌드박스가 네트워크 접근을 차단하므로 알림·카운팅 둘 다 배제된다.
+  - `PRIVACY.md` 를 이 설계에 맞게 재작성했다: 알림/카운팅을 분리 기술하고 각각의 수신자를 이름으로 명시했다(알림=npm, 카운팅=유지보수자). 익명성이 페이로드의 속성이지 시스템 전체의 속성은 아니라는 점(카운팅 서버는 소스 IP를 수신하되 기록하지 않도록 설계)을 정직하게 밝혔다. EU ePrivacy Art.5(3)·Planet49 판례는 표준 관행 근거와 반대 근거를 양면으로 제시했고, 미국 CCPA·한국 PIPA는 이 익명 체크인에 재적용하지 않는다는 점(실무 판단 기준인 IP 지속 보유·프로파일링·판매에 해당하지 않음)을 명기했다.
+
+### Notes
+- **정직 명시**: 이 릴리스는 아직 게시(publish)되지 않았다. 실제 공개는 EU ePrivacy 대상 opt-in 전환 여부를 포함한 별도 법률 검토를 통과한 뒤 진행한다.
+
+## [0.7.1] - 2026-07-16
+
+### Changed
+- README 정비(문서 전용 — 코드·스킬·배포 표면 무변경). 최상단에 총 구성요소 수(스킬 48 + 커맨드 2)를 명시하고, `라이선스 / 서드파티`의 의존 라이브러리·연동 참조 나열을 표(분류·항목·라이선스·사용 스킬)로 재구성했다. 사실은 코드와 대조해 확인했다 — banker 자체는 MIT, 코드로 재배포하는 서드파티는 `humanizer`(MIT © 2025 Siqi Chen) 단독이며 나머지는 런타임 의존·연동일 뿐이다. 도구별 사용 스킬 매핑은 `/banker:setup` 표와 교차검증했고, 원본에 라이선스가 없던 항목은 지어내지 않고 `각 프로젝트`로 표기했다.
+- README 산문 가독성. 여러 문장이 한 줄에 붙던 문단을 Markdown hard break 로 문장마다 개행(뷰어에서 실제 줄바꿈)하고, Codex 설치 안내 문장을 분리했다.
+
 ## [0.7.0] - 2026-07-16
 
 ### Added

package/PRIVACY.md

@@ -0,0 +1,94 @@
+# 프라이버시 고지
+
+> banker 플러그인의 업데이트-체크 서비스(업데이트 알림 + 익명 사용량 카운팅)에 대한 프라이버시 고지입니다.
+
+## 개요
+
+이 문서는 두 개의 독립된 기능을 설명합니다.\
+하나는 새 버전이 나왔을 때 알려주는 **업데이트 알림**이고, 다른 하나는 유지보수자가 사용량을 파악하기 위한 **익명 사용량 카운팅**입니다.\
+두 기능 모두 기본값은 켜짐(default-on)이며, 각각 독립적으로 끌 수 있습니다.\
+이 기능은 Claude Code 런타임에서만 동작합니다. Codex CLI는 샌드박스가 네트워크 접근을 차단하므로 알림과 카운팅 둘 다 동작하지 않습니다.
+
+## 현재 상태
+
+버전 0.8.0은 아직 게시(publish)되지 않았습니다.\
+공개는 아래 "법적 상태"에서 설명하는 검토를 통과한 뒤 진행합니다.\
+이 문서의 문구는 그 검토 결과에 따라 더 정교해질 수 있습니다.
+
+## 업데이트 알림
+
+공개 npm 레지스트리(`https://registry.npmjs.org/@kaydash9999/banker-plugins/latest`)에서 최신 버전을 조회하고, 설치된 버전보다 최신 버전이 있으면 세션 시작 시 알립니다.\
+이 조회 요청의 수신자는 **npm(GitHub/Microsoft가 운영)**입니다. banker 유지보수자는 이 조회를 전혀 수신하지 않습니다.\
+update-notifier·Homebrew 등 다른 CLI 도구가 쓰는 것과 같은 방식입니다.
+
+기본값은 켜짐입니다.\
+환경변수 `BANKER_NO_UPDATE_CHECK` 를 설정하거나 config의 `updateCheck` 를 `false` 로 두면 끌 수 있습니다.
+
+## 사용량 카운팅
+
+하루 1회, 유지보수자가 운영하는 외부 엔드포인트(banker 패키지 밖에서 별도로 운영되는 serverless)로 익명 체크인을 전송합니다.\
+플러그인은 기본 카운팅 엔드포인트(`banker.banker-plugins.workers.dev`)를 내장하므로, count-default-on 이라 설치 즉시 활성입니다.\
+`BANKER_TELEMETRY_ENDPOINT` 환경변수로 자가호스팅 엔드포인트를 지정하거나 override 할 수 있습니다.
+
+### 수집 항목
+
+- 스킬/커맨드별 호출 횟수를 시간대(hour-of-day, 0시~23시)별로 버킷화한 값
+- 플러그인 버전
+- OS 종류(linux/darwin/win32 수준)
+
+개별 호출의 시각은 전송하지 않고 시간대 버킷까지만 뭉쳐서 보냅니다.\
+집계 대상은 사용자가 직접 입력한 `/banker:*` 커맨드와 모델이 자동으로 호출한 스킬 양쪽 모두이며, 서로 다른 두 훅이 겹치지 않게 나누어 포착합니다.
+
+### 수집하지 않는 항목
+
+- 이름, 이메일 등 개인식별정보(PII)
+- 코드 및 파일 내용, 커맨드 인자
+- 저장소·계정 정보
+- 지속적인 사용자 또는 기기 식별자(UUID·머신ID 등을 생성하지 않습니다)
+- 페이로드 안의 IP 주소
+
+기본값은 켜짐(count-default-on)입니다.\
+환경변수 `BANKER_NO_TELEMETRY` 를 설정하거나, config의 `telemetry` 를 `false` 로 두거나, `banker telemetry off` 를 실행하면 끌 수 있습니다.\
+`banker setup` 첫 실행 시 이 기본값과 끄는 방법을 투명하게 고지합니다. 진행을 막는 opt-in 동의 프롬프트가 아니라 정보 제공입니다.
+
+## 익명성에 대한 정직한 고지
+
+익명성은 전송되는 데이터, 즉 페이로드 자체의 속성이지 시스템 전체의 속성이 아닙니다.\
+카운팅 엔드포인트는 네트워크 요청의 시스템 경계에서 TCP 소스 IP 주소를 봅니다. IP 주소는 GDPR과 한국 개인정보보호법(PIPA) 모두에서 개인정보로 취급됩니다.\
+이 엔드포인트는 banker 유지보수자가 운영하며, 수신 IP를 기록하지 않도록 설계되어 있습니다. banker 플러그인(클라이언트)과 카운팅 서버는 같은 운영자가 관리합니다.\
+반면 업데이트 알림 조회의 IP는 npm만 보며, banker 유지보수자는 어느 경로로도 보지 않습니다.\
+클라이언트인 banker가 보장하는 범위는 페이로드 안에 IP나 그 밖의 식별자를 넣지 않는다는 것까지이며, 서버가 수신 IP를 기록하지 않는 것은 서버를 운영하는 유지보수자의 설계 책임입니다.
+
+## 상시 훅 비용
+
+알림과 카운팅이 기본값으로 켜져 있기 때문에 다음 훅이 banker 활성화 중 항상 등록되어 있습니다.
+
+- `SessionStart`: 세션 시작 시 1회, 캐시된 업데이트 알림을 확인합니다(이 훅 자체는 네트워크 요청을 하지 않습니다).
+- `PostToolUse`(Skill 매처): 모델이 자동으로 호출한 스킬을 집계합니다.
+- `UserPromptExpansion`: 사용자가 직접 입력한 `/banker:*` 커맨드를 집계합니다.
+
+세 훅 모두 트리거될 때마다 짧게 실행되는 node 프로세스를 하나씩 기동합니다(수십 ms 수준).\
+opt-out 하더라도 훅의 등록 자체는 남고, 각 스크립트 내부의 게이트가 즉시 무동작으로 반환합니다.
+
+## 전송 안전
+
+- 업데이트 알림 조회는 GET 요청이며 페이로드가 없습니다.
+- 카운팅 체크인은 HTTPS만 사용합니다. 평문 http는 로컬 테스트용 loopback(localhost/127.0.0.1/::1) 엔드포인트에만 허용되고, 그 외 엔드포인트에는 거부됩니다.
+- 네트워크 조회·전송은 세션을 막지 않도록 분리 실행되며, 포그라운드 훅은 캐시 읽기만 하고 즉시 반환합니다.
+- 어떤 네트워크 오류도 삼키며(fail-closed), 항상 정상 종료합니다.
+
+## 법적 상태
+
+**EU ePrivacy는 양면을 그대로 남깁니다.**
+
+표준 관행이라는 근거: 익명 체크인, 요청 카운트, IP 미보유, 사전 고지와 opt-out의 조합은 사실상 업계 표준 관행에 해당합니다. 지속 식별자나 사용자별 프로파일을 만들지 않는 무상태 체크인이라는 점이 이 판단의 근거입니다.
+
+반대 근거: EU ePrivacy Directive Art.5(3)은 개인식별정보 여부와 무관하게 단말기(device) 접근 자체에 이용자 동의를 요구할 수 있습니다. Planet49 판례에 따르면 분석 목적의 opt-out은 유효한 동의로 인정되지 않을 수 있습니다. 즉 무상태 체크인이라도 접근 자체가 EU에서는 동의를 유발할 가능성이 있습니다.
+
+실무 결론: 실제로 EU 사용자를 대상으로 배포하기 전에는 opt-in 전환 여부를 별도로 검토해야 합니다. 게시(publish)는 이 검토를 포함한 별도의 법률 게이트이며, 아직 통과하지 않았습니다.
+
+**미국 CCPA·한국 PIPA는 이 익명 업데이트-체크에 재적용하지 않습니다.** 두 법의 실무 판단 기준은 IP 주소의 지속적 보유, 사용자별 프로파일 구축, 데이터 판매 여부입니다.\
+이 기능의 익명 체크인은 이 중 어느 것도 하지 않습니다. IP를 기록하지 않고, 지속 식별자가 없고, 데이터를 판매하지 않습니다.\
+따라서 CCPA·PIPA를 이 기능의 별도 미해결 법적 쟁점으로 표기하지 않습니다. 위에서 다룬 EU ePrivacy는 이와 무관한 별건입니다.
+
+이 문구는 향후 더 정교해질 수 있습니다.

package/README.md

@@ -4,10 +4,13 @@
 
 [![npm](https://img.shields.io/npm/v/@kaydash9999/banker-plugins)](https://www.npmjs.com/package/@kaydash9999/banker-plugins)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![npm downloads](https://img.shields.io/npm/dm/@kaydash9999/banker-plugins)](https://www.npmjs.com/package/@kaydash9999/banker-plugins) [![GitHub stars](https://img.shields.io/github/stars/smallOpenSource/banker_plugins)](https://github.com/smallOpenSource/banker_plugins)
 
-[빠른 시작](#빠른-시작) · [구성](#구성) · [설치 상세](#설치-상세-npm--codex) · [요구사항](#요구사항) · [업데이트 / 제거](#업데이트--제거) · [라이선스 / 서드파티](#라이선스--서드파티)
+[빠른 시작](#빠른-시작) · [구성](#구성) · [설치 상세](#설치-상세-npm--codex) · [요구사항](#요구사항) · [업데이트 / 제거](#업데이트--제거) · [업데이트 확인](#업데이트-확인-및-사용량-카운팅) · [라이선스 / 서드파티](#라이선스--서드파티)
 
-banker는 QA, 보안 감사, 문서, 아키텍처, 위키 작업을 위한 스킬 48개와 의존성·개발환경(OS별) 설치 스킬을 묶은 Claude Code 플러그인입니다. 설치하면 스킬과 커맨드가 `/banker:<이름>` 네임스페이스로 노출됩니다. 이 저장소 자체가 Claude Code 마켓플레이스(`.claude-plugin/marketplace.json`)이자 플러그인(`.claude-plugin/plugin.json`, name `banker`)이며, 도구에 무관한 스킬은 Codex CLI에도 설치됩니다.
+banker는 QA·보안 감사·문서·아키텍처·위키 작업과 의존성·개발환경(OS별) 설치를 아우르는 **스킬 48개 + 커맨드 2개**(총 50개 구성요소)를 묶은 Claude Code 플러그인입니다.\
+설치하면 스킬과 커맨드가 `/banker:<이름>` 네임스페이스로 노출됩니다.\
+이 저장소 자체가 Claude Code 마켓플레이스(`.claude-plugin/marketplace.json`)이자 플러그인(`.claude-plugin/plugin.json`, name `banker`)이며, 도구에 무관한 스킬은 Codex CLI에도 설치됩니다.
 
 > npm 패키지(`@kaydash9999/banker-plugins`)와 GitHub 저장소(`smallOpenSource/banker_plugins`)는 같은 메인테이너가 관리합니다.
 
@@ -69,7 +72,9 @@ playwright(브라우저 QA)나 oh-my-claudecode(OMC/OMX)처럼 별도 의존성
 | `obsidizer` | AI 위키를 의미보존 Obsidian 그래프로 정규화·상호링크·백링크 |
 | `deep-init` | 코드베이스 전체에 계층형 AGENTS.md 문서 생성/갱신 |
 
-> `obsidizer` 는 banker 최초의 플러그인 선언 hook(`hooks/hooks.json`)을 함께 설치합니다. banker가 활성화되어 있으면 이 hook은 **항상 등록**되어 위키 쓰기(`wiki_ingest`/`wiki_add`)마다 실행되고, `obsidizer --enable` 을 켜지 않은 사용자도 쓰기당 약 30ms의 node 프로세스 기동 비용을 치릅니다(플래그 확인 자체가 그 프로세스 안에서 일어나기 때문). `--enable` 전에는 아무것도 쓰지 않는 순수 no-op입니다.
+> `obsidizer` 는 banker 최초의 플러그인 선언 hook(`hooks/hooks.json`)을 함께 설치합니다.\
+> banker가 활성화되어 있으면 이 hook은 **항상 등록**되어 위키 쓰기(`wiki_ingest`/`wiki_add`)마다 node 프로세스를 띄웁니다(플래그 확인이 그 안에서 일어나므로 `--enable` 전에도 쓰기당 약 30ms).\
+> `--enable` 전에는 아무것도 쓰지 않는 순수 no-op입니다.
 
 ### 스킬: 워크플로 · 유틸
 
@@ -94,7 +99,8 @@ playwright(브라우저 QA)나 oh-my-claudecode(OMC/OMX)처럼 별도 의존성
 
 ### 스킬: 개발환경 setup (OS별 · 런타임별)
 
-USER_RESOURCES 가이드의 공통 요소를 OS별·런타임별(Claude Code/Codex)로 구성하는 얇은 실행 유닛. `/banker:setup` 오케스트레이터가 의존 순서(런타임 먼저)로 조합한다.
+USER_RESOURCES 가이드의 공통 요소를 OS별·런타임별(Claude Code/Codex)로 구성하는 얇은 실행 유닛.\
+`/banker:setup` 오케스트레이터가 의존 순서(런타임 먼저)로 조합한다.
 
 | 스킬 | 설명 |
 |---|---|
@@ -121,7 +127,8 @@ USER_RESOURCES 가이드의 공통 요소를 OS별·런타임별(Claude Code/Cod
 
 ## 설치 상세 (npm · Codex)
 
-마켓플레이스 대신 npm으로 전역 설치할 수 있고, Codex CLI에도 스킬을 설치할 수 있습니다. Codex 설치는 npm 전역 설치가 선행되어야 합니다.
+마켓플레이스 대신 npm으로 전역 설치할 수 있고, Codex CLI에도 스킬을 설치할 수 있습니다.\
+Codex 설치는 npm 전역 설치가 선행되어야 합니다.
 
 ```bash
 npm i -g @kaydash9999/banker-plugins
@@ -134,8 +141,10 @@ banker uninstall        # 제거
 
 - `--scope project` 로 프로젝트 로컬(`./.codex`)에 설치하고, `--dry-run` 으로 미리 볼 수 있습니다.
 - non-root 전용입니다(전역 sudo 설치 시 root 소유 파일을 방지). postinstall이 없으므로 `banker setup` 을 직접 실행합니다.
-- Codex에는 스킬 48개가 `~/.codex/skills/banker-<name>/` 에, 커맨드 2개가 `~/.codex/prompts/banker-<name>.md` 에 설치됩니다(`codex/manifest.json`). 디렉터리명과 일치하도록 프론트매터 `name:` 이 `banker-<name>` 으로 재작성되어 Codex가 `banker-<name>` 으로 인식합니다.
-- OMC/Claude 에 결합됐던 오케스트레이터·설치·유틸 표면(all-in-one·ultra-init·front-qa·setup·setup-omc·setup-omc-hud·setup-stitch·omc-reference·compact-copy)은 본문이 **런타임 인식**이라 Codex에서도 동작합니다 — Codex에선 OMC 대신 **oh-my-codex(OMX)** 의 동명 스킬(ralplan·ralph·ultraqa·hud 등)과 `codex mcp`·내장 `/copy` 를 사용합니다(Codex는 `omx setup` 전제).
+- Codex에는 스킬 48개가 `~/.codex/skills/banker-<name>/` 에, 커맨드 2개가 `~/.codex/prompts/banker-<name>.md` 에 설치됩니다(`codex/manifest.json`). \
+  디렉터리명과 일치하도록 프론트매터 `name:` 이 `banker-<name>` 으로 재작성되어 Codex가 `banker-<name>` 으로 인식합니다.
+- OMC/Claude 에 결합됐던 오케스트레이터·설치·유틸 표면(all-in-one·ultra-init·front-qa·setup·setup-omc·setup-omc-hud·setup-stitch·omc-reference·compact-copy)은 본문이 **런타임 인식**이라 Codex에서도 동작합니다.
+- Codex에선 OMC 대신 **oh-my-codex(OMX)** 의 동명 스킬(ralplan·ralph·ultraqa·hud 등)과 `codex mcp`·내장 `/copy` 를 사용합니다(Codex는 `omx setup` 전제).
 - `~/.codex/AGENTS.md` 는 건드리지 않습니다(omx가 재생성하므로 `~/.codex/skills/` 자동 검색에 의존).
 
 ## 요구사항
@@ -166,24 +175,71 @@ banker uninstall                        # 제거
 
 Codex는 재설치할 때마다 기존 `banker-*` 를 먼저 정리하므로 옛 버전이 중복으로 남지 않습니다.
 
+## 업데이트 확인 및 사용량 카운팅
+
+banker는 기본값(default-on)으로 두 가지를 합니다.\
+새 버전이 나오면 세션 시작 시 알려주는 **업데이트 알림**과, 유지보수자가 사용량을 파악하는 **익명 사용량 카운팅**입니다.\
+이 때문에 `SessionStart`(알림 확인)·`PostToolUse`(모델이 자동 호출한 스킬 집계)·`UserPromptExpansion`(사용자가 직접 입력한 `/banker:*` 집계) 훅이 항상 등록되어 있고, 트리거될 때마다 짧게 node 프로세스를 하나씩 띄웁니다(수십 ms 수준).
+
+끄기:
+
+```bash
+export BANKER_NO_UPDATE_CHECK=1   # 업데이트 알림만 끄기
+export BANKER_NO_TELEMETRY=1      # 사용량 카운팅만 끄기
+```
+
+카운팅은 `banker telemetry off` 로도 끌 수 있습니다.\
+플러그인은 기본 카운팅 엔드포인트(`banker.banker-plugins.workers.dev`)를 내장하므로 count-default-on 이라 설치 즉시 활성이며, `BANKER_TELEMETRY_ENDPOINT` 환경변수로 자가호스팅/override 할 수 있습니다.\
+Codex CLI는 샌드박스가 네트워크를 차단하므로 알림·카운팅 둘 다 동작하지 않습니다.
+
+무엇을 수집하고 누가 수신하는지는 [PRIVACY.md](PRIVACY.md)에 정리했습니다.
+
 ## 라이선스 / 서드파티
 
 banker 자체는 **MIT** ([LICENSE](LICENSE)). Owner: [smallOpenSource](https://github.com/smallOpenSource).
 
 **번들된 코드 (이 패키지가 재배포)**
-- `skills/humanizer`: [blader/humanizer](https://github.com/blader/humanizer) 기반, **MIT License**(© 2025 Siqi Chen). 원본 라이선스 고지는 `skills/humanizer/LICENSE` 에 포함. 패턴 목록은 Wikipedia [*Signs of AI writing*](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing)(WikiProject AI Cleanup, **CC BY-SA**)에 기반합니다.
+- `skills/humanizer`: [blader/humanizer](https://github.com/blader/humanizer) 기반, **MIT License**(© 2025 Siqi Chen).\
+  원본 라이선스 고지는 `skills/humanizer/LICENSE` 에 포함.\
+  패턴 목록은 Wikipedia [*Signs of AI writing*](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing)(WikiProject AI Cleanup, **CC BY-SA**)에 기반합니다.
 
-코드로 포함(재배포)하는 서드파티는 `humanizer` 뿐입니다. 아래는 스킬이 **런타임에 의존하거나 연동**하는 외부 요소로, banker 가 재배포하지 않으며 각 라이선스·상표는 소유자에게 있습니다.
+코드로 포함(재배포)하는 서드파티는 `humanizer` 뿐입니다.\
+아래는 스킬이 **런타임에 의존하거나 연동**하는 외부 요소로, banker 가 재배포하지 않으며 각 라이선스·상표는 소유자에게 있습니다.
 
 **의존 라이브러리·도구 (사용 시 별도 설치, 라이선스는 각 프로젝트 소유)**
-- Python: python-pptx(MIT, `arch-diagram`), python-docx(MIT, `rfp-author`), Playwright(Apache-2.0, `audit-web-page`·`play-qa`·`ultra-ui-qa`), detect-secrets(Apache-2.0, `lineage` 시크릿 스캔).
-- 브라우저·렌더링: Chromium(BSD-3-Clause), SwiftShader(Apache-2.0), Xvfb·X.Org(MIT). `setup-playwright` 및 브라우저 QA 스킬이 사용.
-- 문서·다이어그램: PlantUML(GPL 계열·다중 라이선스, `arch-diagram`), Poppler(GPL, `pdftoppm`), ImageMagick(ImageMagick License, `pdf-vision-extract`).
-- 개발환경·LSP: Node.js·nvm(MIT), uv(Apache-2.0/MIT), OpenJDK·Temurin(GPL+CE), jdtls(EPL-2.0), basedpyright(MIT)·vtsls·bash-language-server(MIT)·vscode-langservers-extracted, lsp-mcp([CesarPetrescu/lsp-mcp](https://github.com/CesarPetrescu/lsp-mcp)), tmux(ISC)·psmux, bubblewrap(LGPL-2.0), rustup. `setup-node`·`setup-python`·`setup-java`·`setup-lsp`·`setup-tmux`·`setup-sandbox` 가 설치.
-
-**연동·참조 (외부 프레임워크·서비스·브랜드)**
-- 프레임워크: oh-my-claudecode(OMC, **MIT**)·oh-my-codex(OMX, **MIT**), by [Yeachan-Heo](https://github.com/Yeachan-Heo). `all-in-one`·`ultra-init`·`/banker:front-qa`·`setup-omc` 가 사용.
-- 플러그인: insane-search(**MIT**, © fivetaku, [fivetaku/gptaku_plugins](https://github.com/fivetaku/gptaku_plugins)). `setup-insane-search` 가 설치.
-- 팀 아키텍처 팩토리: revfactory/harness(**Apache-2.0**, © Minho Hwang, [revfactory/harness](https://github.com/revfactory/harness))·Codex 포트 SaehwanPark/meta-harness(**Apache-2.0**). `harness-factory` 가 설치(banker 는 재배포하지 않고 설치·구성만 안내).
-- 서비스·디자인(독점·상표): Notion(`make-notion-guide`), Google Stitch(`setup-stitch`), Nothing 디자인 언어(`nothing-design`).
-- QA 대상 엔진(예시): Godot(MIT), Phaser(MIT) 등(`play-qa`).
+
+| 분류 | 도구 | 라이선스 | 사용 스킬 |
+|---|---|---|---|
+| Python | python-pptx | MIT | `arch-diagram` |
+| Python | python-docx | MIT | `rfp-author` |
+| Python | Playwright | Apache-2.0 | `audit-web-page`·`play-qa`·`ultra-ui-qa` |
+| Python | detect-secrets | Apache-2.0 | `lineage`(시크릿 스캔) |
+| 브라우저·렌더링 | Chromium | BSD-3-Clause | `setup-playwright`·브라우저 QA |
+| 브라우저·렌더링 | SwiftShader | Apache-2.0 | `setup-playwright`·브라우저 QA |
+| 브라우저·렌더링 | Xvfb·X.Org | MIT | `setup-playwright`·브라우저 QA |
+| 문서·다이어그램 | PlantUML | GPL 계열·다중 라이선스 | `arch-diagram` |
+| 문서·다이어그램 | Poppler(`pdftoppm`) | GPL | `pdf-vision-extract` |
+| 문서·다이어그램 | ImageMagick | ImageMagick License | `pdf-vision-extract` |
+| 개발환경·LSP | Node.js·nvm | MIT | `setup-node` |
+| 개발환경·LSP | uv | Apache-2.0/MIT | `setup-python` |
+| 개발환경·LSP | OpenJDK·Temurin | GPL+CE | `setup-java` |
+| 개발환경·LSP | jdtls | EPL-2.0 | `setup-lsp` |
+| 개발환경·LSP | basedpyright·bash-language-server | MIT | `setup-lsp` |
+| 개발환경·LSP | vtsls·vscode-langservers-extracted | 각 프로젝트 | `setup-lsp` |
+| 개발환경·LSP | lsp-mcp([CesarPetrescu/lsp-mcp](https://github.com/CesarPetrescu/lsp-mcp)) | 각 프로젝트 | `setup-lsp` |
+| 개발환경·LSP | tmux | ISC | `setup-tmux` |
+| 개발환경·LSP | psmux | 각 프로젝트 | `setup-tmux` |
+| 개발환경·LSP | bubblewrap | LGPL-2.0 | `setup-sandbox` |
+| 개발환경·LSP | rustup | 각 프로젝트 | `setup-sandbox` |
+
+**연동·참조 (외부 프레임워크·서비스·브랜드, banker 는 재배포하지 않음)**
+
+| 분류 | 항목 | 라이선스 | 사용/설치 스킬 |
+|---|---|---|---|
+| 프레임워크 | oh-my-claudecode(OMC)·oh-my-codex(OMX), by [Yeachan-Heo](https://github.com/Yeachan-Heo) | MIT | `all-in-one`·`ultra-init`·`/banker:front-qa`·`setup-omc` |
+| 플러그인 | insane-search (© fivetaku, [fivetaku/gptaku_plugins](https://github.com/fivetaku/gptaku_plugins)) | MIT | `setup-insane-search` |
+| 팀 아키텍처 팩토리 | revfactory/harness (© Minho Hwang, [revfactory/harness](https://github.com/revfactory/harness)) · Codex 포트 SaehwanPark/meta-harness | Apache-2.0 | `harness-factory`(설치·구성만 안내) |
+| 서비스(독점·상표) | Notion | 독점 | `make-notion-guide` |
+| 서비스(독점·상표) | Google Stitch | 독점 | `setup-stitch` |
+| 디자인(상표) | Nothing 디자인 언어 | 상표 | `nothing-design` |
+| QA 엔진(예시) | Godot·Phaser 등 | MIT | `play-qa` |

package/bin/banker.js

@@ -11,12 +11,14 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const cp = require('child_process');
+const { pathToFileURL } = require('url');
 
 const PKG_ROOT = path.resolve(__dirname, '..');
 const MANIFEST = path.join(PKG_ROOT, 'codex', 'manifest.json');
 const PLUGIN_JSON = path.join(PKG_ROOT, '.claude-plugin', 'plugin.json');
 const MARKETPLACE = 'banker-plugins';
 const PLUGIN_NAME = 'banker';
+const REPO_URL = 'https://github.com/smallOpenSource/banker_plugins';
 
 function version() {
   try { return require(path.join(PKG_ROOT, 'package.json')).version; } catch { return '0.0.0'; }
@@ -25,9 +27,10 @@ function log(...a) { console.log(...a); }
 function warn(...a) { console.error(...a); }
 
 function parseArgs(argv) {
-  const a = { cmd: null, claude: false, codex: false, scope: 'user', scopeExplicit: false, dryRun: false, help: false, version: false };
+  const a = { cmd: null, sub: null, claude: false, codex: false, scope: 'user', scopeExplicit: false, dryRun: false, help: false, version: false };
   for (const t of argv) {
-    if (t === 'setup' || t === 'doctor' || t === 'uninstall' || t === 'help') { if (!a.cmd) a.cmd = t; }
+    if (t === 'setup' || t === 'doctor' || t === 'uninstall' || t === 'help' || t === 'telemetry') { if (!a.cmd) a.cmd = t; }
+    else if (t === 'on' || t === 'off' || t === 'status') { if (!a.sub) a.sub = t; } // telemetry subcommand
     else if (t === '--claude') a.claude = true;
     else if (t === '--codex') a.codex = true;
     else if (t === '--dry-run' || t === '-n') a.dryRun = true;
@@ -228,11 +231,111 @@ function uninstallCodex(dryRun, scopes) {
   }
 }
 
+/* ---------- telemetry config bridge ---------- */
+// bin/banker.js is CommonJS; telemetry-config is ESM (.mjs). Load it lazily via dynamic import
+// (pathToFileURL keeps the specifier valid on Windows). Only the interactive setup path and the
+// telemetry subcommand call this, so the non-TTY / dry-run setup path never imports it.
+async function loadTelemetry() {
+  return import(pathToFileURL(path.join(__dirname, 'lib', 'telemetry-config.mjs')).href);
+}
+
+/* ---------- setup first-run prompts (US-6) ---------- */
+// Interactive-only. ABSOLUTE rule: never prompt or persist in a non-TTY / CI / dry-run context.
+// scripts/smoke-test.js runs `setup --claude --dry-run` non-interactively; a blocking read here
+// would hang CI forever. The isTTY + dryRun guard below is the single gate that prevents that.
+async function maybeFirstRunPrompts(a) {
+  if (!process.stdin.isTTY || a.dryRun) return;                     // non-TTY / CI / dry-run: do nothing
+  const tc = await loadTelemetry();
+  const cfg = tc.readConfig();
+  const askStar = cfg.promptedStarV1 !== true;
+  // count-default-on: 카운팅은 opt-in 질문이 아니라 투명 고지(차단 프롬프트 아님). --claude 관여 시에만 1회 출력.
+  const showTelemetryNotice = a.claude && cfg.promptedTelemetryV2 !== true;
+  if (!askStar && !showTelemetryNotice) return;                     // already shown before - never re-show
+
+  const readline = require('readline');
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const ask = (q) => new Promise((res) => rl.question(q, res));
+  const next = { ...cfg };
+  try {
+    if (askStar) {
+      const ans = (await ask('banker가 유용했다면 GitHub 별(star)을 눌러 주세요. [Y/n] ')).trim().toLowerCase();
+      if (ans === '' || ans === 'y' || ans === 'yes') {
+        log('감사합니다. 아래 주소에서 직접 별을 눌러 주세요 (자동으로 누르지 않고 안내만 합니다):');
+        log(`  ${REPO_URL}`);
+      }
+      next.promptedStarV1 = true;
+    }
+    if (showTelemetryNotice) {
+      log('banker 는 익명 사용량 카운트를 기본 수집합니다(스킬별 호출수·버전·OS·식별자 없음).');
+      log('끄려면 BANKER_NO_TELEMETRY=1 또는 `banker telemetry off`. 자세히: PRIVACY.md');
+      next.promptedTelemetryV2 = true;
+    }
+  } finally {
+    rl.close();
+  }
+  tc.writeConfig(next);
+}
+
+/* ---------- telemetry subcommand (US-08, count-default-on) ---------- */
+const TELEMETRY_USAGE = `Usage: banker telemetry <on|off|status>
+  on      카운팅 opt-out 을 해제 (기본값인 켜짐으로 복귀)
+  off     카운팅을 끔 (config.telemetry=false 로 opt-out)
+  status  카운팅 / 업데이트-체크의 opt-out · 엔드포인트 · 캐시 상태를 정직하게 출력`;
+
+async function telemetryCmd(sub) {
+  const tc = await loadTelemetry();
+  if (sub === 'on' || sub === 'off') {
+    const cfg = tc.readConfig();
+    if (sub === 'off') cfg.telemetry = false;                        // opt-out 저장
+    else delete cfg.telemetry;                                       // opt-out 해제: 기본-on 으로 복귀
+    if (!tc.writeConfig(cfg)) {
+      warn('banker: 설정을 저장하지 못했습니다 (config 쓰기 실패).');
+      process.exitCode = 1;
+      return;
+    }
+    if (sub === 'off') {
+      log('카운팅을 껐습니다 (off). config.telemetry=false 로 opt-out 을 저장했습니다.');
+    } else {
+      log('카운팅 opt-out 을 해제했습니다 (on). 기본값(켜짐)으로 복귀합니다.');
+      if (!tc.endpoint()) log('참고: 엔드포인트가 설정되어 있지 않아 지금은 아무것도 전송하지 않습니다.');
+    }
+    return;
+  }
+  if (sub === 'status') {
+    const cfg = tc.readConfig();
+    const v = process.env.BANKER_NO_TELEMETRY;
+    const envOptOut = !(v === undefined || v === '' || v === '0' || v === 'false');
+    const cfgOptOut = cfg.telemetry === false;
+    log('banker 상태:');
+    log('[카운팅] 익명 사용량 카운팅 (기본값: 켜짐 · count-default-on)');
+    log(`  엔드포인트 설정: ${tc.endpoint() != null ? '설정됨' : '미설정'}`);
+    log(`  opt-out(BANKER_NO_TELEMETRY): ${envOptOut ? '적용됨' : '미적용'}`);
+    log(`  opt-out(config.telemetry=false): ${cfgOptOut ? '적용됨' : '미적용'}`);
+    log(`  실효 상태(effective): ${tc.countingActive() ? 'enabled' : 'disabled'}`);
+    log('  참고: 엔드포인트가 설정되어 있고 opt-out 이 아닐 때(env·config 둘 다 아님)만 실제로 전송됩니다.');
+
+    let cache = {};
+    try { cache = JSON.parse(fs.readFileSync(tc.UPDATE_CHECK_PATH, 'utf8')); } catch { /* 캐시 없음/malformed */ }
+    const installed = tc.installedVersion();
+    const cmp = (cache.latest && installed) ? tc.compareVersions(cache.latest, installed) : null;
+    log('[업데이트 체크] 새 버전 알림 (기본값: 켜짐)');
+    log(`  opt-out(BANKER_NO_UPDATE_CHECK/config.updateCheck=false): ${tc.noUpdateCheck() ? '적용됨' : '미적용'}`);
+    log(`  마지막 체크: ${cache.checkedAt ? new Date(cache.checkedAt).toISOString() : '없음'}`);
+    log(`  캐시된 최신 버전: ${cache.latest || '없음'} / 설치된 버전: ${installed || '알 수 없음'}`);
+    log(cmp === null ? '  비교 불가 (캐시 없음 또는 malformed)'
+      : cmp > 0 ? `  업데이트 있음 (${installed} → ${cache.latest})`
+      : '  최신 버전 사용 중');
+    return;
+  }
+  log(TELEMETRY_USAGE);                                              // 알 수 없는 하위명령: 사용법 출력
+}
+
 const HELP = `banker v${version()} — install the banker plugin into Claude Code and/or Codex CLI
 
 Usage:
   banker setup [--claude] [--codex] [--scope user|project] [--dry-run]
   banker uninstall [--claude] [--codex] [--scope user|project] [--dry-run]
+  banker telemetry <on|off|status>
   banker doctor
   banker help
 
@@ -240,18 +343,22 @@ Notes:
   - setup/uninstall with no target flag applies to BOTH tools.
   - --claude registers the marketplace + installs banker@banker-plugins (skills as /banker:*).
   - --codex copies codex-eligible skills -> ~/.codex/skills/banker-* and commands -> ~/.codex/prompts/banker-*.md.
+  - telemetry on|off toggles anonymous usage counting opt-out (default-on; config only); status prints counting + update-check state. See PRIVACY.md.
   - Never runs as root. --dry-run prints planned actions without writing.`;
 
-function main() {
+async function main() {
   const a = parseArgs(process.argv.slice(2));
   if (a.version) { log(version()); return; }
   if (a.help || a.cmd === 'help' || !a.cmd) { log(HELP); return; }
   if (a.cmd === 'doctor') { doctor(); return; }
+  if (a.cmd === 'telemetry') { await telemetryCmd(a.sub); return; }
   assertNotRoot();
   if (a.cmd === 'setup') {
     log(`banker setup${a.dryRun ? ' (dry-run)' : ''}: claude=${a.claude} codex=${a.codex}`);
     if (a.claude) setupClaude(a.dryRun);
     if (a.codex) setupCodex(a.dryRun, a.scope);
+    // Best-effort first-run prompts (interactive TTY only). A prompt failure must never fail setup.
+    try { await maybeFirstRunPrompts(a); } catch { /* non-fatal */ }
     log('done.');
     return;
   }
@@ -262,4 +369,4 @@ function main() {
     return;
   }
 }
-main();
+main().catch((e) => { warn('banker:', e && e.message ? e.message : e); process.exitCode = 1; });

package/bin/lib/telemetry-config.mjs

@@ -0,0 +1,198 @@
+/*
+ * telemetry-config - banker 텔레메트리 config/consent 공용 모듈 (bin·hook 공유).
+ * 의존성 0 (Node 내장 모듈만: node:fs, node:path, node:os). ESM(.mjs).
+ * import 시 부작용 없음: 경로는 resolver 로 호출 시 계산하고, 파일시스템 접근·mkdir 은
+ * 각 함수 호출 시에만 일어난다. readConfig/isEnabled/endpoint 는 어떤 예외도 밖으로 던지지 않는다.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+// 단일 config-path resolver. 호출 시점의 env 를 읽어 계산한다 (테스트는 XDG_CONFIG_HOME 으로 격리).
+export function configDir() {
+  const xdg = process.env.XDG_CONFIG_HOME;
+  if (xdg) return path.join(xdg, 'banker');
+  if (process.platform === 'win32') {
+    return path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'banker');
+  }
+  return path.join(os.homedir(), '.config', 'banker');
+}
+
+// 공유 경로 상수: import 시점의 resolver 결과를 캡처한다 (bin·hook 은 단명 프로세스라 env 안정적).
+// 순수 경로 계산이라 파일시스템을 건드리지 않는다. 내부 함수는 configDir() 를 매 호출 재계산하므로
+// 테스트가 XDG_CONFIG_HOME 을 바꿔도 올바르게 격리된다.
+export const USAGE_LOG_PATH = path.join(configDir(), 'usage-log');   // 사용량 로그 절대경로
+export const LAST_FLUSH_PATH = path.join(configDir(), 'last-flush');
+// USAGE_LOG 계약: 한 줄 = `<skill-name>\t<hour 0-23>` (스킬 이름 + TAB + 기록 시각의 로컬 hour).
+// flush 는 이 줄들을 스킬별 x 시간대별로 집계한다. LOG_MAX_LINES 는 (필드 아닌) 줄 수 상한이며,
+// 초과 시 오래된 줄부터 잘라내 24h 윈도우를 근사한다.
+export const LOG_MAX_LINES = 5000;
+
+// update-check 캐시 파일({latest,checkedAt,notified})의 절대경로. USAGE_LOG_PATH 와 동일하게
+// import 시점 resolver 결과를 캡처한다(단명 hook 프로세스용). writeUpdateCache 는 테스트 격리를 위해
+// configDir() 를 매 호출 재계산하므로 이 상수에 의존하지 않는다.
+export const UPDATE_CHECK_PATH = path.join(configDir(), 'update-check.json');
+// 업데이트 체크/체크인 스로틀 창(24h). 이 간격 미경과면 재조회하지 않는다.
+export const UPDATE_THROTTLE_MS = 24 * 60 * 60 * 1000;
+// 최신 버전 조회용 공개 npm 레지스트리 URL. 본문 .version 을 직접 반환한다(실측 확정).
+export const NPM_LATEST_URL = 'https://registry.npmjs.org/@kaydash9999/banker-plugins/latest';
+
+// config.json 을 읽어 객체로 반환. 파일 없음·malformed JSON·권한 오류 등 어떤 예외에도 던지지 않고 {} 반환.
+export function readConfig() {
+  try {
+    const raw = fs.readFileSync(path.join(configDir(), 'config.json'), 'utf8');
+    const obj = JSON.parse(raw);
+    return (obj && typeof obj === 'object' && !Array.isArray(obj)) ? obj : {};
+  } catch {
+    return {};
+  }
+}
+
+// configDir 을 mkdir -p 후 config.json 에 기록. 오류는 삼켜 false, 성공 true.
+export function writeConfig(obj) {
+  try {
+    const target = configDir();
+    fs.mkdirSync(target, { recursive: true });
+    fs.writeFileSync(path.join(target, 'config.json'), JSON.stringify(obj, null, 2));
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// 배포에 내장하는 기본 카운팅 엔드포인트(유지보수자가 운영하는 Cloudflare Worker). 이 상수를 내장해서
+// count-default-on 이 모든 설치에서 활성이다: endpoint() 가 (거의) 항상 값을 반환하므로 countingActive()
+// 가 기본 켜짐이 되고, opt-out(BANKER_NO_TELEMETRY / banker telemetry off / config.telemetry=false)으로만
+// 끈다. 자가호스팅/override 는 BANKER_TELEMETRY_ENDPOINT env 로 한다.
+export const DEFAULT_ENDPOINT = 'https://banker.banker-plugins.workers.dev/';
+
+// 카운팅 엔드포인트 문자열. 우선순위: env(BANKER_TELEMETRY_ENDPOINT) > config.endpoint > DEFAULT_ENDPOINT.
+// 기본 엔드포인트를 내장하므로 env·config 미설정이어도 DEFAULT_ENDPOINT 를 반환한다(= count-default-on 이
+// 모든 설치에서 활성, opt-out 으로만 끔). env 빈문자열('')은 falsy 라 여전히 config/DEFAULT 로 흐른다.
+// 예외가 난 경우에만 null 을 반환한다(에러 시 보수적으로 전송 안 함).
+export function endpoint() {
+  try {
+    const env = process.env.BANKER_TELEMETRY_ENDPOINT;
+    if (env) return env;
+    const ep = readConfig().endpoint;
+    return (typeof ep === 'string' && ep) ? ep : DEFAULT_ENDPOINT;
+  } catch {
+    return null;
+  }
+}
+
+// env 값이 opt-out 을 의미하는지. unset·''·'0'·'false' 는 opt-out 이 아니고, 그 외 모든 값이 opt-out.
+// BANKER_NO_TELEMETRY 와 BANKER_NO_UPDATE_CHECK 가 동일 규칙을 공유한다.
+function isOptOut(v) {
+  return !(v === undefined || v === '' || v === '0' || v === 'false');
+}
+
+// BANKER_NO_TELEMETRY 가 opt-out 을 의미하는지.
+function noTelemetry() {
+  return isOptOut(process.env.BANKER_NO_TELEMETRY);
+}
+
+// [예약] opt-in 게이트. 현재 카운팅은 countingActive(default-on)를 쓰므로 프로덕션 호출자는 없다.
+// 향후 EU 등에서 opt-in 전환이 필요할 때(PRIVACY.md 법적 상태 참조) 재도입할 수 있게 보존한다.
+// 다음이 전부 참일 때만 true: (1) readConfig().telemetry===true, (2) 엔드포인트 설정됨,
+// (3) BANKER_NO_TELEMETRY 가 opt-out 아님. 전체를 try/catch 로 감싸 어떤 예외에도 false.
+export function isEnabled() {
+  try {
+    if (readConfig().telemetry !== true) return false;
+    if (!endpoint()) return false;
+    if (noTelemetry()) return false;
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// 업데이트 체크를 opt-out 했는지. env BANKER_NO_UPDATE_CHECK 가 opt-out 이거나
+// readConfig().updateCheck===false 이면 true. 전체를 try/catch 로 감싸 어떤 예외에도 false.
+export function noUpdateCheck() {
+  try {
+    if (isOptOut(process.env.BANKER_NO_UPDATE_CHECK)) return true;
+    if (readConfig().updateCheck === false) return true;
+    return false;
+  } catch {
+    return false;
+  }
+}
+
+// 익명 사용량 카운팅이 활성인지 (default-on). isEnabled 의 opt-in(telemetry===true) 과 달리
+// telemetry 미설정도 활성으로 본다: (1) 엔드포인트 설정됨, (2) BANKER_NO_TELEMETRY 가 opt-out 아님,
+// (3) readConfig().telemetry!==false. 셋 다 참이면 true. 전체를 try/catch 로 감싸 어떤 예외에도 false.
+export function countingActive() {
+  try {
+    if (!endpoint()) return false;
+    if (noTelemetry()) return false;
+    if (readConfig().telemetry === false) return false;
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// 이 모듈 파일 기준 플러그인 루트의 plugin.json 절대경로 (bin/lib -> 루트 = 두 단계 위).
+// fileURLToPath·path 는 순수 계산이라 import 부작용이 없다(파일 읽기는 installedVersion 호출 시에만).
+const PLUGIN_JSON_PATH = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', '.claude-plugin', 'plugin.json');
+
+// 설치된 플러그인 버전 문자열. 기본 경로는 플러그인 루트의 .claude-plugin/plugin.json 이며,
+// 테스트가 임의 경로를 주입할 수 있게 파라미터로도 받는다. 파일없음·malformed·비문자열·빈문자열 → null.
+export function installedVersion(pluginJsonPath = PLUGIN_JSON_PATH) {
+  try {
+    const v = JSON.parse(fs.readFileSync(pluginJsonPath, 'utf8')).version;
+    return (typeof v === 'string' && v) ? v : null;
+  } catch {
+    return null;
+  }
+}
+
+// 'x.y.z' 두 버전을 major.minor.patch 정수 3튜플로 비교한다. a>b 면 양수, a<b 면 음수, 같으면 0.
+// prerelease 접미사('1.2.3-rc1')·토큰 누락('1.2')·비수치('a.b.c')가 있으면 null(미확정) 반환.
+// 순수 함수이며 어떤 입력에도 throw 하지 않는다.
+export function compareVersions(a, b) {
+  const parse = (s) => {
+    if (typeof s !== 'string') return null;
+    const parts = s.split('.');
+    if (parts.length !== 3) return null;
+    const nums = [];
+    for (const part of parts) {
+      if (!/^\d+$/.test(part)) return null; // 빈·비수치·prerelease('3-rc1') 토큰 배제
+      nums.push(Number(part));
+    }
+    return nums;
+  };
+  const pa = parse(a);
+  const pb = parse(b);
+  if (pa === null || pb === null) return null;
+  for (let i = 0; i < 3; i++) {
+    if (pa[i] !== pb[i]) return pa[i] - pb[i];
+  }
+  return 0;
+}
+
+// update-check 캐시를 read-modify-write 로 병합 기록한다: 기존 JSON 을 읽어({} on 실패) patch 의
+// 필드만 덮고 나머지 형제 필드는 보존한 뒤, configDir() mkdir -p → temp 파일 쓰기 → rename(원자적)
+// 으로 기록한다. 테스트 격리를 위해 경로는 configDir() 로 매 호출 재계산한다(UPDATE_CHECK_PATH 상수
+// 비의존). 모든 오류를 삼켜 best-effort: 성공 true, 실패 false.
+export function writeUpdateCache(patch) {
+  try {
+    const dir = configDir();
+    fs.mkdirSync(dir, { recursive: true });
+    const cachePath = path.join(dir, 'update-check.json');
+    let existing = {};
+    try {
+      const obj = JSON.parse(fs.readFileSync(cachePath, 'utf8'));
+      if (obj && typeof obj === 'object' && !Array.isArray(obj)) existing = obj;
+    } catch { /* 없음·malformed → {} */ }
+    const merged = { ...existing, ...(patch && typeof patch === 'object' && !Array.isArray(patch) ? patch : {}) };
+    const tmp = path.join(dir, `update-check.json.${process.pid}.tmp`);
+    fs.writeFileSync(tmp, JSON.stringify(merged, null, 2));
+    fs.renameSync(tmp, cachePath);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "banker obsidizer: canonicalize an OMC wiki page right after it is written, but only when the vault is armed via `obsidizer --enable`. Inert otherwise.",
+  "description": "banker hooks: obsidizer wiki canonicalization (PostToolUse, inert until `obsidizer --enable`) + anonymous usage counting (PostToolUse Skill / UserPromptExpansion, count-default-on, opt-out BANKER_NO_TELEMETRY, no-op without endpoint) + update-check notification (SessionStart, opt-out BANKER_NO_UPDATE_CHECK).",
   "hooks": {
     "PostToolUse": [
       {
@@ -11,6 +11,40 @@
             "timeout": 5
           }
         ]
+      },
+      {
+        "matcher": "Skill",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PLUGIN_ROOT\"/hooks/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/hooks/telemetry-count-skill.mjs",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "UserPromptExpansion": [
+      {
+        "matcher": "banker:.*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PLUGIN_ROOT\"/hooks/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/hooks/telemetry-count.mjs",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PLUGIN_ROOT\"/hooks/run.cjs \"$CLAUDE_PLUGIN_ROOT\"/hooks/update-notify.mjs",
+            "timeout": 5
+          }
+        ]
       }
     ]
   }

package/hooks/telemetry-count-skill.mjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/*
+ * banker 텔레메트리 count 훅 (PostToolUse, matcher: Skill) - 모델이 자동 호출한
+ * banker:<name> 스킬을 로컬 usage-log 에 `<name>\t<hour>` 한 줄로 기록한다.
+ *
+ * fail-closed 규약(각 항목은 telemetry-count-skill.test.mjs 가 검증한다):
+ *  - countingActive() 가 아니면 로컬 쓰기조차 하지 않는다. 파일도 만들지 않는다.
+ *  - 어떤 오류도 삼키고 항상 exit 0. 세션/툴호출을 절대 막지 않는다.
+ *  - PII/식별자를 다루지 않는다. 로그 한 줄 = 이름 문자열 + TAB + hour(0-23) 뿐이다.
+ *
+ * payload 필드 확정(US-4 라이브 스모크테스트): PostToolUse(Skill) stdin payload 는
+ * `tool_input.skill`(예: "banker:compact-copy")을 담는다. 보조 소스로
+ * `tool_response.commandName` 도 시도한다. 사용자가 /banker:* 를 직접 호출한 경우는
+ * UserPromptExpansion 쪽(telemetry-count.mjs)이 담당한다 - 두 경로는 disjoint 로 실측
+ * 확정되어 dedup 이 불요하다.
+ *
+ * 체크인(usage-log 집계 후 서버 전송)은 이 훅의 책임이 아니다. 트리거는 SessionStart
+ * update-notify 가 throttle 경과 시 별도로 연다 - 이 훅은 append 만 하고 flush/checkin 을
+ * spawn 하지 않는다.
+ *
+ * 배선: hooks.json 의 PostToolUse(matcher Skill)에 등록되어 모델 자동 스킬 호출 시 발화한다.
+ */
+import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
+
+import { configDir, countingActive, USAGE_LOG_PATH, LOG_MAX_LINES } from '../bin/lib/telemetry-config.mjs';
+
+// banker:<name> 전체 일치 - 이름 문자열 자체를 검증한다(TAB/개행 등 이질 문자가 섞여
+// usage-log 의 `name\thour` 형식을 깨는 것을 막는다). i 플래그는 매칭만 관대하게(실제 이름은 소문자).
+const NAME_RE = /^banker:[a-z0-9_-]+$/i;
+
+function readStdin() {
+  return new Promise((resolvePromise, rejectPromise) => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => resolvePromise(data));
+    process.stdin.on('error', rejectPromise);
+  });
+}
+
+// PostToolUse(Skill) payload 에서 모델이 자동 호출한 banker:<name> 스킬 이름을 추출한다.
+// 주 소스는 tool_input.skill, 없거나 미매치면 보조로 tool_response.commandName 을 시도한다.
+function extractName(payload) {
+  const candidates = [payload?.tool_input?.skill, payload?.tool_response?.commandName];
+  for (const c of candidates) {
+    if (typeof c === 'string' && NAME_RE.test(c)) return c;
+  }
+  return null;
+}
+
+// 파일의 개행 개수 = 줄 수(각 append 가 끝에 개행을 붙이므로). 없거나 읽기 실패면 0.
+function lineCount(path) {
+  try {
+    const raw = readFileSync(path, 'utf8');
+    return (raw.match(/\n/g) || []).length;
+  } catch {
+    return 0;
+  }
+}
+
+// usage-log 에 `<name>\t<hour>` 한 줄을 append 한다(hour = 로컬 시각 0-23). 상한 도달 시
+// 스킵(best-effort; 체크인이 비우면 재개). flush/checkin 은 여기서 spawn 하지 않는다
+// (트리거는 SessionStart update-notify 소관).
+function record(name) {
+  try { mkdirSync(configDir(), { recursive: true }); } catch { /* best-effort */ }
+  try {
+    if (lineCount(USAGE_LOG_PATH) < LOG_MAX_LINES) {
+      const hour = new Date().getHours();
+      appendFileSync(USAGE_LOG_PATH, `${name}\t${hour}\n`);
+    }
+  } catch { /* best-effort */ }
+}
+
+async function main() {
+  let raw;
+  try {
+    raw = await readStdin();
+  } catch {
+    return; // stdin 읽기 실패 - 무동작.
+  }
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    return; // malformed stdin - 무동작.
+  }
+  if (!countingActive()) return; // 카운팅 비활성 - 로컬 쓰기조차 하지 않는다.
+  const name = extractName(payload);
+  if (!name) return; // banker:<name> 아님 - 무동작.
+  record(name);
+}
+
+main()
+  .catch(() => {}) // 어떤 예외도 세션을 막지 않는다.
+  .finally(() => process.exit(0));

package/hooks/telemetry-count.mjs

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+/*
+ * banker 텔레메트리 count 훅 (UserPromptExpansion) - 사용자가 직접 호출한 /banker:<name>
+ * 커맨드를 로컬 usage-log 에 `<name>\t<hour>` 한 줄로 기록한다.
+ *
+ * fail-closed 규약(각 항목은 telemetry-count.test.mjs 가 검증한다):
+ *  - countingActive() 가 아니면 로컬 쓰기조차 하지 않는다. 파일도 만들지 않는다.
+ *  - 어떤 오류도 삼키고 항상 exit 0. 세션/프롬프트를 절대 막지 않는다.
+ *  - PII/식별자를 다루지 않는다. 로그 한 줄 = 이름 문자열 + TAB + hour(0-23) 뿐이다.
+ *
+ * payload 필드 확정(US-4 라이브 스모크테스트): UserPromptExpansion stdin payload 는
+ * `command_name`(예: "banker:setup-lsp")과 `command_source`("plugin")를 담는다. 사용자가
+ * /banker:* 를 직접 호출한 경우만 이 이벤트가 발화하고, 모델이 자동 호출하는 스킬은
+ * PostToolUse(Skill) 쪽(telemetry-count-skill.mjs)이 담당한다 - 두 경로는 disjoint 로 실측
+ * 확정되어 dedup 이 불요하다. 더 이상 방어적 다중필드 추출이 필요 없다.
+ *
+ * 체크인(usage-log 집계 후 서버 전송)은 이 훅의 책임이 아니다. 트리거는 SessionStart
+ * update-notify 가 throttle 경과 시 별도로 연다 - 이 훅은 append 만 하고 flush/checkin 을
+ * spawn 하지 않는다.
+ *
+ * 배선: hooks.json 의 UserPromptExpansion(matcher banker:.*)에 등록되어 사용자 직접 /banker:* 호출 시 발화한다.
+ */
+import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
+
+import { configDir, countingActive, USAGE_LOG_PATH, LOG_MAX_LINES } from '../bin/lib/telemetry-config.mjs';
+
+// banker:<name> 전체 일치 - 이름 문자열 자체를 검증한다(TAB/개행 등 이질 문자가 섞여
+// usage-log 의 `name\thour` 형식을 깨는 것을 막는다). i 플래그는 매칭만 관대하게(실제 이름은 소문자).
+const NAME_RE = /^banker:[a-z0-9_-]+$/i;
+
+function readStdin() {
+  return new Promise((resolvePromise, rejectPromise) => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => resolvePromise(data));
+    process.stdin.on('error', rejectPromise);
+  });
+}
+
+// UserPromptExpansion payload 에서 사용자가 직접 호출한 banker:<name> 이름을 추출한다.
+// command_source 가 'plugin' 이고 command_name 이 banker:<name> 형식일 때만 반환, 그 외 null.
+function extractName(payload) {
+  if (payload?.command_source !== 'plugin') return null;
+  const name = payload?.command_name;
+  return (typeof name === 'string' && NAME_RE.test(name)) ? name : null;
+}
+
+// 파일의 개행 개수 = 줄 수(각 append 가 끝에 개행을 붙이므로). 없거나 읽기 실패면 0.
+function lineCount(path) {
+  try {
+    const raw = readFileSync(path, 'utf8');
+    return (raw.match(/\n/g) || []).length;
+  } catch {
+    return 0;
+  }
+}
+
+// usage-log 에 `<name>\t<hour>` 한 줄을 append 한다(hour = 로컬 시각 0-23). 상한 도달 시
+// 스킵(best-effort; 체크인이 비우면 재개). flush/checkin 은 여기서 spawn 하지 않는다
+// (트리거는 SessionStart update-notify 소관).
+function record(name) {
+  try { mkdirSync(configDir(), { recursive: true }); } catch { /* best-effort */ }
+  try {
+    if (lineCount(USAGE_LOG_PATH) < LOG_MAX_LINES) {
+      const hour = new Date().getHours();
+      appendFileSync(USAGE_LOG_PATH, `${name}\t${hour}\n`);
+    }
+  } catch { /* best-effort */ }
+}
+
+async function main() {
+  let raw;
+  try {
+    raw = await readStdin();
+  } catch {
+    return; // stdin 읽기 실패 - 무동작.
+  }
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    return; // malformed stdin - 무동작.
+  }
+  if (!countingActive()) return; // 카운팅 비활성 - 로컬 쓰기조차 하지 않는다.
+  const name = extractName(payload);
+  if (!name) return; // banker:<name> 아님 - 무동작.
+  record(name);
+}
+
+main()
+  .catch(() => {}) // 어떤 예외도 세션을 막지 않는다.
+  .finally(() => process.exit(0));

package/hooks/update-checkin.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+/*
+ * banker 카운팅 체크인 훅 - usage-log 를 스킬별 x 시간대(hour 0-23)별 count 로 집계해 엔드포인트로
+ * 한 번 POST 하고, 응답의 latest 로 update-check 캐시를 겸해 갱신한다. 전송 시도 후(성공/실패 무관)
+ * 로그를 truncate 해 24h 윈도우로 상한한다. telemetry-flush 를 대체(evolve)한다.
+ *
+ * fail-closed 규약(각 항목은 update-checkin.test.mjs 가 검증한다):
+ *  - 미활성(countingActive) 또는 엔드포인트 없음이면 무동작(로그도 건드리지 않는다).
+ *  - PII/IP/지속ID 절대 미포함. 페이로드는 {version, os, counts} 세 키뿐(os=플랫폼 계열,
+ *    counts=스킬별 x 시간대별 호출수).
+ *  - 자체 네트워크 timeout 으로 hang 방지. 어떤 오류도 삼키고 항상 exit 0. 어떤 경로도 reject 안 함.
+ *  - 비-loopback 평문 http 는 전송하지 않는다(https-only). loopback http 만 로컬 테스트 mock 에 허용.
+ *
+ * count-default-on: 이 훅은 hooks.json 에 배선되지 않는다(스탠드얼론 .mjs). update-notify 가
+ * countingActive + 엔드포인트 설정 시 fetcher 로 detached spawn 한다(응답 latest 가 알림 캐시를 겸함).
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import http from 'node:http';
+import https from 'node:https';
+
+import {
+  countingActive,
+  endpoint,
+  USAGE_LOG_PATH,
+  LAST_FLUSH_PATH,
+  installedVersion,
+  writeUpdateCache,
+} from '../bin/lib/telemetry-config.mjs';
+
+const NET_TIMEOUT_MS = 10_000;
+
+// usage-log 각 줄 `<name>\t<hour 0-23>` 를 스킬별 x 시간대별 count 로 집계한다.
+// 빈 줄·TAB 없는 줄·이름 없는 줄·hour 가 0-23 정수가 아닌 줄은 무시한다.
+// 반환 예: { 'banker:compact-copy': { '9': 3, '14': 1 }, 'banker:setup': { '9': 1 } }.
+function aggregate(raw) {
+  const counts = {};
+  for (const line of raw.split('\n')) {
+    if (!line.trim()) continue;              // 빈 줄 무시.
+    const tab = line.indexOf('\t');
+    if (tab < 0) continue;                    // TAB 없는 malformed 줄 무시.
+    const name = line.slice(0, tab).trim();
+    const hourStr = line.slice(tab + 1).trim();
+    if (!name) continue;                      // 이름 없는 줄 무시.
+    if (!/^\d+$/.test(hourStr)) continue;     // 정수 아닌 hour 무시(음수·소수·비수치 배제).
+    const hour = Number(hourStr);
+    if (hour > 23) continue;                  // 0-23 범위 밖 무시(하한은 \d+ 가 보장).
+    const key = String(hour);                 // '09' -> '9' 정규화.
+    if (!counts[name]) counts[name] = {};
+    counts[name][key] = (counts[name][key] || 0) + 1;
+  }
+  return counts;
+}
+
+// loopback 호스트만 평문 http 를 허용한다(로컬 테스트 mock 전용). update-fetch.mjs 와 동일 판별:
+// URL.hostname 은 IPv6 를 대괄호로 감싸므로([::1]) 벗겨서 비교한다.
+function isLoopback(hostname) {
+  const h = (hostname || '').replace(/^\[|\]$/g, '').toLowerCase();
+  return h === 'localhost' || h === '127.0.0.1' || h === '::1';
+}
+
+// 엔드포인트로 JSON POST. 어떤 경로에서도 reject 하지 않고, 전송 시도가 끝나면 응답 본문(문자열)
+// 또는 null 로 resolve 한다. 자체 timeout(NET_TIMEOUT_MS)으로 무응답 엔드포인트에도 hang 하지 않는다.
+function post(url, body) {
+  return new Promise((resolvePromise) => {
+    let done = false;
+    const finish = (responseBody = null) => { if (!done) { done = true; resolvePromise(responseBody); } };
+    let parsed;
+    try {
+      parsed = new URL(url);
+    } catch {
+      return finish(); // 잘못된 엔드포인트 - 전송 스킵.
+    }
+    // PRIVACY.md 정합: 비-loopback 엔드포인트에는 https 만 허용한다. 평문 http 는
+    // loopback(localhost/127.0.0.1/::1) 로컬 테스트 mock 에만, http/https 외 스킴은
+    // 전송하지 않고 no-op(fail-closed). 평문 비-loopback 유출을 원천 차단한다.
+    if (parsed.protocol === 'http:') {
+      if (!isLoopback(parsed.hostname)) return finish();
+    } else if (parsed.protocol !== 'https:') {
+      return finish();
+    }
+    const transport = parsed.protocol === 'http:' ? http : https;
+    try {
+      const req = transport.request(parsed, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json', 'content-length': Buffer.byteLength(body) },
+      }, (res) => {
+        let data = '';
+        res.on('data', (c) => { data += c; });
+        res.on('end', () => finish(data));
+        res.on('error', () => finish());
+      });
+      req.on('error', () => finish()); // 연결 거부/리셋 등은 즉시 여기로.
+      req.setTimeout(NET_TIMEOUT_MS, () => req.destroy());
+      req.write(body);
+      req.end();
+    } catch {
+      finish();
+    }
+  });
+}
+
+// 응답 본문에서 latest 버전 문자열만 방어 추출. null·비문자열·빈·malformed·비문자열 latest 값 → null.
+function extractLatest(responseBody) {
+  if (typeof responseBody !== 'string' || !responseBody) return null;
+  try {
+    const obj = JSON.parse(responseBody);
+    const v = (obj && typeof obj === 'object') ? obj.latest : undefined;
+    return (typeof v === 'string' && v) ? v : null;
+  } catch {
+    return null;
+  }
+}
+
+async function main() {
+  if (!countingActive()) return; // 미활성 - 무동작(로그 미변경).
+  const url = endpoint();
+  if (!url) return;              // 엔드포인트 없음 - 무동작(로그 미변경).
+
+  // 로그 없음도 유효한 체크인(설치 펄스 + 알림 fetch 겸함): 빈 counts 로 진행한다.
+  let raw = '';
+  try { raw = readFileSync(USAGE_LOG_PATH, 'utf8'); } catch { raw = ''; }
+
+  // PII/IP/지속ID 없음: version + os(플랫폼 계열) + counts(스킬별 x 시간대)뿐.
+  const payload = JSON.stringify({
+    version: installedVersion() || 'unknown',
+    os: process.platform,
+    counts: aggregate(raw),
+  });
+  const responseBody = await post(url, payload);
+
+  // 응답의 latest 로 공유 update-check 캐시를 갱신(알림 겸함). 없으면 캐시 미변경.
+  // update-fetch 처럼 notified:null 재무장을 하지 않아도 등가다: dedupe 판정이 notified===latest
+  // (update-notify)라 전진 버전에서 구 notified 는 항상 신 latest 와 달라 재고지가 정상 발화하고,
+  // count-default-on 은 이 훅만·npm 배포는 update-fetch 만 써 같은 캐시를 겹쳐 쓰지 않는다.
+  const latest = extractLatest(responseBody);
+  if (latest) {
+    try { writeUpdateCache({ latest, checkedAt: Date.now() }); } catch { /* best-effort */ }
+  }
+
+  // 전송 시도 후(성공/실패 무관) 로그를 비워 24h 윈도우로 상한(배치 유실 허용).
+  try { writeFileSync(USAGE_LOG_PATH, ''); } catch { /* best-effort */ }
+  try { writeFileSync(LAST_FLUSH_PATH, new Date().toISOString()); } catch { /* best-effort */ }
+}
+
+main()
+  .catch(() => {}) // 어떤 예외도 삼킨다.
+  .finally(() => process.exit(0));

package/hooks/update-fetch.mjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+/*
+ * banker 업데이트 알림 fetcher 훅 - npm 레지스트리에서 최신 버전을 조회해 update-check 캐시를 갱신한다.
+ * SessionStart 알림 훅(update-notify)이 이 fetcher 를 detached 로 기동해 캐시를 채우고, 알림 렌더링
+ * 자체는 캐시만 읽는 별도 훅이 담당한다(이 파일은 네트워크 조회만 - 화면 출력 없음).
+ *
+ * fail-closed 규약(각 항목은 update-fetch.test.mjs 가 검증한다):
+ *  - throttle(UPDATE_THROTTLE_MS) 미경과면 무동작(캐시가 없으면 진행).
+ *  - 비-https 는 loopback(localhost/127.0.0.1/::1) 에서만 http 허용, 그 외 비-https 는 거부.
+ *  - 3xx 리다이렉트는 따라가지 않고 no-op.
+ *  - 응답 JSON 에서 version 문자열만 방어 추출 - 없거나 비문자열이면 무동작(캐시 미기록).
+ *  - 캐시는 writeUpdateCache 로 병합 기록: fetch 된 latest 가 기존 캐시와 다르면 notified 를 초기화
+ *    (재무장)하고, 같으면 형제 필드(notified 등)를 patch 에서 생략해 그대로 보존한다.
+ *  - 어떤 오류도 삼키고 항상 exit 0. GET 뿐이라 페이로드/식별자 전송이 없다.
+ *
+ * 이 훅은 hooks.json 에 배선되지 않는다(스탠드얼론 .mjs). update-notify 가 detached spawn 한다.
+ */
+import { readFileSync } from 'node:fs';
+import http from 'node:http';
+import https from 'node:https';
+
+import { UPDATE_CHECK_PATH, UPDATE_THROTTLE_MS, NPM_LATEST_URL, writeUpdateCache } from '../bin/lib/telemetry-config.mjs';
+
+const NET_TIMEOUT_MS = 10_000;
+
+// loopback 호스트만 평문 http 를 허용한다(로컬 테스트 mock 전용). update-checkin.mjs 와 동일 판별:
+// URL.hostname 은 IPv6 를 대괄호로 감싸므로([::1]) 벗겨서 비교한다.
+function isLoopback(hostname) {
+  const h = (hostname || '').replace(/^\[|\]$/g, '').toLowerCase();
+  return h === 'localhost' || h === '127.0.0.1' || h === '::1';
+}
+
+// update-check 캐시를 읽어 객체로 반환. 없음·malformed·권한 오류 등 어떤 예외에도 던지지 않고 {} 반환.
+function readCache() {
+  try {
+    const obj = JSON.parse(readFileSync(UPDATE_CHECK_PATH, 'utf8'));
+    return (obj && typeof obj === 'object' && !Array.isArray(obj)) ? obj : {};
+  } catch {
+    return {};
+  }
+}
+
+// url 에 GET 요청해 응답 JSON 의 version 문자열만 추출한다. 실패·거부·리다이렉트·malformed 는 전부
+// null. reject 하지 않고 항상 resolve 한다(hang 방지). GET 뿐이라 페이로드·식별자 헤더가 없다.
+function fetchLatestVersion(url) {
+  return new Promise((resolvePromise) => {
+    let done = false;
+    const finish = (result) => { if (!done) { done = true; resolvePromise(result); } };
+    let parsed;
+    try {
+      parsed = new URL(url);
+    } catch {
+      return finish(null); // 잘못된 URL - 조회 스킵.
+    }
+    // 비-https 는 loopback 로컬 테스트 mock 에만 허용, 그 외 스킴/호스트는 no-op(fail-closed).
+    if (parsed.protocol === 'http:') {
+      if (!isLoopback(parsed.hostname)) return finish(null);
+    } else if (parsed.protocol !== 'https:') {
+      return finish(null);
+    }
+    const transport = parsed.protocol === 'http:' ? http : https;
+    try {
+      const req = transport.request(parsed, { method: 'GET' }, (res) => {
+        const status = res.statusCode || 0;
+        // 3xx 리다이렉트는 따라가지 않는다: 응답을 흘려보내고 no-op 으로 종료.
+        if (status >= 300 && status < 400) {
+          res.resume();
+          return finish(null);
+        }
+        let data = '';
+        res.on('data', (c) => { data += c; });
+        res.on('end', () => {
+          try {
+            const obj = JSON.parse(data);
+            const v = obj && typeof obj === 'object' ? obj.version : undefined;
+            finish((typeof v === 'string' && v) ? v : null);
+          } catch {
+            finish(null); // 빈/malformed 본문.
+          }
+        });
+        res.on('error', () => finish(null));
+      });
+      req.on('error', () => finish(null)); // 연결 거부/리셋 등은 즉시 여기로.
+      req.setTimeout(NET_TIMEOUT_MS, () => req.destroy());
+      req.end(); // GET - 요청 본문 없음.
+    } catch {
+      finish(null);
+    }
+  });
+}
+
+async function main() {
+  const cache = readCache();
+  const checkedAt = typeof cache.checkedAt === 'number' ? cache.checkedAt : null;
+  if (checkedAt !== null && (Date.now() - checkedAt) < UPDATE_THROTTLE_MS) return; // throttle 미경과 - no-op.
+
+  const url = process.env.BANKER_NPM_URL || NPM_LATEST_URL; // 테스트 주입용 override.
+  const latest = await fetchLatestVersion(url);
+  if (!latest) return; // 조회 실패·거부·malformed - 캐시 미기록.
+
+  const cachedLatest = typeof cache.latest === 'string' ? cache.latest : null;
+  if (cachedLatest !== latest) {
+    writeUpdateCache({ latest, checkedAt: Date.now(), notified: null }); // 신버전 - notified 재무장.
+  } else {
+    writeUpdateCache({ latest, checkedAt: Date.now() }); // 동일 버전 - notified 등 형제 필드는 병합 보존.
+  }
+}
+
+main()
+  .catch(() => {}) // 어떤 예외도 삼킨다.
+  .finally(() => process.exit(0));

package/hooks/update-notify.mjs

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+/*
+ * banker 업데이트-체크 알림 훅 (SessionStart) - 캐시된 최신 버전을 확인해 사용자에게
+ * 한 번 고지하고, throttle 경과 시 백그라운드 fetcher 를 detached 로 기동한다.
+ *
+ * 알림 소스는 형제 fetcher(update-fetch/update-checkin)가 채운 로컬 캐시뿐이다. 이 훅 자신은
+ * 네트워크를 건드리지 않는다: 포그라운드는 캐시 읽기만 하고, 갱신은 detached 자식에게 위임한다.
+ *
+ * fail-closed 규약(update-notify.test.mjs 가 검증):
+ *  - noUpdateCheck() opt-out(env BANKER_NO_UPDATE_CHECK 또는 config.updateCheck===false)이면 무동작.
+ *  - 캐시 없음·구버전·미확정(malformed) 버전 → 무고지.
+ *  - 알림 채널 = stdout JSON {systemMessage} (SessionStart 공통 필드·상호작용 세션 사용자 가시·실측 확정).
+ *  - 동일 latest 재고지 방지: 고지 직후 writeUpdateCache({notified: latest}) 로 기록.
+ *  - 어떤 오류도 삼키고 항상 exit 0. 세션을 절대 막지 않는다. 비TTY 안전.
+ */
+import { spawn } from 'node:child_process';
+import { readFileSync, realpathSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import {
+  UPDATE_CHECK_PATH, UPDATE_THROTTLE_MS,
+  noUpdateCheck, countingActive, endpoint,
+  installedVersion, compareVersions, writeUpdateCache,
+} from '../bin/lib/telemetry-config.mjs';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+// 업데이트 안내에 쓰는 npm 패키지 이름(고지 문구·이모지/em-dash 없음).
+const NPM_PKG = '@kaydash9999/banker-plugins';
+
+function readStdin() {
+  return new Promise((resolvePromise, rejectPromise) => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => resolvePromise(data));
+    process.stdin.on('error', rejectPromise);
+  });
+}
+
+// 캐시({latest,checkedAt,notified})를 객체로 반환. 없음·malformed·배열 → null(무고지·throttle 경과 취급).
+function readCache() {
+  try {
+    const obj = JSON.parse(readFileSync(UPDATE_CHECK_PATH, 'utf8'));
+    return (obj && typeof obj === 'object' && !Array.isArray(obj)) ? obj : null;
+  } catch {
+    return null;
+  }
+}
+
+// 캐시 latest 가 설치 버전보다 엄격히 크고 그 버전을 아직 고지하지 않았으면 systemMessage 로 1회 고지.
+// compareVersions null(미확정·malformed)·구버전·동일 → 무고지. 고지 후 notified 를 기록해 재고지를 막는다.
+function maybeNotify(cached) {
+  if (!cached) return;
+  const installed = installedVersion();
+  const cmp = compareVersions(cached.latest, installed);
+  if (cmp === null || cmp <= 0) return;          // 미확정/구/동일 → 무고지
+  if (cached.notified === cached.latest) return;  // 이미 고지한 버전 → dedupe
+  const msg = `banker ${cached.latest} 사용 가능 (현재 ${installed}). 업데이트: /banker:update-banker 또는 npm i -g ${NPM_PKG}`;
+  process.stdout.write(JSON.stringify({ systemMessage: msg }));
+  writeUpdateCache({ notified: cached.latest }); // 형제 필드(latest/checkedAt) 보존하며 notified 만 병합.
+}
+
+// checkedAt 기준 throttle 경과 여부. 캐시 없음·checkedAt 미기록/비수치 → 경과로 본다(첫 조회 유도).
+function throttleElapsed(cached) {
+  const checkedAt = cached?.checkedAt;
+  if (typeof checkedAt !== 'number') return true;
+  return (Date.now() - checkedAt) >= UPDATE_THROTTLE_MS;
+}
+
+// 갱신 fetcher 절대경로 결정: count-default-on 활성(countingActive) + 엔드포인트 설정 시
+// update-checkin.mjs(체크인이 알림 조회를 겸함), 그 외에는 update-fetch.mjs(공개 npm GET 폴백).
+// 경로는 이 파일 기준으로 resolve 한다. (형제 스토리가 생성 중 - 런타임에 존재하면 된다.)
+export function chooseFetcher() {
+  const useCheckin = countingActive() && !!endpoint();
+  return join(HERE, useCheckin ? 'update-checkin.mjs' : 'update-fetch.mjs');
+}
+
+// 갱신 fetcher 를 detached 로 기동(포그라운드 비차단). 부재/실패는 자식에서 무해히 종료된다.
+function spawnFetcher() {
+  try {
+    spawn(process.execPath, [chooseFetcher()], { detached: true, stdio: 'ignore' }).unref();
+  } catch {
+    // best-effort: 기동 실패는 삼킨다(다음 세션이 재시도).
+  }
+}
+
+async function main() {
+  // SessionStart payload 를 드레인(파이프 위생). 내용을 쓰지 않으므로 파싱 실패해도 무해.
+  try { await readStdin(); } catch { /* stdin 없음/오류 무해 */ }
+
+  if (noUpdateCheck()) return; // opt-out - 무동작.
+
+  const cached = readCache(); // 포그라운드는 캐시 읽기만(네트워크 없음).
+  maybeNotify(cached);
+  if (throttleElapsed(cached)) spawnFetcher(); // 갱신은 백그라운드로 위임.
+}
+
+// 직접 실행(훅)일 때만 main() 을 돌린다. import(테스트)시엔 chooseFetcher 만 노출하고 main 은 미실행.
+// run.cjs 가 realpath 로 resolve 한 뒤 argv[1] 로 넘겨도(심링크 배포) 양쪽을 realpath 비교해 일치시킨다.
+function invokedDirectly() {
+  try {
+    return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+  } catch {
+    return false;
+  }
+}
+
+if (invokedDirectly()) {
+  main()
+    .catch(() => {}) // 어떤 예외도 세션을 막지 않는다.
+    .finally(() => process.exit(0));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaydash9999/banker-plugins",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "banker — Claude Code + Codex CLI plugin (QA, audit, docs, architecture, wiki skills). Install via Claude Code marketplace, or `npm i -g @kaydash9999/banker-plugins` then `banker setup`.",
   "bin": {
     "banker": "bin/banker.js"
@@ -21,7 +21,8 @@
     "!**/*.test.mjs",
     "LICENSE",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "PRIVACY.md"
   ],
   "engines": {
     "node": ">=16.7.0"