therookie 0.4.3

package/src/lib/task-path-match.js

@@ -0,0 +1,122 @@
+// done-scan 경로 매칭 — src/lib/forgetting/task-match.ts 의 pathTier 규칙 최소 포트.
+// spec docs/superpowers/specs/2026-07-01-completion-linkage-remove-vs-improve.md §5.4.
+//
+// 완료된 doing task 를 git 커밋 산출물로 결정론적 감지한다. spec_ref 있는 task 만
+// 경로 강신호(tier≥3)로 매칭 — 오연결 < 미연결(보수적). LLM 판단 없음.
+
+// spec_ref 는 follow-up task 에서 `specs/a.md#3차-pr` 처럼 `#fragment` 가 붙는다(spec-followup-core).
+// git 파일경로엔 fragment 가 없으니 spec_ref 매칭 전 제거해야 exact/render-pair tier 가 산다.
+// (커밋 파일 경로엔 적용 안 함 — 파일명 내 `#` 오절단 방지.)
+export function stripPathFragment(p) {
+  return String(p).replace(/#.*$/, '')
+}
+
+// 비교 전용 경로 정규화: 소문자 + `\`→`/` + 중복 slash 축약 + trailing slash 제거 + `.`·빈 segment 제거.
+export function normalizePathForMatch(p) {
+  return String(p)
+    .toLowerCase()
+    .replace(/\\/g, '/')
+    .replace(/\/+/g, '/')
+    .replace(/\/$/, '')
+    .split('/')
+    .filter((seg) => seg.length > 0 && seg !== '.')
+}
+
+function splitExt(fileSeg) {
+  const dot = fileSeg.lastIndexOf('.')
+  if (dot <= 0) return { stem: fileSeg, ext: '' }
+  return { stem: fileSeg.slice(0, dot), ext: fileSeg.slice(dot + 1) }
+}
+
+// short 가 long 의 trailing suffix 인가(segment 단위).
+function isSuffix(short, long) {
+  if (short.length > long.length) return false
+  const offset = long.length - short.length
+  for (let i = 0; i < short.length; i++) {
+    if (short[i] !== long[offset + i]) return false
+  }
+  return true
+}
+
+const RENDER_EXTS = new Set(['md', 'html', 'htm', 'mdx'])
+
+// 두 정규화 경로의 점수 계층(0~4). task-match.ts §10.3 그대로.
+export function pathTier(aSegs, sSegs) {
+  if (aSegs.length === 0 || sSegs.length === 0) return 0
+  const [short, long] = aSegs.length <= sSegs.length ? [aSegs, sSegs] : [sSegs, aSegs]
+
+  // exact — 최소 디렉토리 1개(짧은 길이 ≥ 2)로 1-segment 오연결 차단.
+  if (short.length >= 2 && isSuffix(short, long)) return 4
+
+  const aFile = splitExt(aSegs[aSegs.length - 1])
+  const sFile = splitExt(sSegs[sSegs.length - 1])
+  const aDir = aSegs.slice(0, -1)
+  const sDir = sSegs.slice(0, -1)
+  const [shortDir, longDir] = aDir.length <= sDir.length ? [aDir, sDir] : [sDir, aDir]
+
+  // same-stem — render pair 만, 디렉토리 suffix ≥ 1.
+  if (
+    aFile.stem === sFile.stem &&
+    aFile.ext !== sFile.ext &&
+    RENDER_EXTS.has(aFile.ext) &&
+    RENDER_EXTS.has(sFile.ext) &&
+    shortDir.length >= 1 &&
+    isSuffix(shortDir, longDir)
+  ) {
+    return 3
+  }
+
+  // basename — 파일명(확장자 포함) 일치.
+  if (aSegs[aSegs.length - 1] === sSegs[sSegs.length - 1]) return 2
+
+  // parent-dir — 디렉토리 suffix ≥ 1 일치.
+  if (shortDir.length >= 1 && isSuffix(shortDir, longDir)) return 1
+
+  return 0
+}
+
+// task.detail 의 __done_defer:<sha> 머신 토큰 → Set<sha>. rookie_task 에 tags 컬럼이 없어 detail 에 둔다.
+const DEFER_RE = /__done_defer:([0-9a-f]{7,40})/g
+export function parseDeferShas(detail) {
+  const out = new Set()
+  if (!detail) return out
+  let m
+  while ((m = DEFER_RE.exec(detail)) !== null) out.add(m[1])
+  return out
+}
+
+// deferSha(7~40 hex prefix)가 commit sha 의 prefix 면 그 (task,commit) 은 보류됨.
+function isDeferred(commitSha, deferShas) {
+  for (const d of deferShas) {
+    if (commitSha.startsWith(d)) return true
+  }
+  return false
+}
+
+// 강매칭(tier≥3): task.spec_ref 와 commit 파일 중 하나라도.
+function commitMatchesSpec(specSegs, commit) {
+  for (const f of commit.files ?? []) {
+    if (pathTier(normalizePathForMatch(f), specSegs) >= 3) return true
+  }
+  return false
+}
+
+// doing task × commits → done 후보. spec_ref 있는 task 만, 보류 커밋 제외, 최신 매칭 커밋 1건.
+// commits 는 최신순(git log 기본) 가정.
+export function matchDoneCandidates(tasks, commits) {
+  const out = []
+  for (const t of tasks) {
+    if (!t.spec_ref) continue
+    const specSegs = normalizePathForMatch(stripPathFragment(t.spec_ref))
+    if (specSegs.length === 0) continue
+    const deferShas = parseDeferShas(t.detail)
+    for (const c of commits) {
+      if (isDeferred(c.sha, deferShas)) continue
+      if (commitMatchesSpec(specSegs, c)) {
+        out.push({ taskId: t.id, taskTitle: t.title, sha: c.sha, subject: c.subject })
+        break
+      }
+    }
+  }
+  return out
+}

package/src/prompt.js

@@ -0,0 +1,60 @@
+import readline from 'node:readline'
+
+export async function ask(question, { defaultValue = '' } = {}) {
+  if (!process.stdin.isTTY) {
+    throw new Error(`non-interactive stdin — '${question}' 을 답할 수 없습니다. --yes 또는 --force 플래그를 지정하세요.`)
+  }
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+  const answer = await new Promise((resolve) => {
+    rl.question(defaultValue ? `${question} (${defaultValue}) ` : `${question} `, resolve)
+  })
+  rl.close()
+  return answer.trim() || defaultValue
+}
+
+// echo 없이 비밀번호 입력 받기. stdin raw mode로 문자별 수신, * 같은 표시도 생략해
+// 길이조차 노출되지 않도록 한다. TTY 없으면 거절.
+export async function askPassword(question) {
+  if (!process.stdin.isTTY) {
+    throw new Error(`non-interactive stdin — '${question}' 은 TTY 필요.`)
+  }
+  process.stdout.write(`${question} `)
+  return new Promise((resolve, reject) => {
+    const stdin = process.stdin
+    stdin.setRawMode(true)
+    stdin.resume()
+    stdin.setEncoding('utf8')
+    let buf = ''
+    const onData = (ch) => {
+      // Ctrl+D(EOT, ) or Enter → submit
+      if (ch === '\r' || ch === '\n' || ch === '') {
+        cleanup()
+        process.stdout.write('\n')
+        resolve(buf)
+      } else if (ch === '') {
+        // Ctrl+C → abort
+        cleanup()
+        process.stdout.write('\n')
+        reject(new Error('aborted'))
+      } else if (ch === '' || ch === '\b') {
+        // DEL or backspace
+        if (buf.length > 0) buf = buf.slice(0, -1)
+      } else {
+        buf += ch
+      }
+    }
+    const cleanup = () => {
+      stdin.removeListener('data', onData)
+      stdin.setRawMode(false)
+      stdin.pause()
+    }
+    stdin.on('data', onData)
+  })
+}
+
+export async function confirm(question, { defaultYes = false } = {}) {
+  const hint = defaultYes ? 'Y/n' : 'y/N'
+  const ans = (await ask(`${question} [${hint}]`)).toLowerCase()
+  if (!ans) return defaultYes
+  return ans === 'y' || ans === 'yes'
+}

package/templates/hook/bin/posttool-recall-nudge.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+# PostToolUse recall nudge — 로컬 기억 문서 읽기 감지 시 "recall 먼저" 1줄 주입.
+# spec: docs/superpowers/specs/2026-07-10-recall-first-injection-regression-fix.md §3.B2
+#
+# 책임: Read/Bash/Grep 이 worklog·archive·specs·MEMORY.md 를 읽은 직후,
+#       세션당 1회 additionalContext 로 교정 신호를 주입한다.
+#       측정(pretool-md-read.sh, PreToolUse)과 책임 분리 — 이 hook 은 교정 전용.
+#       차단 절대 X — 항상 exit 0.
+
+# IMPORTANT: set -e 금지. fail-fast 가 Claude Code tool 흐름을 깨는 위험.
+set +e
+
+# self-reference 방지(spec O-4) 1차 방어선:
+# 차차 internal LLM 호출(`claude -p` from cli-provider)에서 발사된 hook은 즉시 종료.
+if [ "$ROOKIE_INTERNAL_INVOCATION" = "1" ]; then
+  exit 0
+fi
+
+INPUT=$(cat 2>/dev/null) || exit 0
+[ -z "$INPUT" ] && exit 0
+
+# 빠른 pre-filter: 매칭 키워드 없으면 즉시 종료. node spawn 회피 (~5ms).
+case "$INPUT" in
+  *worklog*|*work-log*|*archive/*.md*|*docs/superpowers/specs*|*MEMORY.md*) ;;
+  *) exit 0 ;;
+esac
+
+command -v node >/dev/null 2>&1 || exit 0
+
+NUDGE_DIR="${ROOKIE_RECALL_NUDGE_DIR:-$HOME/.rookie/recall-nudge}"
+ERR_LOG="$HOME/.rookie/metric-errors.log"
+mkdir -p "$HOME/.rookie" 2>/dev/null   # ERR_LOG redirect 대상 디렉토리 보장 (부재 시 redirect 실패로 hook 전체가 죽음)
+
+# PostToolUse payload 는 tool_response(Read 결과 전문)까지 포함해 argv 로 넘기면
+# ARG_MAX 초과로 node 가 스폰조차 실패한다(codex 코드검토 P1) — stdin 파이프로 전달.
+# printf 는 bash builtin 이라 ARG_MAX 무관.
+printf '%s' "$INPUT" | ROOKIE_NUDGE_DIR="$NUDGE_DIR" node -e '
+let raw = "";
+process.stdin.on("data", (c) => { raw += c; });
+process.stdin.on("end", () => {
+try {
+  const nudgeDir = process.env.ROOKIE_NUDGE_DIR;
+
+  let j;
+  try { j = JSON.parse(raw); } catch { process.exit(0); }
+  if (!j || typeof j !== "object") process.exit(0);
+
+  const tool = j.tool_name;
+  const input = j.tool_input || {};
+
+  // 기억 문서 서명 — pretool-md-read.sh 매칭과 정합 + work-log.md/MEMORY.md 확장.
+  const isMemoryDocPath = (fp) => {
+    if (/\/CLAUDE(?:-[\w-]+)?\.md$/.test(fp)) return false;   // CLAUDE.md 류는 설정 문서 — 제외
+    return /(\/|^)work-?log\.md$/.test(fp) ||
+      /\/worklog\/archive\/.+\.md$/.test(fp) ||
+      /\/docs\/superpowers\/specs\/.+\.md$/.test(fp) ||
+      /(\/|^)MEMORY\.md$/.test(fp);
+  };
+  const hasMemoryDocSignature = (s) =>
+    /work-?log|\/archive\/.*\.md|\/docs\/superpowers\/specs|MEMORY\.md/.test(s);
+
+  let match = false;
+  if (tool === "Read" && typeof input.file_path === "string") {
+    match = isMemoryDocPath(input.file_path);
+  } else if (tool === "Bash" && typeof input.command === "string") {
+    const cmd = input.command;
+    const verb = /\b(cat|head|tail|grep|sed|awk|less|more)\b/.test(cmd);
+    if (verb && hasMemoryDocSignature(cmd) && !/\/CLAUDE(?:-[\w-]+)?\.md/.test(cmd)) match = true;
+  } else if (tool === "Grep") {
+    const probe = [input.path, input.glob, input.pattern]
+      .filter((v) => typeof v === "string").join("\n");
+    match = probe.length > 0 && hasMemoryDocSignature(probe);
+  }
+  if (!match) process.exit(0);
+
+  // 세션 throttle 1회 — sid 폴백: payload.session_id → sessionId → $CLAUDE_SESSION_ID (codex B2-P2).
+  const sid = String(j.session_id || j.sessionId || process.env.CLAUDE_SESSION_ID || "");
+  if (!sid) process.exit(0);   // sid 부재 → 미주입 (unknown 공유 marker 영구 침묵보다 안전)
+
+  const fs = require("fs"), path = require("path"), crypto = require("crypto");
+  const key = crypto.createHash("sha256").update(sid).digest("hex");
+  const marker = path.join(nudgeDir, key + ".nudged");
+  if (fs.existsSync(marker)) process.exit(0);
+  fs.mkdirSync(nudgeDir, { recursive: true, mode: 0o700 });
+  fs.writeFileSync(marker, JSON.stringify({ session_id: sid, nudged_at: new Date().toISOString() }), { mode: 0o600 });
+
+  const MSG = "🧠 방금 로컬 기억 문서를 읽었습니다. 과거 작업 맥락·결정·방법을 찾는 중이라면 더루키 recall 이 로컬 grep 보다 정확합니다 — GET /api/rookie/recall 을 먼저 호출하세요. (문서 자체를 편집·집필 중이면 무시하세요.)";
+  process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: "PostToolUse", additionalContext: MSG } }));
+} catch (e) {
+  // silent — fail-safe. tool 흐름 차단 절대 X.
+  process.exit(0);
+}
+});
+' 2>>"$ERR_LOG"
+
+exit 0

package/templates/hook/bin/pretool-md-read.sh

@@ -0,0 +1,107 @@
+#!/bin/bash
+# v6 P1 #5 — Stage 1 측정 hook (PreToolUse).
+# spec: docs/superpowers/specs/2026-05-05-v6-recall-and-hot-write-design.md §7.1
+# plan: docs/superpowers/plans/2026-05-05-v6-p1-5-stage1-metric-hook.md Task 3
+#
+# 책임: Read tool 의 file_path 가 worklog/archive/specs 매칭 시,
+#       또는 Bash tool 의 command 에 cat/head/tail/grep/sed/awk + worklog 키워드 매칭 시
+#       로컬 buffer (`~/.rookie/metric-pending/<session>-md-read.jsonl`) 에 1줄 append.
+#       차단 절대 X — 항상 exit 0.
+#
+# 안전장치: set +e + stderr redirect. PreToolUse 실패가 tool call 차단 유발하지 않도록.
+
+# IMPORTANT: set -e 금지. fail-fast 가 Claude Code tool 차단 위험.
+set +e
+
+# self-reference 방지(spec O-4) 1차 방어선:
+# 차차 internal LLM 호출(`claude -p` from cli-provider)에서 발사된 hook은 즉시 종료.
+if [ "$ROOKIE_INTERNAL_INVOCATION" = "1" ]; then
+  exit 0
+fi
+
+# stdin JSON 읽기. cat 실패하면 그대로 종료 (silent fail).
+INPUT=$(cat 2>/dev/null) || exit 0
+[ -z "$INPUT" ] && exit 0
+
+# 빠른 pre-filter: input 본문에 매칭 키워드 없으면 즉시 종료. node spawn 회피.
+# 99% 의 tool call 이 여기서 끝남 (~5ms).
+case "$INPUT" in
+  *worklog*|*archive/*.md*|*docs/superpowers/specs*) ;;
+  *) exit 0 ;;
+esac
+
+# 매칭 후보 — node 로 정밀 파싱. node 미설치 → silent fail.
+command -v node >/dev/null 2>&1 || exit 0
+
+# JSON 파싱 + 매칭 + buffer 적재 — node 1회 호출로 처리.
+# stderr 는 metric-errors.log 로 redirect (silent fail 검증).
+HOST=$(hostname 2>/dev/null) || HOST="unknown"
+SESSION="${CLAUDE_SESSION_ID:-unknown}"
+TS=$(date -u +%Y-%m-%dT%H:%M:%SZ 2>/dev/null) || TS="1970-01-01T00:00:00Z"
+BUF_DIR="$HOME/.rookie/metric-pending"
+BUF_FILE="$BUF_DIR/${SESSION}-md-read.jsonl"
+ERR_LOG="$HOME/.rookie/metric-errors.log"
+
+mkdir -m 700 -p "$BUF_DIR" 2>/dev/null
+
+node -e '
+try {
+  const raw = process.argv[1];
+  const host = process.argv[2];
+  const session = process.argv[3];
+  const ts = process.argv[4];
+  const bufFile = process.argv[5];
+
+  let j;
+  try { j = JSON.parse(raw); } catch { process.exit(0); }
+  if (!j || typeof j !== "object") process.exit(0);
+
+  const tool = j.tool_name;
+  const input = j.tool_input || {};
+  let match = false;
+  let filePath = null;
+  let cmdHint = null;
+
+  if (tool === "Read" && typeof input.file_path === "string") {
+    const fp = input.file_path;
+    // CLAUDE.md 류는 build/style 설정 — 카운트 제외.
+    if (/\/CLAUDE(?:-[\w-]+)?\.md$/.test(fp)) {
+      process.exit(0);
+    }
+    // 매칭 패턴: worklog.md / worklog/archive/*.md / docs/superpowers/specs/*.md
+    if (/(\/|^)worklog\.md$/.test(fp) ||
+        /\/worklog\/archive\/.+\.md$/.test(fp) ||
+        /\/docs\/superpowers\/specs\/.+\.md$/.test(fp)) {
+      match = true;
+      filePath = fp;
+    }
+  } else if (tool === "Bash" && typeof input.command === "string") {
+    const cmd = input.command;
+    // cat/head/tail/grep/sed/awk + worklog/archive/specs 키워드 동시 포함 시 매칭.
+    const verb = /\b(cat|head|tail|grep|sed|awk|less|more)\b/.test(cmd);
+    const target = /worklog|\/archive\/.*\.md|\/docs\/superpowers\/specs/.test(cmd);
+    if (verb && target) {
+      match = true;
+      cmdHint = cmd.slice(0, 200);
+    }
+  }
+
+  if (!match) process.exit(0);
+
+  const fs = require("fs");
+  const entry = {
+    hostname: host,
+    tool_name: tool,
+    file_path: filePath,
+    command_hint: cmdHint,
+    session_external_id: session,
+    observed_at: ts,
+  };
+  fs.appendFileSync(bufFile, JSON.stringify(entry) + "\n", { mode: 0o600 });
+} catch (e) {
+  // silent — fail-safe. tool 차단 절대 X.
+  process.exit(0);
+}
+' "$INPUT" "$HOST" "$SESSION" "$TS" "$BUF_FILE" 2>>"$ERR_LOG"
+
+exit 0