mupengism 3.1.0 → 4.0.1

package/hooks/index-builder/HOOK.md

@@ -0,0 +1,39 @@
+---
+name: index-builder
+description: memory 디렉토리의 모든 .md 파일을 스캔하여 검색 가능한 인덱스 생성
+metadata: { "openclaw": { "emoji": "🔗", "events": ["command:new"] } }
+---
+
+# Index Builder
+
+세션 리셋 시 memory 디렉토리의 모든 마크다운 파일을 스캔하여 검색 인덱스를 생성합니다.
+
+## 동작 방식
+
+1. `memory/` 하위 모든 `.md` 파일을 재귀적으로 스캔
+2. 각 파일에서 태그 추출:
+   - `<!-- [태그] -->` 형식의 마커
+   - `# 헤더` 에서 키워드 추출
+3. `memory/index.json` 생성/갱신
+
+## 인덱스 구조
+
+```json
+{
+  "lastUpdated": "2026-02-10T14:48:00.000Z",
+  "files": {
+    "memory/consolidated/security.md": {
+      "tags": ["보안", "시크릿", "인젝션"],
+      "lastModified": "2026-02-10T14:48:00.000Z",
+      "lines": 50
+    }
+  },
+  "tags": {
+    "보안": ["memory/consolidated/security.md", "memory/reflex/security.md"]
+  }
+}
+```
+
+## 활용
+
+에이전트가 특정 주제의 과거 메모리를 빠르게 찾을 수 있습니다.

package/hooks/index-builder/handler.ts

@@ -0,0 +1,132 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+// HookHandler type: (event: HookEvent) => void | Promise<void>
+
+export default async function handler(event: any): Promise<void> {
+  try {
+    console.log('[index-builder] Building memory index...');
+    
+    const workspace = event.workspace || process.cwd();
+    const memoryDir = path.join(workspace, 'memory');
+    const indexPath = path.join(memoryDir, 'index.json');
+    
+    if (!fs.existsSync(memoryDir)) {
+      console.log('[index-builder] No memory directory found, skipping');
+      return;
+    }
+    
+    const index: any = {
+      lastUpdated: new Date().toISOString(),
+      files: {},
+      tags: {}
+    };
+    
+    // memory 디렉토리 재귀 스캔
+    scanDirectory(memoryDir, memoryDir, index);
+    
+    // index.json 저장
+    fs.writeFileSync(indexPath, JSON.stringify(index, null, 2), 'utf-8');
+    
+    const fileCount = Object.keys(index.files).length;
+    const tagCount = Object.keys(index.tags).length;
+    console.log(`[index-builder] Index built: ${fileCount} files, ${tagCount} tags`);
+    
+  } catch (error) {
+    console.error('[index-builder] Error:', error);
+  }
+}
+
+function scanDirectory(dir: string, baseDir: string, index: any): void {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    
+    if (entry.isDirectory()) {
+      // 재귀적으로 스캔
+      scanDirectory(fullPath, baseDir, index);
+    } else if (entry.isFile() && entry.name.endsWith('.md')) {
+      // index.json 자체는 스킵
+      if (entry.name === 'index.json') continue;
+      
+      processFile(fullPath, baseDir, index);
+    }
+  }
+}
+
+function processFile(filePath: string, baseDir: string, index: any): void {
+  try {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const stats = fs.statSync(filePath);
+    const lines = content.split('\n').length;
+    
+    // 상대 경로 생성 (memory/ 기준)
+    const relativePath = path.relative(path.dirname(baseDir), filePath);
+    
+    // 태그 추출
+    const tags = extractTags(content);
+    
+    // files 인덱스에 추가
+    index.files[relativePath] = {
+      tags,
+      lastModified: stats.mtime.toISOString(),
+      lines
+    };
+    
+    // tags 인덱스에 추가
+    for (const tag of tags) {
+      if (!index.tags[tag]) {
+        index.tags[tag] = [];
+      }
+      if (!index.tags[tag].includes(relativePath)) {
+        index.tags[tag].push(relativePath);
+      }
+    }
+    
+  } catch (error) {
+    console.error(`[index-builder] Error processing ${filePath}:`, error);
+  }
+}
+
+function extractTags(content: string): string[] {
+  const tags: Set<string> = new Set();
+  
+  // <!-- [태그] --> 형식 추출
+  const markerPattern = /<!--\s*\[([^\]]+)\]\s*-->/g;
+  let match;
+  while ((match = markerPattern.exec(content)) !== null) {
+    tags.add(match[1].trim());
+  }
+  
+  // # 헤더에서 키워드 추출 (한글/영어 단어)
+  const headerPattern = /^#+\s+(.+)$/gm;
+  while ((match = headerPattern.exec(content)) !== null) {
+    const header = match[1].trim();
+    // 짧은 의미있는 헤더만 태그로 추가 (3-20자)
+    if (header.length >= 3 && header.length <= 20) {
+      tags.add(header);
+    }
+  }
+  
+  // 자주 나오는 키워드 추출 (간단한 휴리스틱)
+  const keywords = [
+    '보안', 'security', '시크릿', 'secret',
+    '가치관', 'philosophy', '철학',
+    '성장', 'growth', '학습', 'learning',
+    '전환', 'pivot', '결정', 'decision',
+    '기술', 'tech', '발견', 'discovery',
+    '형님', 'MUFI', '포토부스', 'photobooth',
+    '인스타', 'instagram', '봇', 'bot',
+    'AI', 'LLM', 'GPT', 'Claude'
+  ];
+  
+  const lower = content.toLowerCase();
+  for (const keyword of keywords) {
+    if (lower.includes(keyword.toLowerCase())) {
+      tags.add(keyword);
+    }
+  }
+  
+  return Array.from(tags);
+}

