@kaydash9999/banker-plugins 0.13.0 → 0.14.0

package/skills/payload-mon/scripts/payload-size.mjs

@@ -0,0 +1,238 @@
+/**
+ * Estimated API request payload of a Claude Code session, for the HUD.
+ *
+ * Claude Code refuses a request over the API's 32MB limit ("Request too large
+ * (max 32MB)") and measures it as the JSON size of the messages it sends
+ * ("request_body_over_limit: body=…B (messages only)"). This applies the same
+ * measure to the session transcript: everything Claude Code would send since the
+ * last compact boundary (images and tool results included), picked with the same
+ * filter it uses to build a request (see sentPart).
+ *
+ * Known gaps, all small next to the 8MB threshold in the sessions measured:
+ * - the system prompt and tool schemas are not in the transcript, so the real
+ *   request is a few hundred KB larger;
+ * - after a rewind (Esc Esc) the abandoned branch stays counted until the next
+ *   compaction;
+ * - the few messages a compaction keeps verbatim before its boundary are not
+ *   added back (13KB or less in each of the 53 compactions measured);
+ * - tool results Claude Code clears at request time (microcompact, not seen in
+ *   these transcripts) stay counted.
+ *
+ * The transcript only grows, so the scanned offset and running total are cached
+ * per transcript under $TMPDIR/omc-hud-payload-<uid>/ and each render reads only
+ * what was appended since the last one. A first render (or a rewritten
+ * transcript) skims for the last compact boundary and parses only what follows it.
+ *
+ * On Linux $TMPDIR is usually the shared /tmp, where any account can create a
+ * folder first. The uid in the folder name keeps accounts apart, and the cache is
+ * used only while that folder is a real directory this account owns and no other
+ * account can write to; otherwise every render rescans. macOS and Windows already
+ * give each account its own temp folder.
+ *
+ * When a Claude Code update changes the transcript format or the request filter,
+ * fix sentPart and bump CACHE_VERSION, so totals cached under the old rules are
+ * rebuilt.
+ */
+import { createHash } from "node:crypto";
+import {
+  closeSync,
+  fstatSync,
+  lstatSync,
+  mkdirSync,
+  openSync,
+  readFileSync,
+  readSync,
+  renameSync,
+  rmSync,
+  writeFileSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+
+export const REQUEST_LIMIT_BYTES = 32 * 1024 * 1024;
+// Shown from 25% of the limit (8MB) on, as an early warning like ctx.
+export const SHOW_FROM_BYTES = REQUEST_LIMIT_BYTES / 4;
+
+const MB = 1024 * 1024;
+// The transcript is read in pieces of this size (exported for the tests).
+export const CHUNK_BYTES = 8 * MB;
+const NL = 0x0a;
+const BOUNDARY_MARK = Buffer.from('"compact_boundary"');
+// This account's uid, or null where there is none (Windows).
+const UID = typeof process.getuid === "function" ? process.getuid() : null;
+// Per-transcript estimate cache, one folder per account; payload-mon off deletes it
+// when this account controls the folder (clearCache).
+export const CACHE_DIR = join(tmpdir(), UID === null ? "omc-hud-payload" : `omc-hud-payload-${UID}`);
+// Bump whenever sentPart changes, so cached totals from older rules are rebuilt.
+const CACHE_VERSION = 2;
+// The model Claude Code stamps on the API-error rows it shows but never sends.
+const SYNTHETIC_MODEL = "<synthetic>";
+
+const parseLine = (text) => {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null; // torn or foreign line: nothing to count
+  }
+};
+
+const isBoundary = (e) => e?.type === "system" && e.subtype === "compact_boundary";
+
+// Rows Claude Code drops from a request: virtual rows and API-error stand-ins.
+const isDropped = (e) => e.isVirtual === true || (e.isApiErrorMessage === true && e.message?.model === SYNTHETIC_MODEL);
+
+// An attachment sends its rendered text (system reminders, CLAUDE.md, file
+// mentions). An image @-mention is stored without one, since Claude Code renders
+// it again for each request, so its base64 stands in. A PDF mention sends only a
+// short note, and hook results and snapshots send nothing.
+function attachmentPart(e) {
+  if (e.rendered !== undefined) return e.rendered;
+  const { type, content } = e.attachment ?? {};
+  return type === "file" && content?.type === "image" ? content.file?.base64 : undefined;
+}
+
+// The part of an entry that goes into the request, mirroring Claude Code's own
+// filter: user/assistant content (the compact summary included), local command
+// output and attachments. Sidechains are subagents' own loops.
+function sentPart(e) {
+  if (!e || e.isSidechain) return undefined;
+  if (e.type === "user" || e.type === "assistant") return isDropped(e) ? undefined : e.message?.content;
+  if (e.type === "system") return e.subtype === "local_command" ? e.content : undefined;
+  return e.type === "attachment" ? attachmentPart(e) : undefined;
+}
+
+const entryBytes = (e) => {
+  const sent = sentPart(e);
+  return sent == null ? 0 : Buffer.byteLength(JSON.stringify(sent));
+};
+
+// Reads [from, size) in chunks and hands each run of complete lines to
+// onLines(buf, base): buf ends in "\n" and starts at file offset base. A last
+// line still being written is left for the next render. Returns the offset just
+// past the last complete line.
+function readCompleteLines(fd, from, size, onLines) {
+  let pos = from;
+  let base = from;
+  let carry = Buffer.alloc(0);
+  while (pos < size) {
+    const chunk = Buffer.allocUnsafe(Math.min(CHUNK_BYTES, size - pos));
+    const n = readSync(fd, chunk, 0, chunk.length, pos);
+    if (n === 0) break;
+    pos += n;
+    const data = carry.length ? Buffer.concat([carry, chunk.subarray(0, n)]) : chunk.subarray(0, n);
+    const end = data.lastIndexOf(NL) + 1;
+    if (end > 0) onLines(data.subarray(0, end), base);
+    base += end;
+    carry = data.subarray(end);
+  }
+  return base;
+}
+
+// Offset just past the last real compact boundary, 0 when there is none. Only
+// lines holding the marker are parsed, so a 70MB transcript is skimmed in ~0.2s.
+// Exported so the tests can pin where the count starts.
+export function lastBoundaryEnd(fd, size) {
+  let found = 0;
+  readCompleteLines(fd, 0, size, (buf, base) => {
+    for (let k = buf.indexOf(BOUNDARY_MARK); k !== -1; ) {
+      const end = buf.indexOf(NL, k);
+      if (isBoundary(parseLine(buf.toString("utf8", buf.lastIndexOf(NL, k) + 1, end)))) found = base + end + 1;
+      k = buf.indexOf(BOUNDARY_MARK, end);
+    }
+  });
+  return found;
+}
+
+// Running total over the complete lines in [from, size). A compact boundary
+// starts it over: compaction replaces everything sent before it.
+function sumEntries(fd, from, size, bytes) {
+  let total = bytes;
+  const offset = readCompleteLines(fd, from, size, (buf) => {
+    for (let start = 0, end; (end = buf.indexOf(NL, start)) !== -1; start = end + 1) {
+      const e = parseLine(buf.toString("utf8", start, end));
+      total = isBoundary(e) ? 0 : total + entryBytes(e);
+    }
+  });
+  return { offset, bytes: total };
+}
+
+const cacheFile = (dir, transcriptPath) =>
+  join(dir, createHash("sha1").update(transcriptPath).digest("hex").slice(0, 16) + ".json");
+
+// Whether dir is a real folder (not a link) that this account owns and no other
+// account can write to. Windows has no uid and gives each account its own temp.
+function ownedDir(dir) {
+  try {
+    const st = lstatSync(dir);
+    return st.isDirectory() && (UID === null || (st.uid === UID && (st.mode & 0o022) === 0));
+  } catch {
+    return false;
+  }
+}
+
+const loadCache = (file) => {
+  if (!ownedDir(dirname(file))) return null;
+  try {
+    return JSON.parse(readFileSync(file, "utf8"));
+  } catch {
+    return null;
+  }
+};
+
+// Write then rename, so a render running at the same time never reads half a
+// file. The temp file is created fresh ("wx"), never written through whatever
+// already sits at its name.
+function saveCache(file, state) {
+  try {
+    const dir = dirname(file);
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    if (!ownedDir(dir)) return; // a folder this account does not control: no cache
+    const tmp = `${file}.${process.pid}.tmp`;
+    rmSync(tmp, { force: true });
+    writeFileSync(tmp, JSON.stringify(state), { flag: "wx", mode: 0o600 });
+    renameSync(tmp, file);
+  } catch {
+    /* the cache only saves time; the estimate stands without it */
+  }
+}
+
+/**
+ * Deletes the estimate cache at dir, but only a folder this account controls:
+ * one another account created first is left alone, as it was never used.
+ */
+export function clearCache(dir = CACHE_DIR) {
+  if (ownedDir(dir)) rmSync(dir, { recursive: true, force: true });
+}
+
+/**
+ * Estimated request payload, in bytes, of the session whose transcript is at
+ * transcriptPath. Throws when the transcript cannot be read.
+ */
+export function estimatePayloadBytes(transcriptPath, cacheDir = CACHE_DIR) {
+  const fd = openSync(transcriptPath, "r");
+  try {
+    const { size, ino } = fstatSync(fd);
+    const file = cacheFile(cacheDir, transcriptPath);
+    const c = loadCache(file);
+    // Resume only a cache of these rules, for this file, which has not shrunk since.
+    const resume = c?.v === CACHE_VERSION && c.path === transcriptPath && c.ino === ino && c.offset <= size;
+    const state = resume
+      ? c
+      : { v: CACHE_VERSION, path: transcriptPath, ino, offset: lastBoundaryEnd(fd, size), bytes: 0 };
+    const next = { ...state, ...sumEntries(fd, state.offset, size, state.bytes) };
+    if (!resume || next.offset !== state.offset) saveCache(file, next);
+    return next.bytes;
+  } finally {
+    closeSync(fd);
+  }
+}
+
+/**
+ * The HUD segment, "payload:28%/9.0MB" (share of the 32MB limit / size), in the
+ * 5h/wk layout the wrapper colors like ctx; "" below 8MB.
+ */
+export function payloadSegment(bytes) {
+  if (!(bytes >= SHOW_FROM_BYTES)) return "";
+  const pct = Math.floor((bytes / REQUEST_LIMIT_BYTES) * 100);
+  return `payload:${pct}%/${(bytes / MB).toFixed(1)}MB`;
+}

