@kaydash9999/banker-plugins 0.18.0 → 0.19.1

package/hooks/update-checkin.mjs

@@ -27,27 +27,32 @@ import {
   installedVersion,
   writeUpdateCache,
   changedSkillsBetween,
+  SKILL_NAME_RE,
+  collectBody,
+  netDeadlineMs,
 } from '../bin/lib/telemetry-config.mjs';
 
 const NET_TIMEOUT_MS = 10_000;
+const NET_DEADLINE_MS = netDeadlineMs(); // 교환 전체 마감(위 값은 무활동 기준).
+const MAX_BODY_BYTES = 256 * 1024; // 체크인 응답, 매니페스트 모두 수 KB 다.
 
 // 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 = {};
+  const counts = Object.create(null);
   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 (!SKILL_NAME_RE.test(name)) continue;  // banker:<slug> 꼴이 아닌 줄 무시(쓰는 훅과 같은 규칙).
     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] = {};
+    if (!counts[name]) counts[name] = Object.create(null);
     counts[name][key] = (counts[name][key] || 0) + 1;
   }
   return counts;
@@ -65,7 +70,8 @@ function isLoopback(hostname) {
 function post(url, body) {
   return new Promise((resolvePromise) => {
     let done = false;
-    const finish = (responseBody = null) => { if (!done) { done = true; resolvePromise(responseBody); } };
+    let deadline = null;
+    const finish = (responseBody = null) => { if (!done) { done = true; clearTimeout(deadline); resolvePromise(responseBody); } };
     let parsed;
     try {
       parsed = new URL(url);
@@ -85,14 +91,10 @@ function post(url, body) {
       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());
-      });
+      }, (res) => collectBody(res, MAX_BODY_BYTES, finish));
       req.on('error', () => finish()); // 연결 거부/리셋 등은 즉시 여기로.
       req.setTimeout(NET_TIMEOUT_MS, () => req.destroy());
+      deadline = setTimeout(() => { req.destroy(); finish(); }, NET_DEADLINE_MS);
       req.write(body);
       req.end();
     } catch {
@@ -120,7 +122,8 @@ function extractLatest(responseBody) {
 function fetchSkillChangesMap(url) {
   return new Promise((resolvePromise) => {
     let done = false;
-    const finish = (result) => { if (!done) { done = true; resolvePromise(result); } };
+    let deadline = null;
+    const finish = (result) => { if (!done) { done = true; clearTimeout(deadline); resolvePromise(result); } };
     let parsed;
     try {
       parsed = new URL(url);
@@ -137,20 +140,18 @@ function fetchSkillChangesMap(url) {
       const req = transport.request(parsed, { method: 'GET' }, (res) => {
         const status = res.statusCode || 0;
         if (status >= 300 && status < 400) { res.resume(); return finish(null); } // 리다이렉트 미추적.
-        let data = '';
-        res.on('data', (c) => { data += c; });
-        res.on('end', () => {
+        collectBody(res, MAX_BODY_BYTES, (data) => {
           try {
-            const obj = JSON.parse(data);
+            const obj = JSON.parse(data); // data null(한도 초과, 스트림 오류)은 null 로 읽혀 아래서 걸러진다.
             finish((obj && typeof obj === 'object' && !Array.isArray(obj)) ? obj : null);
           } catch {
             finish(null);
           }
         });
-        res.on('error', () => finish(null));
       });
       req.on('error', () => finish(null));
       req.setTimeout(NET_TIMEOUT_MS, () => req.destroy());
+      deadline = setTimeout(() => { req.destroy(); finish(null); }, NET_DEADLINE_MS);
       req.end(); // GET - 요청 본문 없음.
     } catch {
       finish(null);
@@ -158,42 +159,44 @@ function fetchSkillChangesMap(url) {
   });
 }
 
-async function main() {
-  if (!countingActive()) return; // 미활성 - 무동작(로그 미변경).
-  const url = endpoint();
-  if (!url) return;              // 엔드포인트 없음 - 무동작(로그 미변경).
-
-  // 로그 없음도 유효한 체크인(설치 펄스 + 알림 fetch 겸함): 빈 counts 로 진행한다.
+// 보낼 본문. PII/IP/지속ID 없음: version + os(플랫폼 계열) + counts(스킬별 x 시간대)뿐.
+// 로그 없음도 유효한 체크인(설치 펄스 + 알림 fetch 겸함): 빈 counts 로 진행한다.
+function checkinBody() {
   let raw = '';
   try { raw = readFileSync(USAGE_LOG_PATH, 'utf8'); } catch { raw = ''; }
+  return JSON.stringify({ version: installedVersion() || 'unknown', os: process.platform, counts: aggregate(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 만 써 같은 캐시를 겹쳐 쓰지 않는다.
+// 응답의 latest 로 공유 update-check 캐시를 갱신(알림 겸함). 없으면 캐시 미변경.
+// update-fetch 처럼 notified:null 재무장을 하지 않아도 등가다: dedupe 판정이 notified===latest
+// (update-notify)라 전진 버전에서 구 notified 는 항상 신 latest 와 달라 재고지가 정상 발화하고,
+// count-default-on 은 이 훅만·npm 배포는 update-fetch 만 써 같은 캐시를 겹쳐 쓰지 않는다.
+async function refreshUpdateCache(responseBody) {
   const latest = extractLatest(responseBody);
-  if (latest) {
-    // 개인화용: 변경-스킬 매니페스트를 best-effort GET(실패 시 changedSkills 생략, 기존 값 보존).
-    const changesUrl = process.env.BANKER_SKILL_CHANGES_URL || SKILL_CHANGES_URL; // 테스트 주입용 override.
-    const map = await fetchSkillChangesMap(changesUrl);
-    const patch = { latest, checkedAt: Date.now() };
-    if (map) patch.changedSkills = changedSkillsBetween(map, installedVersion(), latest);
-    try { writeUpdateCache(patch); } catch { /* best-effort */ }
-  }
+  if (!latest) return;
+  // 개인화용: 변경-스킬 매니페스트를 best-effort GET(실패 시 changedSkills 생략, 기존 값 보존).
+  const changesUrl = process.env.BANKER_SKILL_CHANGES_URL || SKILL_CHANGES_URL; // 테스트 주입용 override.
+  const map = await fetchSkillChangesMap(changesUrl);
+  const patch = { latest, checkedAt: Date.now() };
+  if (map) patch.changedSkills = changedSkillsBetween(map, installedVersion(), latest);
+  try { writeUpdateCache(patch); } catch { /* best-effort */ }
+}
 
-  // 전송 시도 후(성공/실패 무관) 로그를 비워 24h 윈도우로 상한(배치 유실 허용).
+// 전송 시도 후(성공/실패 무관) 로그를 비워 24h 윈도우로 상한(배치 유실 허용).
+function resetLog() {
   try { writeFileSync(USAGE_LOG_PATH, ''); } catch { /* best-effort */ }
   try { writeFileSync(LAST_FLUSH_PATH, new Date().toISOString()); } catch { /* best-effort */ }
 }
 
+async function main() {
+  if (!countingActive()) return; // 미활성 - 무동작(로그 미변경).
+  const url = endpoint();
+  if (!url) return;              // 엔드포인트 없음 - 무동작(로그 미변경).
+  const responseBody = await post(url, checkinBody());
+  await refreshUpdateCache(responseBody);
+  resetLog();
+}
+
 main()
   .catch(() => {}) // 어떤 예외도 삼킨다.
   .finally(() => process.exit(0));

package/hooks/update-fetch.mjs

@@ -19,9 +19,11 @@ 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';
+import { UPDATE_CHECK_PATH, UPDATE_THROTTLE_MS, NPM_LATEST_URL, writeUpdateCache, collectBody, netDeadlineMs } from '../bin/lib/telemetry-config.mjs';
 
 const NET_TIMEOUT_MS = 10_000;
+const NET_DEADLINE_MS = netDeadlineMs(); // 교환 전체 마감(위 값은 무활동 기준).
+const MAX_BODY_BYTES = 256 * 1024; // npm /latest 응답은 수 KB 다.
 
 // loopback 호스트만 평문 http 를 허용한다(로컬 테스트 mock 전용). update-checkin.mjs 와 동일 판별:
 // URL.hostname 은 IPv6 를 대괄호로 감싸므로([::1]) 벗겨서 비교한다.
@@ -45,7 +47,8 @@ function readCache() {
 function fetchLatestVersion(url) {
   return new Promise((resolvePromise) => {
     let done = false;
-    const finish = (result) => { if (!done) { done = true; resolvePromise(result); } };
+    let deadline = null;
+    const finish = (result) => { if (!done) { done = true; clearTimeout(deadline); resolvePromise(result); } };
     let parsed;
     try {
       parsed = new URL(url);
@@ -67,21 +70,19 @@ function fetchLatestVersion(url) {
           res.resume();
           return finish(null);
         }
-        let data = '';
-        res.on('data', (c) => { data += c; });
-        res.on('end', () => {
+        collectBody(res, MAX_BODY_BYTES, (data) => {
           try {
-            const obj = JSON.parse(data);
+            const obj = JSON.parse(data); // data null(한도 초과, 스트림 오류)은 null 로 읽혀 version 이 없다.
             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());
+      deadline = setTimeout(() => { req.destroy(); finish(null); }, NET_DEADLINE_MS);
       req.end(); // GET - 요청 본문 없음.
     } catch {
       finish(null);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaydash9999/banker-plugins",
-  "version": "0.18.0",
+  "version": "0.19.1",
   "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"

package/skills/anti-drm/SKILL.md

@@ -43,9 +43,9 @@ argument-hint: "on | off | status | config"
 
    | `- 설정:` 줄 | 다음 |
    |---|---|
-   | `없음` | 아래 "질문" 을 한 뒤 `on --runtime <런타임> --deny "<금지 목록>" --alt "<대체 목록>" --tsv <tab 또는 comma>` |
+   | `없음` | 아래 "질문" 을 한 뒤 "설정 넘기기" 대로 `on --runtime <런타임> --stdin` 실행 |
    | 파일 경로 | `on --runtime <런타임>` |
-   | `올바르지 않음` | 이유를 전하고 `config` 절차를 따름 |
+   | `올바르지 않음` | 이유를 전하고 설정을 다시 정할지 물음. 정하면 "질문" 뒤 `없음` 행과 같은 명령 실행. 그 파일은 새 파일로 바뀌고(그 자리가 폴더나 특수 파일이거나, 64KiB 보다 크거나, 읽을 수 없는 파일이면 바꾸지 않고 거부함. 링크와 하드 링크(이름이 둘 이상인 일반 파일)는 거부하지 않고 그 이름만 일반 파일로 바꾸며, 가리키던 파일은 그대로 두고 `.bak` 에 남기지 않음), anti-drm 형식이 아니면 `anti-drm.json.bak` 에 한 번 남음. 에이전트가 그 파일을 직접 지우거나 옮기지 않음 |
 
 3. 성공하면 출력의 `적용할 규칙:` 아래 규칙을 이 세션에 바로 적용. 다음 세션부터는 자동 적용
 
@@ -63,7 +63,7 @@ argument-hint: "on | off | status | config"
 
 1. `status` 로 지금 설정을 봄
 2. 지금 값을 함께 보이며 아래 "질문" 을 함
-3. `config --deny "<금지 목록>" --alt "<대체 목록>" --tsv <tab 또는 comma>` 실행
+3. "설정 넘기기" 대로 `config --stdin` 실행
 4. 이 런타임이 켜져 있으면 출력의 `적용할 규칙:` 아래 규칙을 이 세션에 바로 적용
 
 ## 질문
@@ -100,12 +100,31 @@ argument-hint: "on | off | status | config"
 2. 직접 입력은 쉼표나 공백으로 나눔
 3. 낱말마다 `^\.?[A-Za-z0-9]+$` 를 만족해야 함. 아니면 그 값을 보이고 다시 물음
 4. 금지와 대체에 같은 확장자가 있으면 다시 물음
-5. 셸에는 정규화한 확장자만 넘김
+5. 정규화한 확장자만 넘김
    - 소문자로 바꿈
    - 앞에 점이 없으면 붙임
-   - 쉼표로 이어 큰따옴표로 감쌈. 예: `--deny ".txt,.pdf"`
+   - 쉼표로 이어 "설정 넘기기" 의 `deny=`, `alt=` 줄에 씀
 6. 스크립트가 거부하면 그 메시지를 전하고 다시 물음
 
+### 설정 넘기기
+
+- 설정 값은 명령줄 인자가 아니라 표준 입력으로 넘김. 따옴표 친 heredoc 안의 글은 셸이 해석하지 않음
+
+  ```bash
+  node "<이 스킬 디렉터리 절대경로>/scripts/anti-drm.mjs" config --stdin <<'ANTI_DRM_SETTINGS'
+  deny=.txt,.pdf
+  alt=.md,.html,.tsv
+  tsv=tab
+  ANTI_DRM_SETTINGS
+  ```
+
+- `on` 은 `config` 자리에 `on --runtime <런타임>` 을 씀
+- PowerShell 은 `@'` 와 `'@` 사이에 같은 세 줄을 두고 `| node "<경로>/scripts/anti-drm.mjs" config --stdin` 으로 넘김
+- 넘기기 전에 heredoc 안의 줄마다 `^(deny|alt|tsv)=[a-z0-9., ]*$` 에 맞는지 확인. 하나라도 맞지 않으면 실행하지 않고 "질문" 으로 돌아감
+  - "답 처리" 의 단어 검사와 겹치는 두 번째 방벽. 끝 표시(`ANTI_DRM_SETTINGS`, PowerShell 의 `'@`)는 이 꼴에 맞을 수 없어 값이 heredoc 을 일찍 닫지 못함
+- 줄은 `deny=`, `alt=`, `tsv=` 를 하나씩. `tsv=` 는 대체 확장자에 `.tsv` 가 있을 때만 씀
+- `--stdin` 은 입력이 끝날 때까지 기다림. 늘 heredoc 이나 파이프로 넘김
+
 ## 종료 코드
 
 | 코드 | 뜻 | 처리 |
@@ -194,9 +213,10 @@ argument-hint: "on | off | status | config"
   - `off` 는 지우지 않음
   - `.md` 와 `.json` 은 금지할 수 없음. 규칙 파일과 설정 파일의 형식
   - 목록은 각각 64개까지
-  - 읽는 파일: 64KiB 이하의 일반 파일만. 소유자는 이 계정, 또는 root 만 쓸 수 있는 root
-  - 폴더, FIFO, 64KiB 를 넘는 파일, 읽을 수 없는 파일은 덮어쓰지 않음
-  - anti-drm 이 쓰지 않은 파일이 그 자리에 있으면 `anti-drm.json.bak` 에 한 번 남김 (이 계정만 읽기 가능)
+  - 읽는 파일: 64KiB 이하의 일반 파일만(링크면 가리키는 파일을 읽음). 소유자는 이 계정, 또는 root 만 쓸 수 있는 root
+  - 폴더, FIFO, 64KiB 를 넘는 파일, 읽을 수 없는 파일은 덮어쓰지 않음(링크와 하드 링크는 다음 줄)
+  - 저장할 때 링크와 하드 링크(이름이 둘 이상인 일반 파일)는 그 이름만 새 파일로 바꿈. 가리키던 파일은 읽지 않고 그대로 둠
+  - anti-drm 이 쓰지 않은 파일이 그 자리에 있으면 `anti-drm.json.bak` 에 한 번 남김 (이 계정만 읽기 가능). 링크와 하드 링크는 남기지 않음
 - 설정 폴더
   - Claude Code: `$CLAUDE_CONFIG_DIR`, 없으면 `~/.claude`
   - Codex: `$CODEX_HOME`, 없으면 `~/.codex`
@@ -206,7 +226,7 @@ argument-hint: "on | off | status | config"
 - Codex 블록은 `USER:OMX:POLICY` 표시로 감쌈
   - 블록이 남음: `omx setup --merge-agents`, 기본 `omx setup`(team 모드 켜짐)
   - 블록이 사라짐: `omx setup --force`, 덮어쓰기 확인, team 모드를 끈 `omx setup`. 그 뒤 `on` 다시 실행
-- Codex 파일 변경 전 내용: `<파일>.anti-drm.bak` (이 계정만 읽기 가능)
+- Codex 파일 변경 전 내용: `<파일>.anti-drm.bak` (이 계정만 읽기 가능). `off` 결과에 그 경로를 알림
 - `tone-compact` 블록과 같은 파일에 있어도 서로 건드리지 않음
 - `on`, `off` 는 그 런타임만 바꿈
 - 설정 값을 준 `on` 과 `config` 는 규칙이 들어 있는 다른 런타임도 새 규칙으로 바꿈
@@ -214,17 +234,28 @@ argument-hint: "on | off | status | config"
 
 ## 문제 해결
 
+- 아래 표에서 파일을 보인다는 것은 `ls -l` 로 그 이름의 종류와 링크 대상 경로를 보이는 것이다. 링크가 아닌 일반 파일임을 본 뒤에만 내용을 연다. 심어 둔 링크가 가리키는 파일(키 등)이 세션에 오르지 않게 한다.
+- `.bak` 파일(`anti-drm.json.bak`, `<파일>.anti-drm.bak`)은 내용을 열지 않고 경로만 알린다. 링크가 가리키던 파일(키 등)의 사본일 수 있다. 0.19.0 까지는 설정 파일 자리의 링크도 그 대상을 남겼다.
+
 | 메시지 | 조치 |
 |---|---|
 | 설정이 없습니다 | "질문" 으로 설정을 정해 `on` 에 넘김 |
-| 설정 파일이 올바르지 않습니다 | `config` 로 다시 만듦. 다른 사용자 소유면 그 파일을 치운 뒤 실행 |
-| 일반 파일이 아니라 설정을 저장하지 않았습니다 | 설정 경로의 폴더나 특수 파일을 치움. 또는 `BANKER_ANTI_DRM_CONFIG` 값 확인 |
-| 64KiB 보다 큰 파일이라, 읽을 수 없는 파일이라 설정을 저장하지 않았습니다 | 그 자리의 파일이 설정 파일인지 확인. 권한을 고치거나 옮긴 뒤 다시 실행 |
+| 표준 입력에 설정 줄이 없습니다 | heredoc 이 비었음. "설정 넘기기" 대로 줄을 넣어 다시 실행 |
+| 표준 입력이 64KiB 보다 큽니다 | "답 처리" 대로 정규화한 값만 넘김 |
+| 설정 파일이 올바르지 않습니다 | 이유를 전하고 설정을 다시 정할지 물은 뒤 진행. 정하면 "질문" 뒤 켜는 중이면 `on --runtime <런타임> --stdin`, 설정만 바꿀 때는 `config --stdin` 실행. 그 파일은 새 파일로 바뀌고(그 자리가 폴더나 특수 파일이거나, 64KiB 보다 크거나, 읽을 수 없는 파일이면 바꾸지 않고 거부함. 링크와 하드 링크(이름이 둘 이상인 일반 파일)는 거부하지 않고 그 이름만 일반 파일로 바꾸며, 가리키던 파일은 그대로 두고 `.bak` 에 남기지 않음), anti-drm 형식이 아니면 `anti-drm.json.bak` 에 한 번 남음(먼저 남긴 파일이나 일반 파일이 아닌 것이 그 자리에 있으면 남기지 않고 결과에 알림). 에이전트가 그 파일을 직접 지우거나 옮기지 않음 |
+| 일반 파일이 아니라 설정을 저장하지 않았습니다 | 설정 경로의 폴더나 특수 파일은 지우지 않음. 무엇인지 보이고, 옮길지 다른 경로(`BANKER_ANTI_DRM_CONFIG`)를 쓸지 물은 뒤 다시 실행 |
+| 64KiB 보다 큰 파일이라, 읽을 수 없는 파일이라 설정을 저장하지 않았습니다 | 그 파일이 무엇인지 보이고, 권한을 고칠지 옮길지 물은 뒤 다시 실행 |
+| 확인하는 사이에 바뀐 자리라 설정을 저장하지 않았습니다 | 설정 파일을 연 사이에 다른 프로그램이 그 자리를 바꿈(Windows, 링크일 수 있음). 지우거나 바꾸지 않음. 무엇인지 보이고(링크면 `ls -l` 로 링크와 대상 경로만 보이고 대상 내용은 열지 않음) 어떻게 할지 물은 뒤 다시 실행 |
 | anti-drm 이 쓰는 형식이라 금지할 수 없습니다 | 금지 목록에서 `.md`, `.json` 을 뺌 |
-| 같은 이름의 다른 파일이 있음 | `rules/banker-anti-drm.md` 가 banker 파일이 아님. 이름 변경 또는 삭제 뒤 다시 실행 |
-| 표시의 짝이 맞지 않음 | 지침 파일에 anti-drm 표시 줄이 한쪽만 있거나 문장 속에 있음. 또는 블록 안에 다른 표시 줄이 있음. 짝을 새로 맞추지 말고 남은 표시 줄을 지운 뒤 다시 실행 |
+| 같은 이름의 다른 파일이 있음 | `rules/banker-anti-drm.md` 가 banker 파일이 아님. 지우거나 이름을 바꾸지 않음. 내용을 보이고(링크면 `ls -l` 로 링크와 대상 경로만 보이고 대상 내용은 열지 않음) 어떻게 할지 물은 뒤 다시 실행 |
+| 표시의 짝이 맞지 않음 | 지침 파일에 anti-drm 표시 줄이 한쪽만 있거나 문장 속에 있음. 또는 블록 안에 다른 표시 줄이 있음. 짝을 새로 맞추지 않음. 남은 표시 줄을 보이고 지울지 물은 뒤 다시 실행 |
 | 다른 banker 블록만 있어 Codex 가 AGENTS.md 를 읽지 않음 | 메시지가 말한 스킬에서 `on` 실행 |
 | 설정 폴더가 없음 | 해당 런타임 미설치. 또는 설정 폴더 환경 변수 값 확인 |
 | 규칙이 지금 설정이나 이 버전과 다름 | `on` 한 번 실행 |
-| UTF-8 이 아닌 파일 | 지침 파일을 UTF-8 로 바꾼 뒤 다시 실행 |
+| UTF-8 이 아닌 파일 | 지침 파일을 바꾸지 않음. 인코딩을 보이고, 백업을 만든 뒤 UTF-8 로 바꿀지 물은 뒤 다시 실행 |
+| 끊어진 링크라 그대로 두었습니다 | AGENTS.md 가 가리키는 파일이 없음. 링크를 지우거나 바꾸지 않음. 링크와 대상을 보이고 어떻게 할지 물은 뒤 다시 실행 |
+| AGENTS.md 가 끊어진 링크라 on 이 블록을 옮기지 못함 | AGENTS.override.md 에 블록만 남았고 AGENTS.md 가 가리키는 파일이 없음. 링크를 지우거나 바꾸지 않음. 링크와 대상을 보이고 어떻게 할지 물은 뒤 `on` 실행 |
+| 쓰는 사이에 같은 이름이 생겨 그대로 두었습니다 | 다른 프로그램이 그 사이에 같은 이름을 만들었음(링크일 수 있음). 지우거나 바꾸지 않음. 무엇인지 보이고(링크면 `ls -l` 로 링크와 대상 경로만 보이고 대상 내용은 열지 않음) 어떻게 할지 물은 뒤 다시 실행 |
+| 일반 파일이 아님 | 지침 파일 자리(AGENTS.md, AGENTS.override.md)의 폴더나 특수 파일은 지우지 않음. 무엇인지 사용자에게 보이고, 옮기거나 이름을 바꿀지 물은 뒤 다시 실행 |
+| 다른 banker 지침 작업이 끝나지 않아 그대로 두었습니다 | 다른 banker 스킬의 `on`, `off` 가 도는 중. 잠시 뒤 다시 실행. 끝나지 않은 작업이 남긴 잠금은 1분 뒤 저절로 넘어감. 1분이 지나도 같거나 잠금 자리가 폴더면 잠금 경로를 보이고 어떻게 할지 물은 뒤 다시 실행. 잠금을 임의로 지우지 않음 |
 | 쓸 권한이 없음 | 해당 파일과 폴더 권한 확인 |