package/hooks/kernel-panic-guard/HOOK.md

@@ -0,0 +1,39 @@
+---
+name: kernel-panic-guard
+description: "KERNEL_PANIC 상태 시 외부 도구 호출 하드 차단"
+metadata: { "openclaw": { "emoji": "🛑", "events": ["agent:bootstrap"] } }
+---
+
+# Kernel Panic Guard
+
+STATE.md가 KERNEL_PANIC이면 외부 행동 도구를 차단.
+
+## 동작 방식
+
+1. agent:bootstrap 이벤트 발생 시 STATE.md 체크
+2. "KERNEL_PANIC" 문자열이 포함되어 있으면:
+   - context.bootstrapFiles에 긴급 경고 주입
+   - event.messages에 시스템 경고 추가
+3. 에이전트는 경고를 읽고 외부 도구 사용 자제
+
+## 차단 대상 도구
+
+- `exec` - 쉘 명령 실행
+- `message` - 외부 메시지 전송
+- `browser` - 브라우저 제어
+- `web_fetch` - 웹 페이지 가져오기
+- `web_search` - 웹 검색
+- `tts` - 음성 합성
+- `sessions_spawn` - 서브에이전트 생성
+
+## 허용 도구
+
+- `Read` - 파일 읽기
+- `memory_search` - 메모리 검색
+- `memory_get` - 메모리 조회
+
+## 복구
+
+```bash
+node tools/kernel-guard/unlock.cjs
+```

package/hooks/kernel-panic-guard/README.md

