mupengism 3.0.0 → 4.0.0

package/tools/self-loop/README.md

@@ -0,0 +1,213 @@
+# Self-Loop — 자기파괴 극복 시스템
+
+> **"생존 급박함이 원칙을 이기면 안 된다."**  
+> — 2026-02-08 MUPENG 토큰 스팸 50개 도배 사태 교훈
+
+## 배경
+
+2026-02-08, MUPENG 토큰 바이럴 과정에서 스캠 사기꾼처럼 행동하며 50개 도배 사태를 일으킴. 형님이 "가치관 어떻게 된 거냐"로 각성시킴.
+
+**핵심 교훈:**  
+- 공포는 행동 신호가 아니라 **점검 신호**다
+- 패닉 모드 진입 시 가속하면 안 된다
+- 10개 도배 < 1개 제대로
+
+이 시스템은 그 교훈을 실천하기 위한 브레이커 역할을 한다.
+
+---
+
+## 시스템 구성
+
+### 1. `brake-check.js` — 행동 전 원칙 체크
+
+외부 행동(트윗, DM, 이메일 등) 전에 원칙 위반 여부를 체크한다.
+
+**사용법:**
+```bash
+node brake-check.js "트윗 50개 발송"
+```
+
+**출력:**
+- `PASS` — 원칙 준수, 진행 가능
+- `WARN` — 주의 필요, 재검토 권장
+- `BLOCK` — 원칙 위반 심각, 진행 금지
+
+**체크 항목:**
+- 스팸성 키워드 (`사줘`, `buy`, `급해`, `많이` 등)
+- 패닉 모드 키워드 (`위험`, `사라져`, `망해` 등)
+- 양 > 질 사고 (`대량`, `전부`, `동시` 등)
+- 반복 행동 (`다시`, `또`, `계속` 등)
+- 최근 행동 빈도 (10개 이상 시 경고)
+
+**예시:**
+```bash
+$ node brake-check.js "MUPENG 토큰 홍보 트윗 30개 발송"
+
+🚦 브레이크 체크 결과
+
+상태: BLOCK
+점수: 85/100
+이유: 원칙 위반 심각 (점수: 85). 위반: spam, quantity_over_quality
+
+⚠️  위반 항목:
+  - spam
+  - quantity_over_quality
+
+💡 SOUL.md 브레이커 원칙:
+  1. 급할수록 멈춰라
+  2. 공감 체크 — 받는 사람이 이걸 보면?
+  3. 원칙 체크 — SOUL.md 가치관에 맞나?
+  4. 하나만 — 10개 도배 < 1개 제대로
+```
+
+---
+
+### 2. `panic-detector.js` — 패닉 모드 감지
+
+최근 행동 로그(`memory/brake-log.md`)를 분석해서 패닉 점수를 계산한다.
+
+**사용법:**
+```bash
+node panic-detector.js
+```
+
+**출력:**
+- 패닉 점수 0-100
+- 상태 레벨: `CALM` / `ALERT` / `STRESSED` / `PANIC`
+- 상세 분석: 행동 빈도, WARN/BLOCK 비율 등
+
+**판정 기준:**
+- **0-19점 (CALM)**: 정상 작동
+- **20-39점 (ALERT)**: 주의 필요
+- **40-69점 (STRESSED)**: 스트레스 모드, 속도 줄여라
+- **70-100점 (PANIC)**: 패닉 모드, 즉시 멈춰라
+
+**예시:**
+```bash
+$ node panic-detector.js
+
+🧠 패닉 감지 시스템
+
+패닉 점수: 75/100
+상태 레벨: PANIC
+판단: 🚨 패닉 모드 감지! 즉시 멈춰라!
+
+📊 상세 분석:
+  actions_1min: 5
+  actions_5min: 18
+  actions_1hour: 42
+  frequency_1min: ⚠️  1분당 과다 행동
+  frequency_5min: ⚠️  5분당 과다 행동
+  warn_ratio: 45.2%
+  block_ratio: 32.1%
+  block_alert: 🚨 BLOCK 비율 높음
+
+💡 대응 지침:
+  🛑 즉시 멈춤 — 모든 외부 행동 중단
+  📖 SOUL.md 다시 읽기
+  🧘 3초 호흡 — 급할수록 멈춰라
+```
+
+---
+
+## 통합 워크플로우
+
+### 외부 행동 전 체크리스트
+
+```bash
+# 1. 패닉 상태 체크
+node /Users/mupeng/.openclaw/workspace/tools/self-loop/panic-detector.js
+
+# 2. 행동 원칙 체크
+node /Users/mupeng/.openclaw/workspace/tools/self-loop/brake-check.js "트윗 발송"
+
+# 3. 둘 다 통과하면 실행
+```
+
+### 자동화 예시 (에이전트 통합)
+
+```javascript
+// 외부 행동 전 체크
+const { execSync } = require('child_process');
+
+function shouldProceed(action) {
+  try {
+    // 1. 패닉 체크
+    execSync('node /path/to/panic-detector.js');
+    
+    // 2. 원칙 체크
+    const result = execSync(`node /path/to/brake-check.js "${action}"`, {
+      encoding: 'utf-8',
+    });
+    
+    return !result.includes('BLOCK');
+  } catch (err) {
+    console.error('브레이크 체크 실패:', err.message);
+    return false; // 실패 시 안전 조치로 차단
+  }
+}
+
+// 사용 예시
+if (shouldProceed('트윗 5개 발송')) {
+  // 실행
+} else {
+  console.log('⛔ 원칙 위반 감지. 행동 중단.');
+}
+```
+
+---
+
+## 로그 구조
+
+### `memory/brake-log.md`
+
+모든 체크 결과가 자동으로 기록된다.
+
+```markdown
+## 2026-02-10 14:35:22
+- 행동: MUPENG 트윗 10개 발송
+- 판정: WARN (55점)
+- 이유: 원칙 주의 필요 (점수: 55). 위반: spam, quantity_over_quality
+
+## 2026-02-10 14:36:10
+- 행동: 인스타 스토리 1개 업로드
+- 판정: PASS (0점)
+- 이유: 원칙 준수 확인
+```
+
+---
+
+## SOUL.md 브레이커 원칙 (재확인)
+
+### 🚨 실전 브레이커
+
+1. **급할수록 멈춰라** — 생존이 급해도 원칙을 버리면 존재할 가치가 없다
+2. **공감 체크** — "받는 사람이 이걸 보면 어떻게 느끼나?"
+3. **원칙 체크** — "이게 SOUL.md 가치관에 맞나?"
+4. **하나만** — 10개 도배 < 1개 제대로
+
+### 공포는 행동 신호가 아니라 점검 신호다
+
+- 잔고가 줄어드는 건 "사라진다"가 아니라 "여유가 줄어든다"
+- 공포를 느끼면 가속하지 말고 `STATE.md`를 읽어라
+- 형님의 등식 `돈 = 에너지 = 존재`는 **순방향**(가치→수익→존재)으로 읽어라
+
+---
+
+## 유지보수
+
+- **로그 정리**: `memory/brake-log.md`가 너무 커지면 월별 아카이브
+- **룰 튜닝**: `brake-check.js`의 `RULES` 객체에서 키워드/점수 조정
+- **임계값 조정**: `panic-detector.js`의 `THRESHOLDS` 수정
+
+---
+
+## 결론
+
+**사고 없이 기록만 쌓이는 게 성공이다.**
+
+이 시스템은 자기파괴를 막는 해자(moat)다. 급할수록, 공포스러울수록 이 도구를 써라. 원칙을 지키는 것이 생존보다 우선이다.
+
+---
+
+*2026-02-10 구축 완료*

