@kaydash9999/banker-plugins 0.19.3 → 0.19.4

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.19.3"
+    "version": "0.19.4"
   },
   "plugins": [
     {

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "banker",
-  "version": "0.19.3",
+  "version": "0.19.4",
   "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,15 @@
 # Changelog
 
+## [0.19.4] - 2026-10-17
+
+### Changed
+- 유지보수자용: 체크인 훅 시험이 `last-flush` 임시 이름의 링크, 폴더나 FIFO 인 차지 이름을 덮는다.
+
+### Fixed
+- 업데이트 확인 캐시(`update-check.json`), 써 본 스킬 집합(`used-skills.json`), 체크인의 `last-flush` 는 이름을 미리 알 수 없는 새 임시 파일에 써서 옮긴다. 예전에는 캐시와 집합을 `<이름>.<pid>.tmp` 에 그냥 써서, 그 이름에 놓인 링크를 따라 다른 파일을 덮었다. `last-flush` 는 0.19.3 부터 그 이름에 무엇이 있으면 만들지 않았으나, Windows 는 끊어진 링크면 그 너머에 새 파일을 만들었다. 캐시와 집합 자리가 FIFO 여도 읽으며 기다리지 않는다.
+- 사용량 기록 훅(`/banker:*` 입력, 모델의 Skill 호출): 사용 기록 자리가 FIFO 면 기다리지 않고, 링크면 그 너머에 쓰지 않으며, 끊어진 링크로 새 파일을 만들지 않는다. 같은 파일에 다른 이름이 있으면(하드 링크) 쓰지 않는다. 예전에는 FIFO 에서 훅 제한(5초)까지 멈췄고, 링크가 가리키는 파일 끝에 기록 줄을 더했다. 링크인 기록 자리는 다음 체크인이 링크를 옮겨 지운 뒤 일반 파일로 다시 쌓인다. Windows 는 링크를 따르지 않고 여는 방법이 없어 열기 전에 본다.
+- 설정(`config.json`)과 업데이트 확인 캐시를 읽는 훅과 `banker telemetry status` 는 그 자리가 FIFO 여도 기다리지 않는다. 예전에는 세션 시작 알림과 사용량 기록 훅은 훅 제한(5초)까지 멈췄고, 백그라운드 갱신 확인과 `banker telemetry status` 는 끝나지 않았다.
+
 ## [0.19.3] - 2026-10-17
 
 ### Fixed

package/bin/banker.js

@@ -342,7 +342,7 @@ async function telemetryCmd(sub) {
     log('  참고: 엔드포인트가 설정되어 있고 opt-out 이 아닐 때(env·config 둘 다 아님)만 실제로 전송됩니다.');
 
     let cache = {};
-    try { cache = JSON.parse(fs.readFileSync(tc.UPDATE_CHECK_PATH, 'utf8')); } catch { /* 캐시 없음/malformed */ }
+    try { cache = JSON.parse(tc.readRegular(tc.UPDATE_CHECK_PATH)); } catch { /* 캐시 없음/malformed/일반 파일 아님(FIFO 를 기다리지 않음) */ }
     const installed = tc.installedVersion();
     const cmp = (cache.latest && installed) ? tc.compareVersions(cache.latest, installed) : null;
     log('[업데이트 체크] 새 버전 알림 (기본값: 켜짐)');

package/bin/lib/telemetry-config.mjs

@@ -1,9 +1,10 @@
 /*
  * telemetry-config - banker 텔레메트리 config/consent 공용 모듈 (bin·hook 공유).
- * 의존성 0 (Node 내장 모듈만: node:fs, node:path, node:os). ESM(.mjs).
+ * 의존성 0 (Node 내장 모듈만: node:fs, node:path, node:os, node:crypto). ESM(.mjs).
  * import 시 부작용 없음: 경로는 resolver 로 호출 시 계산하고, 파일시스템 접근·mkdir 은
  * 각 함수 호출 시에만 일어난다. readConfig/isEnabled/endpoint 는 어떤 예외도 밖으로 던지지 않는다.
  */
+import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
@@ -73,10 +74,95 @@ export function collectBody(res, maxBytes, done) {
   res.on('error', () => done(null));
 }
 
-// config.json 을 읽어 객체로 반환. 파일 없음·malformed JSON·권한 오류 등 어떤 예외에도 던지지 않고 {} 반환.
+// 일반 파일의 글. 그 밖(FIFO, 폴더)과 오류는 ''. 막지 않고 열어 FIFO 를 기다리지 않는다.
+export function readRegular(file) {
+  let fd;
+  try {
+    fd = fs.openSync(file, fs.constants.O_RDONLY | (fs.constants.O_NONBLOCK ?? 0));
+    return fs.fstatSync(fd).isFile() ? fs.readFileSync(fd, 'utf8') : '';
+  } catch {
+    return '';
+  } finally {
+    if (fd !== undefined) try { fs.closeSync(fd); } catch { /* best-effort */ }
+  }
+}
+
+// target 자리에 data 를 놓는다. 새 임시 파일을 만들어(wx: 그 이름에 무엇이 있으면 만들지 않음) 쓰고 rename 으로
+// 옮겨, 임시 이름이나 target 자리의 링크를 따라 다른 파일을 덮지 않는다. 임시 이름에 난수를 붙이는 것은 Windows 의
+// wx 가 끊어진 링크를 따라가 그 너머에 새 파일을 만들기 때문이다: 이름을 미리 알 수 없어야 링크를 심어 둘 수 없다.
+// 실패하면 던진다. 지우는 것은 이 호출이 만든 임시 파일뿐이고, 그 이름에 이미 있던 것은 둔다.
+export function writeByRename(target, data) {
+  const tmp = `${target}.${process.pid}.${crypto.randomBytes(4).toString('hex')}.tmp`;
+  let made = false;
+  try {
+    const fd = fs.openSync(tmp, 'wx');
+    made = true;
+    try {
+      fs.writeFileSync(fd, data);
+    } finally {
+      fs.closeSync(fd);
+    }
+    fs.renameSync(tmp, target);
+  } catch (e) {
+    if (made) try { fs.unlinkSync(tmp); } catch { /* best-effort */ }
+    throw e;
+  }
+}
+
+// 사용 기록을 덧붙이기로 여는 깃발. 같은 fd 로 줄 수도 센다. 링크를 따르지 않고(O_NOFOLLOW) FIFO 를 기다리지
+// 않는다(O_NONBLOCK). Windows 에는 둘 다 없어 열기 전에 자리를 보고 링크면 두며, 그 뒤에 바뀌어 든 링크는 거기서
+// 따라간다(obsidize 훅과 같은 한계. Windows 는 wx 도 끊어진 링크를 따라가 원자적으로 막을 수단이 없다).
+const NO_FOLLOW = fs.constants.O_NOFOLLOW ?? 0;
+const APPEND_FLAGS = fs.constants.O_RDWR | fs.constants.O_APPEND | fs.constants.O_CREAT | NO_FOLLOW
+  | (fs.constants.O_NONBLOCK ?? 0);
+
+function isLink(file) {
+  try { return fs.lstatSync(file).isSymbolicLink(); } catch { return false; }
+}
+
+// 사용 기록을 덧붙이기로 연 fd. 일반 파일이고 이름이 하나(nlink 1)일 때만 돌려주고, 그 밖(링크, 하드 링크, FIFO,
+// 폴더)은 연 것을 닫고 null. 없으면 새로 만든다. 열기 자체의 오류는 던진다.
+function openLogForAppend(file) {
+  if (!NO_FOLLOW && isLink(file)) return null;
+  const fd = fs.openSync(file, APPEND_FLAGS);
+  let ok = false;
+  try {
+    const st = fs.fstatSync(fd);
+    ok = st.isFile() && st.nlink <= 1;
+  } finally {
+    if (!ok) fs.closeSync(fd);
+  }
+  return ok ? fd : null;
+}
+
+// 사용 기록(usage-log)에 `<name>\t<hour>` 한 줄을 더한다(hour = 로컬 시각 0-23, name 은 SKILL_NAME_RE 꼴만).
+// 줄이 LOG_MAX_LINES 에 이르렀으면 더하지 않는다(best-effort, 체크인이 비우면 다시 쌓인다). 기록 자리가 FIFO 면
+// 기다리지 않고, 링크나 하드 링크면 그 너머 파일에 쓰지 않으며, 끊어진 링크로 새 파일을 만들지 않는다(링크인 자리는
+// 다음 체크인이 링크를 옮겨 지운다). configDir() 를 매 호출 재계산한다(테스트 격리). 더했으면 true, 그 밖과 모든
+// 오류는 false.
+export function appendUsageLog(name) {
+  if (typeof name !== 'string' || !SKILL_NAME_RE.test(name)) return false;
+  let fd = null;
+  try {
+    fs.mkdirSync(configDir(), { recursive: true });
+    fd = openLogForAppend(path.join(configDir(), 'usage-log'));
+    if (fd === null) return false;
+    const lines = (fs.readFileSync(fd, 'utf8').match(/\n/g) || []).length;
+    if (lines >= LOG_MAX_LINES) return false;
+    fs.writeSync(fd, `${name}\t${new Date().getHours()}\n`);
+    return true;
+  } catch {
+    return false;
+  } finally {
+    if (fd !== null) try { fs.closeSync(fd); } catch { /* best-effort */ }
+  }
+}
+
+// config.json 을 읽어 객체로 반환. 파일 없음·malformed JSON·권한 오류·일반 파일 아님(FIFO 를 기다리지 않음) 등
+// 어떤 예외에도 던지지 않고 {} 반환.
 export function readConfig() {
   try {
-    const raw = fs.readFileSync(path.join(configDir(), 'config.json'), 'utf8');
+    const raw = readRegular(path.join(configDir(), 'config.json'));
     const obj = JSON.parse(raw);
     return (obj && typeof obj === 'object' && !Array.isArray(obj)) ? obj : {};
   } catch {
@@ -209,9 +295,9 @@ export function compareVersions(a, b) {
 }
 
 // update-check 캐시를 read-modify-write 로 병합 기록한다: 기존 JSON 을 읽어({} on 실패) patch 의
-// 필드만 덮고 나머지 형제 필드는 보존한 뒤, configDir() mkdir -p → temp 파일 쓰기 → rename(원자적)
-// 으로 기록한다. 테스트 격리를 위해 경로는 configDir() 로 매 호출 재계산한다(UPDATE_CHECK_PATH 상수
-// 비의존). 모든 오류를 삼켜 best-effort: 성공 true, 실패 false.
+// 필드만 덮고 나머지 형제 필드는 보존한 뒤, configDir() mkdir -p → writeByRename(새 임시 파일, rename)
+// 으로 기록한다. 캐시 자리가 FIFO 여도 읽으며 기다리지 않는다. 테스트 격리를 위해 경로는 configDir() 로 매 호출
+// 재계산한다(UPDATE_CHECK_PATH 상수 비의존). 모든 오류를 삼켜 best-effort: 성공 true, 실패 false.
 export function writeUpdateCache(patch) {
   try {
     const dir = configDir();
@@ -219,13 +305,11 @@ export function writeUpdateCache(patch) {
     const cachePath = path.join(dir, 'update-check.json');
     let existing = {};
     try {
-      const obj = JSON.parse(fs.readFileSync(cachePath, 'utf8'));
+      const obj = JSON.parse(readRegular(cachePath));
       if (obj && typeof obj === 'object' && !Array.isArray(obj)) existing = obj;
-    } catch { /* 없음·malformed → {} */ }
+    } 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);
+    writeByRename(cachePath, JSON.stringify(merged, null, 2));
     return true;
   } catch {
     return false;
@@ -236,10 +320,11 @@ export function writeUpdateCache(patch) {
 // 이 집합은 절대 서버로 보내지 않는다: update-checkin 페이로드는 usage-log 집계(counts)만 담는다.
 // update-notify 가 로컬에서 읽어, 새 버전에서 바뀐 스킬 중 "사용자가 써 본 것"만 골라 알림에 이름을 넣는다.
 
-// 로컬 "써 본 스킬" 배열을 반환. 없음·malformed·비배열 → []. 문자열 원소만 남긴다. 어떤 오류에도 [].
+// 로컬 "써 본 스킬" 배열을 반환. 없음·malformed·비배열·일반 파일 아님(FIFO 를 기다리지 않음) → [].
+// 문자열 원소만 남긴다. 어떤 오류에도 [].
 export function readUsedSkills() {
   try {
-    const arr = JSON.parse(fs.readFileSync(path.join(configDir(), 'used-skills.json'), 'utf8'));
+    const arr = JSON.parse(readRegular(path.join(configDir(), 'used-skills.json')));
     return Array.isArray(arr) ? arr.filter((x) => typeof x === 'string' && x) : [];
   } catch {
     return [];
@@ -248,7 +333,7 @@ export function readUsedSkills() {
 
 // name 을 로컬 집합에 union 한다(개인화 알림용, 전송 안 함). 이미 있으면 파일을 쓰지 않는다(핫패스 절약).
 // 상한(USED_SKILLS_MAX) 도달 시 새 이름은 무시한다(오래된 것 보존; 개인화는 근사여도 무방). configDir() 를
-// 매 호출 재계산(테스트 격리) + temp→rename 원자적 기록. 모든 오류를 삼켜 신규 기록 시 true, 그 외 false.
+// 매 호출 재계산(테스트 격리) + writeByRename 으로 기록. 모든 오류를 삼켜 신규 기록 시 true, 그 외 false.
 export function recordUsedSkill(name) {
   try {
     if (typeof name !== 'string' || !name) return false;
@@ -258,10 +343,7 @@ export function recordUsedSkill(name) {
     set.push(name);
     const dir = configDir();
     fs.mkdirSync(dir, { recursive: true });
-    const target = path.join(dir, 'used-skills.json');
-    const tmp = path.join(dir, `used-skills.json.${process.pid}.tmp`);
-    fs.writeFileSync(tmp, JSON.stringify(set));
-    fs.renameSync(tmp, target);
+    writeByRename(path.join(dir, 'used-skills.json'), JSON.stringify(set));
     return true;
   } catch {
     return false;

package/hooks/telemetry-count-skill.mjs

@@ -5,6 +5,8 @@
  *
  * fail-closed 규약(각 항목은 telemetry-count-skill.test.mjs 가 검증한다):
  *  - countingActive() 가 아니면 로컬 쓰기조차 하지 않는다. 파일도 만들지 않는다.
+ *  - 기록 자리가 FIFO 면 기다리지 않고, 링크면 그 너머에 쓰지 않는다(Windows 는 열기 전에 본다). 하드 링크에 쓰지
+ *    않는 것은 공용 appendUsageLog 의 시험(bin/lib/telemetry-config.test.mjs)이 검증한다.
  *  - 어떤 오류도 삼키고 항상 exit 0. 세션/툴호출을 절대 막지 않는다.
  *  - PII/식별자를 다루지 않는다. 로그 한 줄 = 이름 문자열 + TAB + hour(0-23) 뿐이다.
  *
@@ -20,9 +22,7 @@
  *
  * 배선: hooks.json 의 PostToolUse(matcher Skill)에 등록되어 모델 자동 스킬 호출 시 발화한다.
  */
-import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
-
-import { configDir, countingActive, recordUsedSkill, USAGE_LOG_PATH, LOG_MAX_LINES, SKILL_NAME_RE } from '../bin/lib/telemetry-config.mjs';
+import { appendUsageLog, countingActive, recordUsedSkill, SKILL_NAME_RE } from '../bin/lib/telemetry-config.mjs';
 
 function readStdin() {
   return new Promise((resolvePromise, rejectPromise) => {
@@ -46,29 +46,6 @@ function extractName(payload) {
   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 {
@@ -85,7 +62,7 @@ async function main() {
   if (!countingActive()) return; // 카운팅 비활성 - 로컬 쓰기조차 하지 않는다.
   const name = extractName(payload);
   if (!name) return; // banker:<name> 아님 - 무동작.
-  record(name);            // 서버 카운팅용 usage-log append (스킬별 x 시간대 버킷).
+  appendUsageLog(name);    // 서버 카운팅용 usage-log 한 줄 (스킬별 x 시간대 버킷). 상한이면 건너뛴다.
   recordUsedSkill(name);   // 개인화 알림용 로컬 집합 union (전송 안 함; update-notify 만 로컬에서 읽는다).
 }
 

package/hooks/telemetry-count.mjs

@@ -5,6 +5,8 @@
  *
  * fail-closed 규약(각 항목은 telemetry-count.test.mjs 가 검증한다):
  *  - countingActive() 가 아니면 로컬 쓰기조차 하지 않는다. 파일도 만들지 않는다.
+ *  - 기록 자리가 FIFO 면 기다리지 않고, 링크면 그 너머에 쓰지 않는다(Windows 는 열기 전에 본다). 하드 링크에 쓰지
+ *    않는 것은 공용 appendUsageLog 의 시험(bin/lib/telemetry-config.test.mjs)이 검증한다.
  *  - 어떤 오류도 삼키고 항상 exit 0. 세션/프롬프트를 절대 막지 않는다.
  *  - PII/식별자를 다루지 않는다. 로그 한 줄 = 이름 문자열 + TAB + hour(0-23) 뿐이다.
  *
@@ -20,9 +22,7 @@
  *
  * 배선: hooks.json 의 UserPromptExpansion(matcher banker:.*)에 등록되어 사용자 직접 /banker:* 호출 시 발화한다.
  */
-import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
-
-import { configDir, countingActive, recordUsedSkill, USAGE_LOG_PATH, LOG_MAX_LINES, SKILL_NAME_RE } from '../bin/lib/telemetry-config.mjs';
+import { appendUsageLog, countingActive, recordUsedSkill, SKILL_NAME_RE } from '../bin/lib/telemetry-config.mjs';
 
 function readStdin() {
   return new Promise((resolvePromise, rejectPromise) => {
@@ -44,29 +44,6 @@ function extractName(payload) {
   return (typeof name === 'string' && SKILL_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 {
@@ -83,7 +60,7 @@ async function main() {
   if (!countingActive()) return; // 카운팅 비활성 - 로컬 쓰기조차 하지 않는다.
   const name = extractName(payload);
   if (!name) return; // banker:<name> 아님 - 무동작.
-  record(name);            // 서버 카운팅용 usage-log append (스킬별 x 시간대 버킷).
+  appendUsageLog(name);    // 서버 카운팅용 usage-log 한 줄 (스킬별 x 시간대 버킷). 상한이면 건너뛴다.
   recordUsedSkill(name);   // 개인화 알림용 로컬 집합 union (전송 안 함; update-notify 만 로컬에서 읽는다).
 }
 

package/hooks/update-checkin.mjs

@@ -17,9 +17,7 @@
  * count-default-on: 이 훅은 hooks.json 에 배선되지 않는다(스탠드얼론 .mjs). update-notify 가
  * countingActive + 엔드포인트 설정 시 fetcher 로 detached spawn 한다(응답 latest 가 알림 캐시를 겸함).
  */
-import {
-  closeSync, constants, fstatSync, lstatSync, openSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync,
-} from 'node:fs';
+import { lstatSync, readdirSync, renameSync, unlinkSync } from 'node:fs';
 import { randomBytes } from 'node:crypto';
 import http from 'node:http';
 import https from 'node:https';
@@ -37,6 +35,8 @@ import {
   SKILL_NAME_RE,
   collectBody,
   netDeadlineMs,
+  readRegular,
+  writeByRename,
 } from '../bin/lib/telemetry-config.mjs';
 
 const NET_TIMEOUT_MS = 10_000;
@@ -182,19 +182,6 @@ const RENAME_TRIES = 3;
 const RENAME_REST_MS = 50;
 const SLEEP = new Int32Array(new SharedArrayBuffer(4));
 
-// 일반 파일의 글. 그 밖(FIFO, 폴더)과 오류는 ''. 막지 않고 열어 FIFO 를 기다리지 않는다.
-function readRegular(path) {
-  let fd;
-  try {
-    fd = openSync(path, constants.O_RDONLY | (constants.O_NONBLOCK ?? 0));
-    return fstatSync(fd).isFile() ? readFileSync(fd, 'utf8') : '';
-  } catch {
-    return '';
-  } finally {
-    if (fd !== undefined) try { closeSync(fd); } catch { /* best-effort */ }
-  }
-}
-
 // 보내기 전에 로그 이름을 바꿔 차지한다. rename 은 원자적이라 함께 시작한 체크인 가운데 하나만 그 줄을 읽고,
 // 보내는 동안 더해진 줄은 새 로그로 가 다음 체크인이 보낸다. 링크면 링크 자체가 옮겨진다(대상은 그대로).
 // 로그가 없거나 폴더, FIFO 이거나 이름을 바꾸지 못하면(다른 체크인이 먼저 차지, Windows 에서 백신이 쥠)
@@ -257,16 +244,10 @@ async function refreshUpdateCache(responseBody) {
 }
 
 // 전송 시도 후(성공/실패 무관) 차지한 파일을 지워 24h 윈도우로 상한(배치 유실 허용)하고 last-flush 를 남긴다.
-// last-flush 는 새 파일에 쓴 뒤 rename 으로 놓아, 그 이름 자리의 링크를 따라 다른 파일을 덮지 않는다.
+// last-flush 는 writeByRename 으로 놓아, 그 이름 자리나 임시 이름의 링크를 따라 다른 파일을 덮지 않는다.
 function finishClaim(claim) {
   if (claim) try { unlinkSync(claim); } catch { /* best-effort */ }
-  const tmp = `${LAST_FLUSH_PATH}.${process.pid}.tmp`;
-  try {
-    writeFileSync(tmp, new Date().toISOString(), { flag: 'wx' });
-    renameSync(tmp, LAST_FLUSH_PATH);
-  } catch {
-    try { unlinkSync(tmp); } catch { /* best-effort */ }
-  }
+  try { writeByRename(LAST_FLUSH_PATH, new Date().toISOString()); } catch { /* best-effort */ }
 }
 
 async function main() {

package/hooks/update-fetch.mjs

@@ -15,11 +15,12 @@
  *
  * 이 훅은 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, collectBody, netDeadlineMs } from '../bin/lib/telemetry-config.mjs';
+import {
+  UPDATE_CHECK_PATH, UPDATE_THROTTLE_MS, NPM_LATEST_URL, writeUpdateCache, collectBody, netDeadlineMs, readRegular,
+} from '../bin/lib/telemetry-config.mjs';
 
 const NET_TIMEOUT_MS = 10_000;
 const NET_DEADLINE_MS = netDeadlineMs(); // 교환 전체 마감(위 값은 무활동 기준).
@@ -32,10 +33,11 @@ function isLoopback(hostname) {
   return h === 'localhost' || h === '127.0.0.1' || h === '::1';
 }
 
-// update-check 캐시를 읽어 객체로 반환. 없음·malformed·권한 오류 등 어떤 예외에도 던지지 않고 {} 반환.
+// update-check 캐시를 읽어 객체로 반환. 없음·malformed·권한 오류·일반 파일 아님(FIFO 를 기다리지 않음) 등 어떤
+// 예외에도 던지지 않고 {} 반환.
 function readCache() {
   try {
-    const obj = JSON.parse(readFileSync(UPDATE_CHECK_PATH, 'utf8'));
+    const obj = JSON.parse(readRegular(UPDATE_CHECK_PATH));
     return (obj && typeof obj === 'object' && !Array.isArray(obj)) ? obj : {};
   } catch {
     return {};

package/hooks/update-notify.mjs

@@ -14,14 +14,14 @@
  *  - 어떤 오류도 삼키고 항상 exit 0. 세션을 절대 막지 않는다. 비TTY 안전.
  */
 import { spawn } from 'node:child_process';
-import { readFileSync, realpathSync } from 'node:fs';
+import { 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, readUsedSkills,
+  installedVersion, compareVersions, writeUpdateCache, readUsedSkills, readRegular,
 } from '../bin/lib/telemetry-config.mjs';
 
 const HERE = dirname(fileURLToPath(import.meta.url));
@@ -38,10 +38,11 @@ function readStdin() {
   });
 }
 
-// 캐시({latest,checkedAt,notified})를 객체로 반환. 없음·malformed·배열 → null(무고지·throttle 경과 취급).
+// 캐시({latest,checkedAt,notified})를 객체로 반환. 없음·malformed·배열·일반 파일 아님(FIFO 를 기다리지 않음) → null
+// (무고지·throttle 경과 취급).
 function readCache() {
   try {
-    const obj = JSON.parse(readFileSync(UPDATE_CHECK_PATH, 'utf8'));
+    const obj = JSON.parse(readRegular(UPDATE_CHECK_PATH));
     return (obj && typeof obj === 'object' && !Array.isArray(obj)) ? obj : null;
   } catch {
     return null;

package/package.json

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