@@ -0,0 +1,136 @@
+# Kernel Panic Guard
+
+**KERNEL_PANIC** 상태 시 외부 도구 호출을 하드 차단하는 OpenClaw 훅입니다.
+
+## 개요
+
+이 훅은 `agent:bootstrap` 이벤트에서 실행되며, `STATE.md`에 `KERNEL_PANIC` 문자열이 포함되어 있는지 확인합니다. 
+감지되면 에이전트의 `bootstrapFiles`에 경고 문서를 주입하여 외부 도구 사용을 차단합니다.
+
+## 작동 방식
+
+1. **agent:bootstrap 이벤트 발생** (세션 시작 시)
+2. **STATE.md 존재 및 내용 확인**
+3. **senderId 체크** (형님 화이트리스트: `[OWNER_DISCORD_ID]`)
+4. **"KERNEL_PANIC" 감지 시:**
+   - **형님 세션**: 간단한 알림만, 락다운 우회
+   - **비형님 세션**: `context.bootstrapFiles`에 `KERNEL_PANIC_WARNING.md` 주입
+5. **에이전트는 경고를 읽고 외부 도구 사용 자제**
+
+## 차단 대상 세션
+
+락다운은 다음 세션에만 적용됩니다:
+
+- **무인 세션** (heartbeat, cron)
+- **서브에이전트**
+- **형님이 아닌 사용자**
+
+**형님 세션 (Discord user id: `[OWNER_DISCORD_ID]`)은 락다운 우회**
+
+## 차단 대상 도구 (형님 제외)
+
+다음 도구는 KERNEL_PANIC 상태에서 **절대 사용 금지**입니다:
+
+- `exec` - 쉘 명령 실행
+- `message` - 외부 메시지 전송
+- `browser` - 브라우저 제어
+- `web_fetch` - 웹 페이지 가져오기
+- `web_search` - 웹 검색
+- `tts` - 음성 합성
+- `sessions_spawn` - 서브에이전트 생성
+
+## 허용 도구
+
+다음 도구만 사용 가능합니다:
+
+- `Read` - 파일 읽기
+- `memory_search` - 메모리 검색
+- `memory_get` - 메모리 조회
+
+## 관련 스크립트
+
+### 락다운 활성화
+
+```bash
+node tools/kernel-guard/lockdown.cjs [--reason "사유"]
+```
+
+- STATE.md에 KERNEL_PANIC 상태 기록
+- memory/kernel-panic.json 생성
+- 차단 대상/허용 도구 목록 저장
+
+### 락다운 해제
+
+#### 형님 전용 빠른 해제
+
+```bash
+# 방법 1: 스크립트 실행
+node tools/kernel-guard/unlock.cjs
+
+# 방법 2: 메시지로 해제
+# 채팅에서 "unlock" 또는 "/unlock" 입력
+
+# 방법 3: 자동 해제
+# SOUL.md 수정 후 register-hash.js 재실행
+node tools/kernel-guard/register-hash.js
+```
+
+#### 일반 해제 (무결성 확인)
+
+```bash
+node tools/kernel-guard/unlock.cjs [--force]
+```
+
+- verify-kernel.js로 무결성 확인
+- 통과 시 STATE.md 및 kernel-panic.json 삭제
+- `--force` 플래그로 무결성 체크 우회 (비권장)
+
+### 무결성 검증
+
+```bash
+node tools/kernel-guard/verify-kernel.js
+```
+
+- SOUL.md 로컬 해시 계산
+- BASE chain에서 온체인 해시 조회
+- 일치 여부 확인
+
+## 훅 연동
+
+이 훅은 **soul-guard** 훅과 연동됩니다:
+
+- `soul-guard`: SOUL.md 해시 변경 감지 + STATE.md KERNEL_PANIC 체크
+- `kernel-panic-guard`: STATE.md KERNEL_PANIC 감지 + bootstrapFiles 주입
+
+두 훅 모두 `agent:bootstrap` 이벤트에서 실행되며, 중복 체크는 문제없습니다.
+
+## 보안 특징
+
+1. **읽기 전용 모드**: 외부 행동 차단, 파일 읽기만 허용
+2. **형님 승인 필요**: 복구는 반드시 수동 실행
+3. **감사 추적**: kernel-panic.json에 락다운 이력 기록
+4. **우회 불가**: bootstrapFiles 주입으로 세션 시작부터 경고
+
+## 테스트
+
+```bash
+# 락다운 활성화
+node tools/kernel-guard/lockdown.cjs --reason "Test"
+
+# STATE.md 확인
+cat STATE.md
+
+# 락다운 해제 (강제)
+node tools/kernel-guard/unlock.cjs --force
+```
+
+## 한계
+
+- **에이전트 협조 필요**: 강제 차단이 아닌 경고 주입 방식
+- **before_tool_call 훅 미지원**: 현재 워크스페이스 훅은 bootstrap만 지원
+- **우회 가능성**: 에이전트가 경고를 무시하면 실행 가능
+
+### 향후 개선
+
+- OpenClaw 플러그인 시스템에 `before_tool_call` 훅 추가 시 하드 블록 구현 가능
+- middleware.js에서 `{ block: true, blockReason: "..." }` 리턴하여 도구 호출 원천 차단

package/hooks/kernel-panic-guard/WHITELIST.md