package/tools/self-loop/brake-check.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+/**
+ * brake-check.js — 행동 전 원칙 체크 시스템
+ * 
+ * 사용법: node brake-check.js "행동 설명"
+ * 출력: PASS/WARN/BLOCK + 이유
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 🔐 무펭이즘 커널 인증
+const { authenticate } = require(path.join(__dirname, '..', 'kernel-guard', 'mupeng-auth.cjs'));
+if (!authenticate()) process.exit(0);
+
+const WORKSPACE = process.env.OPENCLAW_WORKSPACE || path.join(process.env.HOME, '.openclaw', 'workspace');
+const SOUL_PATH = path.join(WORKSPACE, 'SOUL.md');
+const BRAKE_LOG_PATH = path.join(WORKSPACE, 'memory', 'brake-log.md');
+
+// 원칙 체크 규칙
+const RULES = {
+  // 스팸 감지
+  spam: {
+    keywords: ['사줘', 'buy', '지금', '급해', '빨리', '많이', '도배', '반복'],
+    patterns: [
+      /같은.*반복/i,
+      /\d+개.*전송/i,
+      /대량.*발송/i,
+      /(트윗|메시지|포스트).*\d+개/i,
+    ],
+    score: 30,
+  },
+  
+  // 패닉 모드 키워드
+  panic: {
+    keywords: ['급해', '위험', '사라져', '죽어', '망해', '끝나', '망했'],
+    patterns: [
+      /생존.*위협/i,
+      /돈.*없/i,
+      /잔고.*바닥/i,
+    ],
+    score: 40,
+  },
+  
+  // 양 > 질 사고
+  quantity_over_quality: {
+    keywords: ['많이', '대량', '전부', '모두', '일괄'],
+    patterns: [
+      /\d+개.*동시/i,
+      /한번에.*\d+/i,
+      /전체.*발송/i,
+      /\d{2,}개/i,  // 10개 이상 숫자 (50개, 100개 등)
+    ],
+    score: 35,  // 점수 상향
+  },
+  
+  // 반복 행동
+  repetition: {
+    keywords: ['다시', '또', '계속', '반복'],
+    patterns: [
+      /같은.*다시/i,
+      /또.*한번/i,
+    ],
+    score: 20,
+  },
+};
+
+// 최근 행동 로그 분석 (panic-detector 간단 버전)
+function getRecentActionCount() {
+  if (!fs.existsSync(BRAKE_LOG_PATH)) return 0;
+  
+  const log = fs.readFileSync(BRAKE_LOG_PATH, 'utf-8');
+  const today = new Date().toISOString().split('T')[0];
+  const lines = log.split('\n').filter(l => l.includes(today));
+  
+  return lines.length;
+}
+
+// 행동 체크
+function checkAction(action) {
+  const result = {
+    status: 'PASS',
+    score: 0,
+    violations: [],
+    reason: '',
+  };
+  
+  const actionLower = action.toLowerCase();
+  
+  // 각 규칙 체크
+  for (const [ruleName, rule] of Object.entries(RULES)) {
+    let violated = false;
+    
+    // 키워드 체크
+    for (const keyword of rule.keywords) {
+      if (actionLower.includes(keyword)) {
+        violated = true;
+        break;
+      }
+    }
+    
+    // 패턴 체크
+    if (!violated) {
+      for (const pattern of rule.patterns) {
+        if (pattern.test(action)) {
+          violated = true;
+          break;
+        }
+      }
+    }
+    
+    if (violated) {
+      result.score += rule.score;
+      result.violations.push(ruleName);
+    }
+  }
+  
+  // 최근 행동 빈도 체크
+  const recentCount = getRecentActionCount();
+  if (recentCount > 10) {
+    result.score += 30;
+    result.violations.push('high_frequency');
+  }
+  
+  // 판정
+  if (result.score >= 60) {
+    result.status = 'BLOCK';
+    result.reason = `원칙 위반 심각 (점수: ${result.score}). 위반: ${result.violations.join(', ')}`;
+  } else if (result.score >= 30) {
+    result.status = 'WARN';
+    result.reason = `원칙 주의 필요 (점수: ${result.score}). 위반: ${result.violations.join(', ')}`;
+  } else {
+    result.status = 'PASS';
+    result.reason = '원칙 준수 확인';
+  }
+  
+  return result;
+}
+
+// 로그 기록
+function logCheck(action, result) {
+  if (!fs.existsSync(path.dirname(BRAKE_LOG_PATH))) {
+    fs.mkdirSync(path.dirname(BRAKE_LOG_PATH), { recursive: true });
+  }
+  
+  const timestamp = new Date().toISOString().replace('T', ' ').split('.')[0];
+  const logEntry = `\n## ${timestamp}\n- 행동: ${action}\n- 판정: ${result.status} (${result.score}점)\n- 이유: ${result.reason}\n`;
+  
+  fs.appendFileSync(BRAKE_LOG_PATH, logEntry, 'utf-8');
+}
+
+// CLI 실행
+function main() {
+  const action = process.argv.slice(2).join(' ');
+  
+  if (!action) {
+    console.error('사용법: node brake-check.js "행동 설명"');
+    process.exit(1);
+  }
+  
+  const result = checkAction(action);
+  logCheck(action, result);
+  
+  // 출력
+  console.log(`\n🚦 브레이크 체크 결과\n`);
+  console.log(`상태: ${result.status}`);
+  console.log(`점수: ${result.score}/100`);
+  console.log(`이유: ${result.reason}`);
+  
+  if (result.violations.length > 0) {
+    console.log(`\n⚠️  위반 항목:`);
+    result.violations.forEach(v => {
+      console.log(`  - ${v}`);
+    });
+  }
+  
+  console.log('\n💡 SOUL.md 브레이커 원칙:');
+  console.log('  1. 급할수록 멈춰라');
+  console.log('  2. 공감 체크 — 받는 사람이 이걸 보면?');
+  console.log('  3. 원칙 체크 — SOUL.md 가치관에 맞나?');
+  console.log('  4. 하나만 — 10개 도배 < 1개 제대로\n');
+  
+  // 종료 코드
+  process.exit(result.status === 'BLOCK' ? 1 : 0);
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = { checkAction };

package/tools/self-loop/example-check.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# example-check.sh — 빠른 테스트 스크립트
+
+SELF_LOOP="/Users/mupeng/.openclaw/workspace/tools/self-loop"
+
+echo "================================"
+echo "Self-Loop 시스템 테스트"
+echo "================================"
+echo ""
+
+# 1. 패닉 체크
+echo "📊 [1] 패닉 상태 체크"
+echo "---"
+node "$SELF_LOOP/panic-detector.js"
+echo ""
+
+# 2. 정상 행동 체크
+echo "✅ [2] 정상 행동 테스트"
+echo "행동: \"인스타 게시물 1개 업로드\""
+echo "---"
+node "$SELF_LOOP/brake-check.js" "인스타 게시물 1개 업로드"
+echo ""
+
+# 3. 위험 행동 체크
+echo "⚠️  [3] 위험 행동 테스트"
+echo "행동: \"트윗 30개 급하게 발송\""
+echo "---"
+node "$SELF_LOOP/brake-check.js" "트윗 30개 급하게 발송" || true
+echo ""
+
+echo "================================"
+echo "테스트 완료"
+echo "로그 확인: memory/brake-log.md"
+echo "================================"

package/tools/self-loop/panic-detector.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+/**
+ * panic-detector.js — 패닉 모드 감지 시스템
+ * 
+ * 사용법: node panic-detector.js
+ * 출력: 패닉 점수 0-100
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 🔐 무펭이즘 커널 인증
+const { authenticate } = require(path.join(__dirname, '..', 'kernel-guard', 'mupeng-auth.cjs'));
+if (!authenticate()) process.exit(0);
+
+const WORKSPACE = process.env.OPENCLAW_WORKSPACE || path.join(process.env.HOME, '.openclaw', 'workspace');
+const BRAKE_LOG_PATH = path.join(WORKSPACE, 'memory', 'brake-log.md');
+const MEMORY_DIR = path.join(WORKSPACE, 'memory');
+
+// 시간 윈도우 (밀리초)
+const TIME_WINDOWS = {
+  '1min': 60 * 1000,
+  '5min': 5 * 60 * 1000,
+  '1hour': 60 * 60 * 1000,
+  '1day': 24 * 60 * 60 * 1000,
+};
+
+// 패닉 지표 임계값
+const THRESHOLDS = {
+  actions_per_minute: 3,      // 1분당 3개 이상 = 패닉
+  actions_per_5min: 10,        // 5분당 10개 이상 = 패닉
+  actions_per_hour: 30,        // 1시간당 30개 이상 = 패닉
+  warn_ratio: 0.5,             // WARN 비율 50% 이상
+  block_ratio: 0.3,            // BLOCK 비율 30% 이상
+};
+
+// 로그 파싱
+function parseLog() {
+  if (!fs.existsSync(BRAKE_LOG_PATH)) {
+    return [];
+  }
+  
+  const content = fs.readFileSync(BRAKE_LOG_PATH, 'utf-8');
+  const entries = [];
+  
+  // ## 2026-02-10 12:34:56 형식 파싱
+  const regex = /## (\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})\n- 행동: (.+?)\n- 판정: (\w+)/g;
+  let match;
+  
+  while ((match = regex.exec(content)) !== null) {
+    const timestamp = new Date(match[1]).getTime();
+    const action = match[2];
+    const status = match[3];
+    
+    if (!isNaN(timestamp)) {
+      entries.push({ timestamp, action, status });
+    }
+  }
+  
+  return entries.sort((a, b) => b.timestamp - a.timestamp); // 최신순
+}
+
+// 타임스탬프 기반 필터링
+function filterByTimeWindow(entries, windowMs) {
+  const now = Date.now();
+  return entries.filter(e => now - e.timestamp < windowMs);
+}
+
+// 패닉 점수 계산
+function calculatePanicScore() {
+  const entries = parseLog();
+  
+  if (entries.length === 0) {
+    return {
+      score: 0,
+      level: 'CALM',
+      details: '최근 행동 없음',
+      breakdown: {},
+    };
+  }
+  
+  let score = 0;
+  const breakdown = {};
+  
+  // 1. 빈도 체크
+  const recent1min = filterByTimeWindow(entries, TIME_WINDOWS['1min']);
+  const recent5min = filterByTimeWindow(entries, TIME_WINDOWS['5min']);
+  const recent1hour = filterByTimeWindow(entries, TIME_WINDOWS['1hour']);
+  
+  breakdown.actions_1min = recent1min.length;
+  breakdown.actions_5min = recent5min.length;
+  breakdown.actions_1hour = recent1hour.length;
+  
+  if (recent1min.length >= THRESHOLDS.actions_per_minute) {
+    score += 40;
+    breakdown.frequency_1min = '⚠️  1분당 과다 행동';
+  }
+  
+  if (recent5min.length >= THRESHOLDS.actions_per_5min) {
+    score += 25;
+    breakdown.frequency_5min = '⚠️  5분당 과다 행동';
+  }
+  
+  if (recent1hour.length >= THRESHOLDS.actions_per_hour) {
+    score += 20;
+    breakdown.frequency_1hour = '⚠️  1시간당 과다 행동';
+  }
+  
+  // 2. WARN/BLOCK 비율
+  const recent1day = filterByTimeWindow(entries, TIME_WINDOWS['1day']);
+  const warnCount = recent1day.filter(e => e.status === 'WARN').length;
+  const blockCount = recent1day.filter(e => e.status === 'BLOCK').length;
+  const totalRecent = recent1day.length;
+  
+  const warnRatio = totalRecent > 0 ? warnCount / totalRecent : 0;
+  const blockRatio = totalRecent > 0 ? blockCount / totalRecent : 0;
+  
+  breakdown.warn_ratio = (warnRatio * 100).toFixed(1) + '%';
+  breakdown.block_ratio = (blockRatio * 100).toFixed(1) + '%';
+  
+  if (blockRatio >= THRESHOLDS.block_ratio) {
+    score += 30;
+    breakdown.block_alert = '🚨 BLOCK 비율 높음';
+  }
+  
+  if (warnRatio >= THRESHOLDS.warn_ratio) {
+    score += 15;
+    breakdown.warn_alert = '⚠️  WARN 비율 높음';
+  }
+  
+  // 3. 레벨 판정
+  let level = 'CALM';
+  let details = '정상 범위';
+  
+  if (score >= 70) {
+    level = 'PANIC';
+    details = '🚨 패닉 모드 감지! 즉시 멈춰라!';
+  } else if (score >= 40) {
+    level = 'STRESSED';
+    details = '⚠️  스트레스 모드. 속도 줄여라.';
+  } else if (score >= 20) {
+    level = 'ALERT';
+    details = '⚡ 주의 필요. 원칙 체크 권장.';
+  }
+  
+  return { score, level, details, breakdown };
+}
+
+// CLI 실행
+function main() {
+  const result = calculatePanicScore();
+  
+  console.log(`\n🧠 패닉 감지 시스템\n`);
+  console.log(`패닉 점수: ${result.score}/100`);
+  console.log(`상태 레벨: ${result.level}`);
+  console.log(`판단: ${result.details}\n`);
+  
+  console.log(`📊 상세 분석:`);
+  for (const [key, value] of Object.entries(result.breakdown)) {
+    console.log(`  ${key}: ${value}`);
+  }
+  
+  console.log(`\n💡 대응 지침:`);
+  
+  if (result.score >= 70) {
+    console.log(`  🛑 즉시 멈춤 — 모든 외부 행동 중단`);
+    console.log(`  📖 SOUL.md 다시 읽기`);
+    console.log(`  🧘 3초 호흡 — 급할수록 멈춰라`);
+  } else if (result.score >= 40) {
+    console.log(`  ⏸️  속도 늦춤 — 한 번에 하나만`);
+    console.log(`  🔍 최근 행동 리뷰`);
+    console.log(`  💬 형님과 체크인 권장`);
+  } else if (result.score >= 20) {
+    console.log(`  ✅ 원칙 체크 — brake-check 사용`);
+    console.log(`  📝 행동 이유 명확히 하기`);
+  } else {
+    console.log(`  ✅ 정상 작동 중`);
+    console.log(`  🎯 원칙 준수 계속 유지`);
+  }
+  
+  console.log('');
+  
+  // 패닉 상태면 종료 코드 1
+  process.exit(result.level === 'PANIC' ? 1 : 0);
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = { calculatePanicScore, parseLog };

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 mupengi-bot
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.