package/skills/ready-compact/SKILL.md

@@ -1,67 +1,114 @@
----
-name: ready-compact
-description: "(banker) 컨텍스트 compaction 직전 진행 상태를 저장하고 이어갈 resume 프롬프트를 생성. 'ready-compact'/'compact 준비'/'이어서 하게 준비'/'이어갈 프롬프트' 시 사용."
----
-
-# ready-compact — compaction 전 상태 저장 + resume 프롬프트
-
-컨텍스트가 곧 요약(compaction)될 때, 다음 세션이 **휘발성 맥락 없이도** 작업을 이어가도록
-준비한다. compaction은 대화를 요약하지만 "지금 어디까지 했고 다음 한 수가 무엇인지"가 흐려질
-수 있으므로, 그 핵심을 (1) 내구 메모리에 저장하고 (2) 붙여넣기용 resume 프롬프트로 출력한다.
-
-## 언제 쓰나
-- 컨텍스트가 한계에 가까워 곧 compaction 될 때(또는 사용자가 미리 준비를 요청할 때).
-- 긴 멀티스텝 작업을 중간에 끊었다가 이어야 할 때.
-- 사용자가 "ready-compact", "compact 준비", "이어서 할 수 있게 준비" 등으로 요청할 때.
-
-## 쓰지 않을 때
-- 작업이 이미 끝났고 이어갈 게 없을 때(그냥 마무리 보고로 충분).
-- 코드/깃/CLAUDE.md/메모리가 그대로 담는 사실의 단순 복제(중복).
-
-## 워크플로우
-
-### 1) 상태 스냅샷 수집 (휘발성 맥락 위주)
-지금 대화에서 아래를 추린다 — **메모리/플랜에 이미 있는 건 링크만**, 없는 휘발성만 본문에:
-- **목표(Goal)**: 사용자의 원 요청 한 줄.
-- **현재 단계(Phase)**: 전체 흐름 중 지금 위치.
-- **완료(Done)**: 커밋 해시 + 핵심 산출물(파일/마이그레이션/모니터). 가능하면 `git log --oneline`로 확정.
-- **현재 상태(State)**: 서버/DB/테스트의 *검증된* 상태(예: "37 테스트 PASS, 서버 재기동 정상, 모니터 8/8 PASS").
-- **다음 한 수(Next)**: compaction 직후 실행할 **구체적** 액션 1~3개(명령/파일/대상 포함). 사용자 결정 대기면 그 사실을 명시.
-- **미결 결정(Open)**: 사용자 판단이 필요한 분기(있으면).
-- **함정·제약(Gotchas)**: 이 작업에서만 비자명한 것(세션 한정 명령, 순서 의존, 미커밋 여부, 운영 미반영 등).
-- **검증 명령(Verify)**: 이어받은 사람이 현 상태를 즉시 재확인할 복붙 명령.
-
-### 2) 내구 저장
-프로젝트 메모리 디렉터리(`<memory>/`)에 resume 노트를 기록한다(메모리는 compaction을 넘어
-세션마다 로드됨). **기존 메모리/플랜과 중복은 피하고**, 관련 메모리는 `[[slug]]`로 링크.
-- 파일: `<memory>/resume-<topic-slug>.md` (frontmatter: `type: project`).
-- 본문: 위 스냅샷(특히 Next/Open/Gotchas/Verify)을 응축. 영속 상세는 링크.
-- `MEMORY.md`에 한 줄 포인터 추가/갱신.
-- 작업이 git 미커밋 상태면 그 사실과 파일 목록을 명시(다음 세션이 덮어쓰지 않도록).
-
-### 3) resume 프롬프트 생성
-compaction 이후 **그대로 붙여넣으면** 작업이 이어지는 자급식 프롬프트를 코드블록으로 출력.
-템플릿:
-
-```
-[RESUME] <목표 한 줄>. 진행 메모리: <memory>/resume-<slug>.md (+ MEMORY.md, [[관련 slug]]).
-현재까지: <완료 요약 + 커밋 해시>. 상태: <검증된 상태>.
-다음 할 일: <구체 액션 1~3, 또는 "사용자 결정 대기: <옵션들>">.
-미결: <사용자 판단 분기 / 없으면 생략>.
-먼저 현 상태 확인:
-  <verify 명령 복붙>
-제약: <환경/순서/미커밋/운영미반영 등 핵심 함정>. (상세는 위 메모리 파일 참조.)
-```
-
-### 4) 보고 (한글)
-- 저장한 resume 파일 경로 + MEMORY.md 갱신 여부.
-- resume 프롬프트(코드블록)를 마지막에 제시.
-- "compaction 후 이 프롬프트를 붙여넣으면 이어집니다" 안내.
-
-## 작성 원칙
-- **휘발성 우선**: 메모리/플랜/깃이 담는 영속 사실은 링크, compaction이 잃을 '다음 한 수'를 본문에.
-- **자급식 resume**: 프롬프트만 보고도 검증→다음 액션이 가능해야 함(메모리 파일은 백업/상세).
-- **증거 기반**: 커밋 해시·테스트 수·모니터 결과 등 *검증된* 값으로. 추측 금지.
-- **덮어쓰기 방지**: 미커밋 변경/운영 미반영이 있으면 반드시 명시.
-
-ARGUMENTS: $ARGUMENTS (선택: 이어갈 작업의 토픽/슬러그 힌트. 없으면 현재 대화에서 추론.)
+---
+name: ready-compact
+description: "(banker) 진행 상태를 저장하고 이어갈 resume 프롬프트만 출력(설명 없이 프롬프트 본문만이라 /copy 한 번이면 복사). 기본은 같은 세션의 /compact 뒤, --hand-off 는 새 세션에서 처음부터 이어가기. 'ready-compact'/'compact 준비'/'이어서 하게 준비'/'이어갈 프롬프트'/'새 세션으로 넘겨'/'핸드오프' 시 사용."
+argument-hint: "[--hand-off] [토픽 힌트]"
+---
+
+# ready-compact — 이어가기 상태 저장 + resume 프롬프트
+
+진행 중인 작업을 끊었다가 이어갈 수 있게 준비한다.
+(1) 이어가기 노트를 내구 저장소에 기록하고, (2) 붙여넣기용 resume 프롬프트를 **최종 메시지 전체로** 내놓는다.
+
+## 모드
+
+| 모드 | 호출 | 이어 가는 곳 | 그 세션에 이미 있는 것 |
+|---|---|---|---|
+| compact (기본) | `ready-compact` | 같은 세션, `/compact` 뒤 | compaction 요약, 메모리, CLAUDE.md |
+| hand-off | `ready-compact --hand-off` | 같은 머신의 새 세션(`/clear` 뒤, 새 터미널) | 메모리, CLAUDE.md, 저장소뿐. 이번 대화는 없음 |
+
+- 인자에서 `--hand-off` 를 떼고 남은 말은 토픽·슬러그 힌트다. 없으면 대화에서 추론한다.
+- 사용자가 "새 세션에서", "핸드오프", "다른 세션으로 넘겨" 처럼 말하면 hand-off 로 본다.
+- 다른 머신이나 다른 사람에게 넘길 때: 노트는 이 머신의 메모리 폴더나 git 무시 폴더에 있어 그쪽에 없다. 결정과 이유, 하지 말 것까지 프롬프트에 직접 넣는다(노트 경로는 참고용).
+
+## 언제 쓰나
+- 컨텍스트가 한계에 가까워 곧 compaction 될 때(또는 사용자가 미리 준비를 요청할 때) — compact.
+- 세션을 닫고 새 세션에서 이어 가려 할 때 — hand-off.
+- 사용자가 "ready-compact", "compact 준비", "이어서 할 수 있게 준비" 등으로 요청할 때.
+
+## 쓰지 않을 때
+- 작업이 이미 끝났고 이어갈 게 없을 때(그냥 마무리 보고로 충분).
+- 코드/깃/CLAUDE.md/메모리가 그대로 담는 사실의 단순 복제(중복).
+
+## 워크플로우
+
+### 1) 상태 스냅샷 수집
+지금 대화에서 아래를 추린다 — **메모리/플랜에 이미 있는 건 링크만**, 없는 것만 본문에:
+- **목표(Goal)**: 사용자의 원 요청 한 줄.
+- **현재 단계(Phase)**: 전체 흐름 중 지금 위치.
+- **완료(Done)**: 커밋 해시 + 핵심 산출물(파일/마이그레이션/모니터). 가능하면 `git log --oneline`로 확정.
+- **현재 상태(State)**: 서버/DB/테스트의 *검증된* 상태(예: "37 테스트 PASS, 서버 재기동 정상, 모니터 8/8 PASS").
+- **다음 한 수(Next)**: 이어받자마자 실행할 **구체적** 액션 1~3개(명령/파일/대상 포함). 사용자 결정 대기면 그 사실을 명시.
+- **미결 결정(Open)**: 사용자 판단이 필요한 분기(있으면).
+- **함정·제약(Gotchas)**: 이 작업에서만 비자명한 것(세션 한정 명령, 순서 의존, 미커밋 여부, 운영 미반영 등).
+- **검증 명령(Verify)**: 이어받은 쪽이 현 상태를 즉시 재확인할 복붙 명령.
+
+**hand-off 는 여기에 더한다.** 새 세션에는 이 대화가 없으므로, 대화에만 있던 것을 옮긴다:
+- **작업 위치**: 저장소 절대경로, 브랜치, 워크트리 여부, 마지막 커밋 해시.
+- **배경과 결정**: 사용자가 이번 대화에서 정한 것과 그 이유(승인한 설계, 고른 선택지, 거절한 대안).
+- **진행 중인 것**: 켜져 있는 모드(ralph·autopilot·ultragoal·team 등)와 상태 파일 경로, 실행 중인 백그라운드 작업과 출력 파일. 이 세션이 끝나면 백그라운드 작업은 함께 멈출 수 있다는 점.
+- **모드 다시 켜기**: PRD 와 상태 파일은 세션별 경로라 새 세션이 스스로 찾지 못한다. 경로(예: `.omc/state/sessions/<id>/prd.json`, `.omc/plans/…`)와 다시 켜는 방법(예: 새 세션에서 `ralph` 에 그 PRD 경로를 넘김)을 적는다.
+- **하지 말 것**: 이미 끝낸 단계, 사용자가 금지한 동작, 승인을 기다리는 행위(커밋·push·게시 등).
+
+**켜져 있는 지속 모드(ralph·autopilot·ultragoal·team 등)가 있으면 먼저 처리한다.** 그 모드의 Stop 훅은 응답이 끝날 때 "계속하라"는 메시지를 넣어, 프롬프트가 마지막 메시지로 남지 못하게 한다.
+- hand-off: 노트를 쓰기 전에 모드를 유지할지(새 세션에서 다시 켬) 지금 cancel 할지 묻고(Claude Code 는 `AskUserQuestion`), 답을 노트에 적는다.
+- Codex: OMX 지속 모드가 켜져 있으면 응답을 끝내도 훅이 계속 다시 시작하게 해, 프롬프트만 남기는 것을 보장할 수 없다. 이 점을 알리고 모드를 끌지 먼저 묻는다.
+
+### 2) resume 프롬프트 작성 (저장보다 먼저)
+그대로 붙여넣으면 작업이 이어지는 자급식 프롬프트를 만든다. 3단계에서 노트 끝에 이 프롬프트를 붙이므로 저장보다 먼저 쓴다.
+아래 템플릿은 읽기 쉽게 펜스로 보였을 뿐이다. **프롬프트에는 어디에도 코드 펜스(```)를 넣지 않는다**(4단계). 명령은 두 칸 들여쓰기로 적는다.
+
+compact:
+
+```
+[RESUME] <목표 한 줄>. 진행 메모리: <노트 경로> (+ MEMORY.md, [[관련 slug]]).
+현재까지: <완료 요약 + 커밋 해시>. 상태: <검증된 상태>.
+다음 할 일: <구체 액션 1~3, 또는 "사용자 결정 대기: <옵션들>">.
+미결: <사용자 판단 분기 / 없으면 생략>.
+먼저 현 상태 확인:
+  <verify 명령 복붙>
+제약: <환경/순서/미커밋/운영미반영 등 핵심 함정>. (상세는 위 메모리 파일 참조.)
+```
+
+hand-off:
+
+```
+[HANDOFF] <목표 한 줄>. 이전 세션의 작업을 새 세션에서 이어 간다.
+작업 폴더: <절대경로> (브랜치 <이름>, 마지막 커밋 <해시>). 이 폴더에서 연 세션이 아니면 사용자에게 이 폴더에서 새 세션을 열어 달라고 요청.
+먼저 읽을 것: <노트 경로> (배경, 결정, 함정 전부).
+현재까지: <완료 요약>. 상태: <검증된 상태>. 미커밋: <파일 목록 / 없음>.
+진행 중이던 것: <모드와 상태 파일, 다시 켜는 방법, 백그라운드 작업과 출력 파일 / 없음>.
+다음 할 일: <구체 액션 1~3, 또는 "사용자 결정 대기: <옵션들>">.
+미결: <사용자 판단 분기 / 없으면 생략>.
+먼저 현 상태 확인:
+  <verify 명령 복붙>
+제약: <핵심 함정, 하지 말 것>. 이미 끝난 단계는 다시 하지 않는다.
+```
+
+### 3) 내구 저장
+
+| 런타임 | 노트 위치 |
+|---|---|
+| Claude Code | 자동 메모리 폴더 `<memory>/resume-<topic-slug>.md`(frontmatter `type: project`) + `MEMORY.md` 한 줄 포인터 추가/갱신. 자동 메모리가 꺼져 있어 폴더를 모르면 작업 폴더의 `.omc/handoffs/resume-<topic-slug>.md` |
+| Codex | 작업 폴더의 `.omx/handoffs/resume-<topic-slug>.md` (Codex 에는 자동 메모리 폴더가 없다) |
+
+- **기존 메모리/플랜과 중복은 피하고**, 관련 메모리는 `[[slug]]`로 링크(Claude Code).
+- compact 노트는 휘발성 위주로 응축한다. hand-off 노트는 **그 파일 하나만 읽어도** 이어갈 수 있게 1단계의 추가 항목까지 적는다.
+- 작업이 git 미커밋 상태면 그 사실과 파일 목록을 명시(다음 세션이 덮어쓰지 않도록).
+- 노트 끝에 2단계의 프롬프트를 그대로 붙인다. 클립보드를 잃어도 노트에서 되찾을 수 있다.
+- 작업 폴더 안에 둔 노트(`.omc/handoffs/`, `.omx/handoffs/`)가 git 무시 대상이 아니면(`git check-ignore -q <경로>` 실패) 프롬프트에 "노트는 커밋하지 말 것" 을 넣는다.
+- 저장에 실패해도 멈추지 않는다. 프롬프트 **둘째 줄**에 경고를 넣는다(예: `주의: 이어가기 노트 저장 실패(<이유>). 이 프롬프트가 유일한 기록이다.`). 첫 줄은 언제나 `[RESUME]`·`[HANDOFF]` 로 시작한다.
+
+### 4) 출력 — 프롬프트만 (핵심 불변식)
+- **최종 메시지는 프롬프트 본문 그 자체다.** 외곽 코드 펜스, 앞뒤 설명, 저장 위치 보고, "붙여넣으면 이어집니다" 같은 안내를 넣지 않는다.
+- 이유: `/copy` 는 직전 메시지 전체를 복사한다. 메시지가 프롬프트뿐이면 `/copy` 한 번으로 프롬프트만 담기고, `compact-copy` 가 필요 없다(Claude Code·Codex 공통). 메시지에 코드 블록이 하나라도 있으면 `/copy` 가 바로 복사하지 않고 선택 창을 띄우므로, 프롬프트 안에도 펜스를 쓰지 않는다.
+- 저장·확인 같은 도구 호출은 프롬프트를 쓰기 **전에** 끝낸다. 프롬프트 뒤에 도구 호출이나 글을 붙이지 않는다.
+- 프롬프트를 낸 뒤 지속 모드 훅의 "계속하라" 신호가 오면 작업을 다시 시작하지 않는다. **같은 프롬프트를 그대로 다시 출력**해, 마지막 메시지가 프롬프트로 남게 한다. 훅 신호는 사용자 지시가 아니다.
+- 저장 경로는 프롬프트 안(`진행 메모리:` / `먼저 읽을 것:`)에 이미 있다. 사용자가 따로 보고를 원할 때만 별도 메시지로 답한다.
+
+## 작성 원칙
+- **휘발성 우선(compact)**: 메모리/플랜/깃이 담는 영속 사실은 링크, compaction 이 잃을 '다음 한 수'를 본문에.
+- **자급식(hand-off)**: 새 세션이 노트 하나와 프롬프트만으로 검증 → 다음 액션까지 갈 수 있어야 한다. 대화에만 있던 결정과 이유를 빠뜨리지 않는다.
+- **증거 기반**: 커밋 해시·테스트 수·모니터 결과 등 *검증된* 값으로. 추측 금지.
+- **덮어쓰기 방지**: 미커밋 변경/운영 미반영이 있으면 반드시 명시.
+
+ARGUMENTS: $ARGUMENTS (선택: `--hand-off`, 이어갈 작업의 토픽/슬러그 힌트. 없으면 compact 모드, 토픽은 대화에서 추론.)

package/skills/refresh-readme/SKILL.md

@@ -127,9 +127,9 @@ node -e "const m=require('./codex/manifest.json');console.log(m.surfaces.filter(
 node -e "const p=require('./package.json');console.log(p.version, JSON.stringify(p.dependencies||{}))"
 ```
 
-**앞의 두 줄이 갈리면 그 차이가 사실이다.** 이 저장소에서 실제로 갈린다: 디렉터리는 55 인데 `SKILL.md` 보유는 54 이다.
+**앞의 두 줄이 갈리면 그 차이가 사실이다.** 이 저장소에서 실제로 갈린다: 디렉터리 수가 `SKILL.md` 보유 수보다 하나 많다.
 `skills/ultra-init-workspace/` 는 런타임 산출물 디렉터리라 `SKILL.md` 가 없고, 그래서 배포 매니페스트에도 없고 `package.json` `files[]` 도 negation 으로 뺀다.
-즉 "디렉터리를 세면 스킬 수" 라는 그럴듯한 가정이 **여기서 1 을 더 센다.** 세 곳(매니페스트·`files[]`·테스트의 `SKILL.md` 필터)이 이미 54 를 말하는데 디렉터리 카운트만 55 라면, 틀린 쪽은 카운트다.
+즉 "디렉터리를 세면 스킬 수" 라는 그럴듯한 가정이 **여기서 1 을 더 센다.** 세 곳(매니페스트·`files[]`·테스트의 `SKILL.md` 필터)이 이미 같은 수를 말하는데 디렉터리 카운트만 하나 더 크다면, 틀린 쪽은 카운트다.
 
 **README 는 어떤 경우에도 사실이 아니다. 그리고 사실을 세는 명령도 틀릴 수 있다. 세 소스가 같은 값을 말할 때만 통과다.**
 

package/skills/rfp-author/SKILL.md

@@ -39,7 +39,7 @@ description: "(banker) 소프트웨어 외주 제안요청서(RFP)를 한국 공
 ## 워크플로우 (도구 오케스트레이션)
 RFP 저작은 **저작 lane과 검수 lane을 분리**(자기승인 금지). 권장 순서:
 
-1. **과업내용 추출** — 현 코드/spec → 요구사항. `deep-dive`(또는 agent `feature-dev:code-explorer`)로 화면·API·데이터·외부연계를 SFR/INR/DAR로 도출 → `references/this-project-scope.md` 채움(file:LINE 동반). 디자인은 PDF/이미지 추출 도구로 `<DesignRef(page-section)>` 형태 인용키 추출.
+1. **과업내용 추출** — 현 코드/spec → 요구사항. `research`(OMC 5 에서 삭제된 `deep-dive` 의 대체) 또는 agent `feature-dev:code-explorer` 로 화면·API·데이터·외부연계를 SFR/INR/DAR로 도출 → `references/this-project-scope.md` 채움(file:LINE 동반). 디자인은 PDF/이미지 추출 도구로 `<DesignRef(page-section)>` 형태 인용키 추출.
 2. **구조·범위·배점 합의** — `ralplan --deliberate`로 RFP 구조·15유형 범위·평가 정성/정량 배점을 Planner→Architect→Critic 합의(Planner는 SoT word-for-word 인용 의무). broad/risky 결정만.
 3. **섹션 병렬 작성** — 5+ 섹션이면 `team`(워커별 절 담당), 소규모는 agent `oh-my-claudecode:writer`. 각 절은 `templates/rfp-skeleton.md`를 채우고 `references/`를 인용.
 4. **미검증 보강** — OPEN 항목(특히 망분리/PIPA/보안성심의/secure-coding)은 `autoresearch`/`deep-research` 또는 agent `document-specialist`로 **추가 리서치 후** SER에 반영. 미보강 시 〈OPEN〉 유지.
@@ -48,7 +48,7 @@ RFP 저작은 **저작 lane과 검수 lane을 분리**(자기승인 금지). 권
 
 | 작업 | 권장 도구 |
 |---|---|
-| 과업내용 추출(코드→요구) | `deep-dive` / `feature-dev:code-explorer` / PDF·이미지 추출 도구 |
+| 과업내용 추출(코드→요구) | `research`(구 `deep-dive`) / `feature-dev:code-explorer` / PDF·이미지 추출 도구 |
 | 구조·배점 합의 | `ralplan --deliberate` |
 | 섹션 병렬 저작 | `team` / `oh-my-claudecode:writer` |
 | OPEN 추가 리서치 | `autoresearch` / `deep-research` / `document-specialist` |

package/skills/setup-omc/SKILL.md

@@ -6,21 +6,28 @@ description: "(banker) all-in-one·ultra-init·front-qa 가 의존하는 oh-my-c
 # setup-omc: oh-my-claudecode(OMC) 설치/갱신
 
 banker의 오케스트레이터(`all-in-one`·`ultra-init`)와 `/banker:front-qa` 커맨드는 OMC의
-`ralplan`·`ralph`·`ultraqa` 등에 의존한다. 이 스킬은 OMC를 설치하거나 최신화한다(이미 있으면 갱신만; 멱등). 답변은 한글.
+`ralplan`·`ralph`·`verify` 와 `omc` CLI(`omc ralph verify`)에 의존한다. OMC 5부터 `ralph` 가 첫 반복에 `omc ralph verify` 를 직접 부르므로, 플러그인만 새것이고 전역 `omc` CLI 가 낡으면(4.x) `ralph` 가 시작하자마자 멈춘다. 이 스킬은 OMC를 설치하거나 최신화한다(이미 있으면 갱신만; 멱등). 답변은 한글.
 
 ## 0. 감지 (먼저, 추정 금지)
 ```bash
 command -v omc >/dev/null && omc --version || echo "omc: 미설치"
+omc ralph verify --help 2>&1 | grep -q 'Usage: omc ralph verify' && echo "omc CLI: ralph verify 있음" || echo "omc CLI: ralph verify 없음 (미설치 또는 4.x)"
 command -v claude >/dev/null || echo "claude: 미설치"
 ```
+- `ralph verify` 는 종료 코드가 아니라 **출력 문구로 판정**한다. 4.x CLI 는 모르는 명령에 `--help` 를 붙이면 전체 도움말을 찍고 0 으로 끝난다. `--help` 없이 부르면 Claude 실행으로 넘어가므로 점검에는 반드시 붙인다.
 
 ## Claude Code · OMC
 - **이미 설치(`omc` 존재)** 면 최신화만 한다:
   ```bash
   omc update      # 플러그인·npm 패키지·CLAUDE.md 동기화
   ```
+- `omc update` 가 중간에 실패하거나 끝난 뒤에도 `ralph verify` 가 없으면, CLI 만 직접 올린다:
+  ```bash
+  npm install -g oh-my-claude-sisyphus@latest
+  ```
+  - 네이티브 모듈(`better-sqlite3`) 빌드가 낡은 기본 컴파일러 때문에 실패하는 배포판(예: RHEL·Rocky 8)은 새 gcc 를 켠 셸에서 같은 명령을 실행한다(예: `source /opt/rh/gcc-toolset-14/enable`).
 - **미설치** 면 공식 배포처 절차를 따른다(일반적으로 npm 전역 설치 후 `omc setup`). 정확한 설치 명령이 불명확하면 추정하지 말고 사용자에게 확인한다.
-- 확인: `omc --version` + Claude 재시작·`/reload-plugins` 후 `/oh-my-claudecode:*` 노출.
+- 확인: `omc --version`, 위 `ralph verify` 점검 통과, Claude 재시작·`/reload-plugins` 후 `/oh-my-claudecode:*` 노출.
 
 ## Codex CLI · OMX (oh-my-codex)
 Codex에서의 대응 프레임워크는 OMX다.
@@ -30,7 +37,7 @@ command -v omx >/dev/null && omx setup      # 유저/프로젝트 레벨 OMX 구
 - 미설치면 OMX 배포처 안내대로 설치 후 `omx setup`.
 
 ## 검증·보고
-- OMC: `omc --version` / OMX: `omx --version`. 반영엔 재시작·`/reload-plugins`(Claude)가 필요할 수 있다.
+- OMC: `omc --version` + `ralph verify` 점검 / OMX: `omx --version`. 반영엔 재시작·`/reload-plugins`(Claude)가 필요할 수 있다.
 - 실패·불명확은 정직 보고(가짜 성공 금지).
 
 ## 함정

package/skills/setup-omc-hud/SKILL.md

@@ -13,6 +13,14 @@ description: "(banker) omc_hud(Claude Code 상태표시줄)를 OS별 apply 스
 ```bash
 case "$(uname -s)" in Darwin) OS=mac;; Linux) OS=linux;; *) OS=windows;; esac; echo "OS=$OS"
 command -v wget >/dev/null && echo "dl=wget" || { command -v curl >/dev/null && echo "dl=curl" || echo "dl=none(설치 필요)"; }
+# 적용 스크립트가 래퍼를 덮어쓰면 payload-mon 표시 블록이 빠진다. 지금 켜져 있는지 기억해 둔다(3단계에서 사용).
+HUD_FILE="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hud/omc-hud-custom.mjs"
+grep -qF '// >>> payload-mon >>>' "$HUD_FILE" 2>/dev/null && echo "payload-mon=on" || echo "payload-mon=off"
+```
+Windows(PowerShell)에서는 같은 확인을 이렇게 한다:
+```powershell
+$cfg = if ($env:CLAUDE_CONFIG_DIR) { $env:CLAUDE_CONFIG_DIR } else { "$env:USERPROFILE\.claude" }
+if (Select-String -Quiet -SimpleMatch -LiteralPath "$cfg\hud\omc-hud-custom.mjs" -Pattern '// >>> payload-mon >>>' -ErrorAction SilentlyContinue) { "payload-mon=on" } else { "payload-mon=off" }
 ```
 
 ## 1. mac / linux — apply 스크립트 적용
@@ -41,6 +49,9 @@ git 없으면 GitHub "Download ZIP" → 해제 → 동봉 적용 스크립트
 - 적용 스크립트가 `~/.claude/settings.json` 의 statusLine 등을 갱신했는지(스크립트 출력 확인).
 - HUD는 **다음 프롬프트/세션**부터 반영될 수 있음 → 안 보이면 재시작 안내.
 - `~/dummy` 임시파일 정리 확인. 이미 적용돼 있으면 재적용 불필요.
+- **payload-mon 복구**: 0단계에서 `payload-mon=on` 이었다면, 적용 스크립트가 래퍼를 덮어써 payload 표시 블록이 빠진 상태다.
+  payload-mon 스킬(Claude Code `/banker:payload-mon`, Codex `banker-payload-mon`)을 `on` 으로 실행해 다시 켜고, 그 결과를 함께 보고한다.
+  `payload-mon=off` 였다면 아무것도 하지 않는다(사용자가 켠 적 없는 기능을 켜지 않는다).
 
 ## 함정
 - `curl` 다운로드는 **대문자 `-O`**(원격 파일명 유지). 소문자 `-o`는 출력명 지정이라 다름.

package/skills/smart-compact/SKILL.md

@@ -1,20 +1,21 @@
 ---
 name: smart-compact
-description: "(banker) 컨텍스트 임계(기본 50%) 초과 시 append-wiki→ready-compact→compact-copy 자동 실행 + /copy·/compact·paste 유저 핸드오프 게이트. 'smart-compact' 활성화 / '--cancel' 해제."
+description: "(banker) 컨텍스트 임계(기본 50%) 초과 시 append-wiki→ready-compact 자동 실행(마지막 메시지가 resume 프롬프트뿐) + /copy·/compact·paste 유저 핸드오프 게이트. 'smart-compact' 활성화 / '--cancel' 해제."
 ---
 
 # smart-compact — 컨텍스트 위생 자동 게이트
 
 긴 세션에서 컨텍스트가 임계(기본 **50%**)를 넘으면, compaction 전에 상태를 안전하게 보존하는
-리추얼을 **자동 발동**한다: `append-wiki` → `ready-compact` → `compact-copy` → *(유저)* `/copy`
+리추얼을 **자동 발동**한다: `append-wiki` → `ready-compact` → *(유저)* `/copy`
 → `/compact` → paste. `smart-compact` 로 무장, `smart-compact --cancel` 로 해제한다.
+`ready-compact` 는 0.14.0 부터 마지막 메시지를 resume 프롬프트만으로 내므로, 예전처럼 `compact-copy` 를 거치지 않는다.
 
 ## ⚠️ 정직한 실현 한계 (Claude Code 실측)
 "컨텍스트 50%에서 완전 무인 자동"은 **부분만 가능**하다 — 근거:
 - **감지**: 컨텍스트 사용률은 **statusLine stdin** 의 `context_window.used_percentage` 로만 실시간
   노출된다(hook은 이 값을 못 받음; auto-compact은 ~95%에서만, 50% 이벤트 없음). → statusLine으로
   **정확히 50% 감지 가능**.
-- **자동 실행 가능(어시스턴트)**: `append-wiki` · `ready-compact` · `compact-copy` — 스킬/도구
+- **자동 실행 가능(어시스턴트)**: `append-wiki` · `ready-compact` — 스킬/도구
   작업이라 어시스턴트가 수행.
 - **자동 불가(TUI 전용)**: `/copy` · `/compact` · **paste** 는 인터랙티브 TUI 동작이라 hook·스킬이
   구동할 수 없다(hook은 슬래시명령 호출 불가, `additionalContext` 주입만 가능). → **이 3단은 유저가
@@ -35,7 +36,7 @@ description: "(banker) 컨텍스트 임계(기본 50%) 초과 시 append-wiki→
 2. **hook 브리지**: `UserPromptSubmit`(또는 `PreToolUse`) hook이 신호 파일을 읽어 무장·미처리 상태면
    `additionalContext` 로 "smart-compact: 컨텍스트 ≥임계 — 위생 체인 실행" 을 주입한다(hook은 명령을
    못 부르므로 어시스턴트에게 **지시만** 한다).
-3. **게이트 동작(어시스턴트)**: 주입을 받으면 자동파트 실행 → 이어 유저에게 TUI 3단을 정확한 명령으로 안내.
+3. **게이트 동작(어시스턴트)**: 주입을 받으면 자동파트를 실행한다. TUI 3단 안내는 `ready-compact` **전에** 한 줄로 하고, 마지막 메시지는 `ready-compact` 의 프롬프트로 끝낸다(안내를 뒤에 붙이면 `/copy` 가 안내문을 복사한다).
 
 **Codex (OMX):**
 - Codex가 statusline/hook에 컨텍스트%를 노출하는지 **미확인**(문서 부재). 노출되면 위와 동형으로 구성
@@ -46,13 +47,13 @@ description: "(banker) 컨텍스트 임계(기본 50%) 초과 시 append-wiki→
 무장 후 임계 초과가 감지되면 순서대로:
 
 1. **`append-wiki`** — 이번 작업의 비자명 지식을 wiki에 적재(휘발 방지). *(banker `append_wiki`, both)*
-2. **`ready-compact`** — resume 프롬프트 + 내구 메모리 기록. *(banker `ready-compact`, both)*
-3. **`compact-copy`** — resume 프롬프트-only 로 최종 메시지 셰이핑(response.md). *(banker `compact-copy`, both)*
+2. *(한 줄 안내)* 다음 메시지가 resume 프롬프트이며, 그 뒤 `/copy` → `/compact` → 붙여넣기 순서임을 알린다.
+3. **`ready-compact`** — 내구 메모리 기록 + resume 프롬프트. 마지막 메시지가 프롬프트뿐이다. *(banker `ready-compact`, both)*
 4. *(유저 · TUI)* **`/copy`** → **`/compact`** → **paste**(복사된 resume 프롬프트 입력).
 
-1~3은 어시스턴트가 자동 수행. 4는 어시스턴트가 **정확한 명령을 제시**하고 유저가 실행한다.
-(Claude=`/banker:append_wiki`·`/banker:ready-compact`·`/banker:compact-copy`,
-Codex=`$banker-append_wiki`·`$banker-ready-compact`·`$banker-compact-copy`; `/copy`·compaction은 양쪽 TUI 내장.)
+1~3은 어시스턴트가 자동 수행. 4는 유저가 실행한다. 안내는 2에서 끝내고 3 뒤에는 아무것도 붙이지 않는다.
+(Claude=`/banker:append_wiki`·`/banker:ready-compact`,
+Codex=`$banker-append_wiki`·`$banker-ready-compact`; `/copy`·compaction은 양쪽 TUI 내장.)
 
 ## 활성화 (idempotent · compose-safe)
 `smart-compact [--threshold N]` (기본 N=50):