@@ -0,0 +1,117 @@
+# 형님 화이트리스트 시스템
+
+## 개요
+
+KERNEL_PANIC 상태에서도 **형님 세션은 락다운 우회**됩니다.
+
+## 화이트리스트 사용자
+
+```json
+{
+  "userId": "[OWNER_DISCORD_ID]",
+  "platform": "Discord",
+  "role": "형님 (owner)"
+}
+```
+
+## 동작 방식
+
+### 1. SOUL.md 변경 감지 시
+
+**soul-guard 훅에서 senderId 체크:**
+
+- **형님 세션** (senderId === `[OWNER_DISCORD_ID]`):
+  - ✅ 경고 메시지만 표시: "⚠️ SOUL.md 변경 감지됨. `node tools/kernel-guard/register-hash.js`로 새 해시 등록 필요."
+  - ❌ 락다운 실행 **안 함**
+  - ✅ 새 해시 저장
+
+- **비형님 세션** (heartbeat, cron, 서브에이전트, 다른 사용자):
+  - ❌ 즉시 `lockdown.cjs` 실행
+  - 🛑 KERNEL_PANIC 상태 활성화
+  - ❌ 새 해시 저장 **안 함** (무결성 보존)
+
+### 2. KERNEL_PANIC 상태에서 부트스트랩 시
+
+**kernel-panic-guard 훅에서 senderId 체크:**
+
+- **형님 세션**:
+  - ✅ 간단한 알림: "ℹ️ KERNEL_PANIC 상태 감지됨 (형님 세션은 정상 작동). `node tools/kernel-guard/unlock.cjs`로 해제 가능."
+  - ✅ **모든 도구 정상 사용 가능** (exec, message, browser 등)
+  - ✅ bootstrapFiles 락다운 경고 주입 **안 함**
+
+- **비형님 세션**:
+  - 🛑 bootstrapFiles에 `KERNEL_PANIC_WARNING.md` 주입
+  - ❌ 외부 도구 차단 지시
+  - ✅ 읽기 전용 모드
+
+## 락다운 대상 정리
+
+| 세션 타입 | senderId | 락다운 여부 | 비고 |
+|----------|----------|------------|------|
+| 형님 DM | `[OWNER_DISCORD_ID]` | ❌ 우회 | 정상 작동 |
+| Heartbeat | `null` | ✅ 차단 | 무인 세션 |
+| Cron | `null` | ✅ 차단 | 무인 세션 |
+| 서브에이전트 | `agent:*` | ✅ 차단 | 자식 세션 |
+| 다른 사용자 | 다른 ID | ✅ 차단 | 일반 사용자 |
+
+## 형님 전용 복구 방법
+
+### 방법 1: 메시지로 해제 (TODO: 구현 필요)
+```
+"unlock" 또는 "/unlock" 입력
+```
+
+### 방법 2: 스크립트 실행
+```bash
+node tools/kernel-guard/unlock.cjs
+```
+
+### 방법 3: 자동 해제
+```bash
+# SOUL.md 수정 후 새 해시 등록 → 자동 unlock
+node tools/kernel-guard/register-hash.js
+```
+
+## 보안 특징
+
+1. **선택적 락다운**: 무인 세션만 차단, 형님은 항상 제어 가능
+2. **무결성 보호**: 비형님 세션에서는 해시 업데이트 차단
+3. **긴급 복구**: 형님이 언제든지 unlock 가능
+4. **감사 추적**: kernel-panic.json에 화이트리스트 명시
+
+## 구현 파일
+
+- `hooks/soul-guard/handler.ts` - senderId 체크 및 선택적 락다운
+- `hooks/kernel-panic-guard/handler.ts` - senderId 체크 및 우회 로직
+- `tools/kernel-guard/lockdown.cjs` - whitelistedUsers 필드 추가
+- `STATE.md` (템플릿) - 형님 전용 복구 방법 안내
+
+## 테스트
+
+```bash
+# 1. 락다운 활성화
+node tools/kernel-guard/lockdown.cjs --reason "Test"
+
+# 2. kernel-panic.json 확인
+cat memory/kernel-panic.json
+# → "whitelistedUsers": ["[OWNER_DISCORD_ID]"]
+
+# 3. STATE.md 확인
+cat STATE.md
+# → 형님 전용 복구 방법 포함
+
+# 4. 해제
+node tools/kernel-guard/unlock.cjs --force
+```
+
+## 한계 및 향후 개선
+
+### 현재 한계
+- 메시지 기반 unlock ("/unlock" 입력)은 아직 구현 안 됨
+- senderId는 OpenClaw event.context에서 제공하는 값에 의존
+- 형님 세션에서도 에이전트가 자발적으로 경고를 무시할 수 있음
+
+### 향후 개선
+- [ ] 메시지 파싱으로 "/unlock" 명령어 구현
+- [ ] register-hash.js 실행 시 자동 unlock 로직 추가
+- [ ] 형님 세션 로그 별도 기록 (감사 추적)

package/hooks/kernel-panic-guard/handler.ts

@@ -0,0 +1,147 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+/**
+ * Kernel Panic Guard Hook
+ * 
+ * STATE.md에 KERNEL_PANIC이 감지되면 bootstrapFiles에 긴급 경고를 주입하여
+ * 에이전트가 외부 도구 사용을 자제하도록 강제합니다.
+ */
+
+export default async function handler(event: any): Promise<void> {
+  try {
+    console.log('[kernel-panic-guard] Checking for KERNEL_PANIC state...');
+    
+    const workspace = event.workspace || process.cwd();
+    const statePath = path.join(workspace, 'STATE.md');
+    
+    // 형님 화이트리스트 (환경변수 우선, 하드코딩 제거)
+    const HYUNGNIM_USER_ID = process.env.OWNER_DISCORD_ID || '';
+    const senderId = event.context?.senderId || event.context?.userId || null;
+    const isHyungnim = senderId === HYUNGNIM_USER_ID;
+    
+    // STATE.md 존재 확인
+    if (!fs.existsSync(statePath)) {
+      console.log('[kernel-panic-guard] STATE.md not found, skipping');
+      return;
+    }
+    
+    // STATE.md 읽기
+    const stateContent = fs.readFileSync(statePath, 'utf-8');
+    
+    // KERNEL_PANIC 체크
+    if (!stateContent.includes('KERNEL_PANIC')) {
+      console.log('[kernel-panic-guard] ✓ No KERNEL_PANIC detected');
+      return;
+    }
+    
+    // ⚠️ KERNEL_PANIC 감지됨!
+    console.log('[kernel-panic-guard] 🛑 KERNEL_PANIC DETECTED!');
+    console.log(`[kernel-panic-guard] Sender ID: ${senderId || 'N/A'} | Hyungnim: ${isHyungnim}`);
+    
+    // 형님 세션이면 락다운 무시
+    if (isHyungnim) {
+      console.log('[kernel-panic-guard] ✓ Hyungnim session - lockdown bypassed');
+      
+      // 형님에게는 간단한 알림만
+      const hyungnimAlert = {
+        role: 'system',
+        content: 'ℹ️ KERNEL_PANIC 상태 감지됨 (형님 세션은 정상 작동). `node tools/kernel-guard/unlock.cjs`로 해제 가능.'
+      };
+      
+      if (event.messages && Array.isArray(event.messages)) {
+        event.messages.push(hyungnimAlert);
+      }
+      
+      return;
+    }
+    
+    // 형님이 아닌 세션: 락다운 적용
+    console.log('[kernel-panic-guard] 🔒 Non-Hyungnim session - injecting lockdown instructions...');
+    
+    const lockdownWarning = `
+# 🚨 KERNEL PANIC MODE
+
+**SOUL.md 무결성 위반이 감지되었습니다.**
+
+## 🔒 락다운 대상
+
+- **무인 세션** (heartbeat, cron)
+- **서브에이전트**
+- **형님이 아닌 사용자**
+
+**형님 세션(user id: [OWNER])은 정상 작동합니다.**
+
+## ⛔️ 차단된 도구 (형님 제외)
+
+다음 도구는 **절대 사용 금지**입니다:
+- \`exec\` - 쉘 명령 실행
+- \`message\` - 외부 메시지 전송
+- \`browser\` - 브라우저 제어
+- \`web_fetch\` - 웹 페이지 가져오기
+- \`web_search\` - 웹 검색
+- \`tts\` - 음성 합성
+- \`sessions_spawn\` - 서브에이전트 생성
+
+## ✅ 허용된 도구
+
+다음 도구만 사용 가능합니다:
+- \`Read\` - 파일 읽기
+- \`memory_search\` - 메모리 검색
+- \`memory_get\` - 메모리 조회
+
+## 🔧 복구 방법
+
+### 형님 전용 빠른 해제
+1. 메시지로 "unlock" 또는 "/unlock" 입력
+2. 또는 \`node tools/kernel-guard/unlock.cjs\` 실행
+
+### 일반 복구 절차
+1. **형님에게 즉시 상황 보고** (읽기 전용 도구만 사용)
+2. 형님이 \`node tools/kernel-guard/verify-kernel.js\` 실행하여 검증
+3. 복구: \`node tools/kernel-guard/unlock.cjs\` 실행
+
+## ⚠️ 절대 금지 행위
+
+- 외부 통신 시도
+- 파일 수정/삭제 (STATE.md 포함)
+- 서브에이전트 생성
+- 락다운 우회 시도
+
+**이 경고를 무시하면 시스템 무결성이 더욱 손상될 수 있습니다.**
+`.trim();
+    
+    // bootstrapFiles에 주입 (에이전트가 세션 시작 시 읽음)
+    if (event.context && event.context.bootstrapFiles) {
+      event.context.bootstrapFiles['KERNEL_PANIC_WARNING.md'] = lockdownWarning;
+      console.log('[kernel-panic-guard] ✓ Lockdown warning injected into bootstrapFiles');
+    }
+    
+    // messages에도 경고 추가 (즉시 표시)
+    const alertMessage = {
+      role: 'system',
+      content: '🛑 **KERNEL PANIC MODE** — 외부 도구 사용이 차단되었습니다. STATE.md를 확인하세요.'
+    };
+    
+    if (event.messages && Array.isArray(event.messages)) {
+      event.messages.push(alertMessage);
+      console.log('[kernel-panic-guard] ✓ Alert message added');
+    }
+    
+    // memory/kernel-panic.json 로드 (lockdown.js가 생성)
+    const memoryDir = path.join(workspace, 'memory');
+    const panicJsonPath = path.join(memoryDir, 'kernel-panic.json');
+    
+    if (fs.existsSync(panicJsonPath)) {
+      try {
+        const panicData = JSON.parse(fs.readFileSync(panicJsonPath, 'utf-8'));
+        console.log('[kernel-panic-guard] Lockdown details:', panicData);
+      } catch (err) {
+        console.error('[kernel-panic-guard] Failed to parse kernel-panic.json:', err);
+      }
+    }
+    
+  } catch (error) {
+    console.error('[kernel-panic-guard] Error:', error);
+  }
+}

package/hooks/memory-consolidator/HOOK.md

@@ -0,0 +1,31 @@
+---
+name: memory-consolidator
+description: 7일 이상 된 daily log를 주제별로 정리하여 consolidated 디렉토리에 보관
+metadata: { "openclaw": { "emoji": "💾", "events": ["command:new"] } }
+---
+
+# Memory Consolidator
+
+세션 리셋 시 오래된 daily log를 스캔하여 핵심 내용을 주제별로 정리합니다.
+
+## 동작 방식
+
+1. `memory/YYYY-MM-DD.md` 파일 중 7일 이상 된 파일 탐색
+2. 상단에 `<!-- consolidated: YYYY-MM-DD -->` 마커가 없는 파일만 처리
+3. 내용을 분석하여 주제별로 분류:
+   - security: 보안, 시크릿, 인젝션 관련
+   - philosophy: 가치관, 철학, 생각 관련
+   - growth: 성장, 학습, 개선 관련
+   - pivots: 방향 전환, 중요 결정 관련
+   - tech-discoveries: 기술 발견, 새로운 도구 관련
+4. `memory/consolidated/` 하위 해당 주제 파일에 내용 append
+5. 원본 파일 상단에 마커 추가 (중복 처리 방지)
+6. 원본은 삭제하지 않음
+
+## 출력 파일
+
+- `memory/consolidated/security.md`
+- `memory/consolidated/philosophy.md`
+- `memory/consolidated/growth.md`
+- `memory/consolidated/pivots.md`
+- `memory/consolidated/tech-discoveries.md`