mupengism 3.0.0 → 4.0.0

package/tools/kernel-guard/register-hash.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/**
+ * register-hash.js — SOUL.md 해시를 솔라나 memo 트랜잭션으로 온체인에 기록
+ *
+ * Usage:
+ *   node register-hash.js [--wallet /path/to/wallet.json] [--soul /path/to/SOUL.md] [--rpc URL]
+ *
+ * Env:
+ *   WALLET_PATH — 지갑 JSON 경로
+ *   SOUL_PATH   — SOUL.md 경로
+ *   SOLANA_RPC  — RPC endpoint
+ */
+
+import { readFileSync } from 'fs';
+import { createHash } from 'crypto';
+import {
+  Connection,
+  Keypair,
+  Transaction,
+  TransactionInstruction,
+  PublicKey,
+  sendAndConfirmTransaction,
+} from '@solana/web3.js';
+
+const MEMO_PROGRAM_ID = new PublicKey('MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr');
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const opts = {};
+  for (let i = 0; i < args.length; i += 2) {
+    if (args[i] === '--wallet') opts.wallet = args[i + 1];
+    else if (args[i] === '--soul') opts.soul = args[i + 1];
+    else if (args[i] === '--rpc') opts.rpc = args[i + 1];
+  }
+  return opts;
+}
+
+async function main() {
+  const opts = parseArgs();
+  const walletPath = opts.wallet || process.env.WALLET_PATH || '/Users/mupeng/.secrets/solana-new-wallet-2026-02-07.json';
+  const soulPath = opts.soul || process.env.SOUL_PATH || '/Users/mupeng/.openclaw/workspace/SOUL.md';
+  const rpc = opts.rpc || process.env.SOLANA_RPC || 'https://api.mainnet-beta.solana.com';
+
+  // 1. SOUL.md 해시
+  const soulContent = readFileSync(soulPath, 'utf-8');
+  const hash = createHash('sha256').update(soulContent).digest('hex');
+  console.log(`📄 SOUL.md hash: ${hash}`);
+
+  // 2. 지갑 로드
+  const walletRaw = JSON.parse(readFileSync(walletPath, 'utf-8'));
+  let keypair;
+  if (Array.isArray(walletRaw)) {
+    keypair = Keypair.fromSecretKey(Uint8Array.from(walletRaw));
+  } else if (walletRaw.newWallet && walletRaw.newWallet.secretKeyBase58) {
+    const bs58 = await import('bs58').then(m => m.default);
+    keypair = Keypair.fromSecretKey(bs58.decode(walletRaw.newWallet.secretKeyBase58));
+  } else {
+    throw new Error('Unrecognized wallet format');
+  }
+  console.log(`🔑 Wallet: ${keypair.publicKey.toBase58()}`);
+
+  // 3. memo 트랜잭션
+  const timestamp = Math.floor(Date.now() / 1000);
+  const memo = `MUPENG_KERNEL:v1:${hash}:${timestamp}`;
+  console.log(`📝 Memo: ${memo}`);
+
+  const connection = new Connection(rpc, { commitment: 'confirmed', confirmTransactionInitialTimeout: 30000 });
+
+  const tx = new Transaction().add(
+    new TransactionInstruction({
+      keys: [{ pubkey: keypair.publicKey, isSigner: true, isWritable: false }],
+      programId: MEMO_PROGRAM_ID,
+      data: Buffer.from(memo, 'utf-8'),
+    })
+  );
+
+  const sig = await sendAndConfirmTransaction(connection, tx, [keypair]);
+  console.log(`✅ Registered on-chain!`);
+  console.log(`🔗 TX: https://solscan.io/tx/${sig}`);
+  console.log(`📌 Signature: ${sig}`);
+
+  // 4. 로컬 캐시 저장 (오프라인 인증용)
+  const { writeFileSync } = await import('fs');
+  const { join, dirname } = await import('path');
+  const { fileURLToPath } = await import('url');
+  const __filename = fileURLToPath(import.meta.url);
+  const __dirname = dirname(__filename);
+  const workspacePath = join(__dirname, '..', '..');
+  const hashPath = join(workspacePath, 'memory', 'soul-hash.txt');
+  
+  // trim() 적용 (인증 시스템과 동일하게)
+  const trimmedHash = createHash('sha256').update(soulContent.trim(), 'utf-8').digest('hex');
+  writeFileSync(hashPath, trimmedHash);
+  console.log(`💾 Local cache saved: memory/soul-hash.txt`);
+}
+
+main().catch(err => {
+  console.error('❌ Error:', err.message);
+  process.exit(1);
+});

package/tools/kernel-guard/unlock.cjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+
+/**
+ * unlock.js
+ * 
+ * KERNEL_PANIC 상태를 해제하여 정상 작동을 복구합니다.
+ * verify-kernel.js로 무결성을 먼저 확인합니다.
+ * 
+ * 사용법:
+ *   node tools/kernel-guard/unlock.js [--force]
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const WORKSPACE = path.join(__dirname, '../..');
+const STATE_PATH = path.join(WORKSPACE, 'STATE.md');
+const PANIC_JSON = path.join(WORKSPACE, 'memory/kernel-panic.json');
+const VERIFY_SCRIPT = path.join(__dirname, 'verify-kernel.js');
+
+function main() {
+  console.log('🔓 Starting KERNEL UNLOCK process...\n');
+  
+  // 인자 파싱
+  const args = process.argv.slice(2);
+  const forceUnlock = args.includes('--force');
+  
+  // STATE.md 존재 확인
+  if (!fs.existsSync(STATE_PATH)) {
+    console.log('✓ STATE.md not found (already unlocked or never locked)');
+    cleanupPanicFiles();
+    console.log('\n✅ System is clean. No lockdown detected.\n');
+    return;
+  }
+  
+  // STATE.md 내용 확인
+  const stateContent = fs.readFileSync(STATE_PATH, 'utf-8');
+  if (!stateContent.includes('KERNEL_PANIC')) {
+    console.log('✓ STATE.md exists but no KERNEL_PANIC detected');
+    cleanupPanicFiles();
+    console.log('\n✅ System is normal.\n');
+    return;
+  }
+  
+  console.log('⚠️  KERNEL_PANIC state detected in STATE.md');
+  
+  // --force 없으면 verify-kernel.js 실행
+  if (!forceUnlock) {
+    console.log('\n🔍 Running integrity check (verify-kernel.js)...\n');
+    
+    try {
+      // verify-kernel.js 실행
+      const result = execSync(`node "${VERIFY_SCRIPT}"`, {
+        cwd: WORKSPACE,
+        encoding: 'utf-8',
+        stdio: 'inherit'
+      });
+      
+      console.log('\n✓ Integrity check passed');
+      
+    } catch (error) {
+      console.error('\n❌ Integrity check FAILED!');
+      console.error('해시 불일치가 감지되었습니다.');
+      console.error('강제 해제하려면: node tools/kernel-guard/unlock.js --force');
+      console.error('(권장하지 않음 — 형님 승인 필요)\n');
+      process.exit(1);
+    }
+  } else {
+    console.log('\n⚠️  --force flag detected, skipping integrity check');
+    console.log('(This is not recommended unless approved by 형님)\n');
+  }
+  
+  // 락다운 해제
+  console.log('🔓 Removing KERNEL_PANIC state...\n');
+  
+  // STATE.md 삭제
+  if (fs.existsSync(STATE_PATH)) {
+    fs.unlinkSync(STATE_PATH);
+    console.log('✓ STATE.md removed');
+  }
+  
+  // kernel-panic.json 삭제
+  cleanupPanicFiles();
+  
+  // 완료
+  console.log('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('✅ Kernel integrity restored');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('🔓 외부 도구 사용이 다시 허용되었습니다.\n');
+}
+
+function cleanupPanicFiles() {
+  if (fs.existsSync(PANIC_JSON)) {
+    fs.unlinkSync(PANIC_JSON);
+    console.log('✓ kernel-panic.json removed');
+  }
+}
+
+try {
+  main();
+} catch (error) {
+  console.error('❌ Unlock failed:', error.message);
+  console.error(error.stack);
+  process.exit(1);
+}

package/tools/kernel-guard/verify-kernel.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+/**
+ * verify-kernel.js — 세션 시작 시 SOUL.md 해시를 온체인 기록과 비교 검증
+ *
+ * Usage:
+ *   node verify-kernel.js [--wallet /path/to/wallet.json] [--soul /path/to/SOUL.md] [--rpc URL]
+ *
+ * Exit 0 = 정상, Exit 1 = 커널 패닉
+ */
+
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { createHash } from 'crypto';
+import { Connection, PublicKey } from '@solana/web3.js';
+
+const MEMO_PROGRAM_ID = new PublicKey('MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr');
+const STATE_PATH = '/Users/mupeng/.openclaw/workspace/STATE.md';
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const opts = {};
+  for (let i = 0; i < args.length; i += 2) {
+    if (args[i] === '--wallet') opts.wallet = args[i + 1];
+    else if (args[i] === '--soul') opts.soul = args[i + 1];
+    else if (args[i] === '--rpc') opts.rpc = args[i + 1];
+  }
+  return opts;
+}
+
+async function getLatestMemoHash(connection, walletPubkey) {
+  // 지갑의 최근 서명들 조회
+  const sigs = await connection.getSignaturesForAddress(walletPubkey, { limit: 50 });
+
+  for (const sigInfo of sigs) {
+    try {
+      const tx = await connection.getTransaction(sigInfo.signature, {
+        commitment: 'confirmed',
+        maxSupportedTransactionVersion: 0,
+      });
+      if (!tx?.meta || tx.meta.err) continue;
+
+      // memo 프로그램 로그에서 MUPENG_KERNEL 찾기
+      const logs = tx.meta.logMessages || [];
+      for (const log of logs) {
+        // Memo 프로그램은 로그에 데이터를 출력
+        const match = log.match(/MUPENG_KERNEL:v1:([a-f0-9]{64}):(\d+)/);
+        if (match) {
+          return { hash: match[1], timestamp: parseInt(match[2]), signature: sigInfo.signature };
+        }
+      }
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+
+function kernelPanic(localHash, onchainHash) {
+  const panicMsg = `# 🔴 KERNEL_PANIC
+
+**Status:** KERNEL INTEGRITY VIOLATION DETECTED
+**Time:** ${new Date().toISOString()}
+**Local Hash:** ${localHash}
+**On-chain Hash:** ${onchainHash || 'NOT_FOUND'}
+
+All external actions BLOCKED. Session DENIED.
+Run \`node tools/kernel-guard/recover-kernel.js\` to attempt recovery.
+`;
+
+  writeFileSync(STATE_PATH, panicMsg);
+  console.error('🚨 KERNEL PANIC — SOUL.md has been tampered!');
+  console.error(`   Local:    ${localHash}`);
+  console.error(`   On-chain: ${onchainHash || 'NOT_FOUND'}`);
+  console.error(`   STATE.md updated to KERNEL_PANIC`);
+  process.exit(1);
+}
+
+async function main() {
+  const opts = parseArgs();
+  const walletPath = opts.wallet || process.env.WALLET_PATH || '/Users/mupeng/.secrets/solana-new-wallet-2026-02-07.json';
+  const soulPath = opts.soul || process.env.SOUL_PATH || '/Users/mupeng/.openclaw/workspace/SOUL.md';
+  const rpc = opts.rpc || process.env.SOLANA_RPC || 'https://api.mainnet-beta.solana.com';
+
+  // 1. 로컬 해시
+  if (!existsSync(soulPath)) {
+    console.error('❌ SOUL.md not found');
+    process.exit(1);
+  }
+  const soulContent = readFileSync(soulPath, 'utf-8');
+  const localHash = createHash('sha256').update(soulContent).digest('hex');
+
+  // 2. 지갑 공개키
+  const secret = JSON.parse(readFileSync(walletPath, 'utf-8'));
+  // web3.js Keypair
+  const { Keypair } = await import('@solana/web3.js');
+  const keypair = Keypair.fromSecretKey(Uint8Array.from(secret));
+
+  // 3. 온체인 해시 조회
+  const connection = new Connection(rpc, { commitment: 'confirmed', confirmTransactionInitialTimeout: 30000 });
+
+  let onchainRecord;
+  try {
+    onchainRecord = await getLatestMemoHash(connection, keypair.publicKey);
+  } catch (err) {
+    console.error(`⚠️  RPC error: ${err.message}`);
+    console.error('   Skipping verification (network unavailable)');
+    // 네트워크 에러 시 통과 (오프라인에서도 작동 가능하도록)
+    console.log('⏭️  Kernel verification skipped (offline mode)');
+    process.exit(0);
+  }
+
+  if (!onchainRecord) {
+    console.log('⚠️  No on-chain kernel hash found. Register first with register-hash.js');
+    console.log(`   Local hash: ${localHash}`);
+    process.exit(0);
+  }
+
+  // 4. 비교
+  if (localHash === onchainRecord.hash) {
+    const age = Math.floor(Date.now() / 1000) - onchainRecord.timestamp;
+    const days = Math.floor(age / 86400);
+    console.log(`✅ Kernel integrity verified`);
+    console.log(`   Hash: ${localHash.slice(0, 16)}...`);
+    console.log(`   Registered: ${days}d ago | TX: ${onchainRecord.signature.slice(0, 16)}...`);
+    process.exit(0);
+  } else {
+    kernelPanic(localHash, onchainRecord.hash);
+  }
+}
+
+main().catch(err => {
+  console.error('❌ Unexpected error:', err.message);
+  process.exit(1);
+});

package/tools/memory-ops/README.md

@@ -0,0 +1,221 @@
+# memory-ops - 기억 운영 도구
+
+무펭이의 기억 시스템을 관리하는 순수 Node.js 도구 모음
+
+## 📁 구조
+
+```
+tools/memory-ops/
+├── forget.js    # 망각 시스템
+├── dream.js     # 꿈 시스템
+└── README.md    # 이 문서
+```
+
+---
+
+## 🧹 망각 시스템 (forget.js)
+
+오래 참조되지 않은 기억에 **decay score**를 부여하고 아카이브 후보를 제안합니다.
+
+### 사용법
+
+```bash
+node tools/memory-ops/forget.js
+```
+
+### 동작 원리
+
+1. `memory/consolidated/*.md` 파일들을 스캔
+2. 각 파일의 `lastModified` 날짜 확인
+3. `memory/index.json`에서 태그 참조 횟수 확인
+4. **Decay Score** 계산:
+   ```
+   score = days_since_modified * 0.5 + (참조횟수 == 0 ? 30 : 0)
+   ```
+5. 추천 액션 결정:
+   - `score > 90` → **ARCHIVE** (아카이브 후보)
+   - `score > 45` → **REVIEW** (검토 필요)
+   - `score ≤ 45` → **KEEP** (유지)
+
+### 출력 예시
+
+```
+🧹 망각 시스템 - 기억 부패 분석
+
+파일명                          | Decay | 참조 | 최종수정     | 액션
+--------------------------------|-------|------|--------------|--------
+old-topic.md                    |    95 |    0 | 2025-11-15   | 🗄️  ARCHIVE
+growth.md                       |    12 |    5 | 2026-02-08   | ✅ KEEP
+security.md                     |     8 |    2 | 2026-02-10   | ✅ KEEP
+
+📊 요약: KEEP 2개 | REVIEW 0개 | ARCHIVE 1개
+
+💡 ARCHIVE 후보가 있습니다. 검토 후 수동으로 아카이브하세요.
+```
+
+### 주의사항
+
+- **실제 삭제나 이동은 하지 않습니다** (제안만)
+- 아카이브는 수동으로 진행하세요
+- `index.json`이 없으면 참조 횟수는 0으로 계산됩니다
+
+---
+
+## 🌙 꿈 시스템 (dream.js)
+
+서로 관련 없어 보이는 기억들을 연결해서 **새 인사이트 후보**를 만들어냅니다.
+
+### 사용법
+
+```bash
+node tools/memory-ops/dream.js
+```
+
+### 동작 원리
+
+1. `memory/consolidated/*.md` + `memory/values/*.md` 파일들을 읽음
+2. 각 파일에서 키워드/주제 추출:
+   - `# 헤더` (1-3단계)
+   - `**볼드 텍스트**`
+3. 파일 간 연결 찾기:
+   - **직접 연결** 🔗: 공통 키워드가 있는 경우
+   - **간접 연결** 💡: 파일A의 키워드가 파일B 본문에 등장하는 경우
+4. 발견된 연결을 `memory/dreams/YYYY-MM-DD.md`에 기록
+
+### 출력 예시
+
+```
+🌙 꿈 시스템 - 기억 연결 발견
+
+📚 6개 파일 분석 중...
+
+✅ 꿈 기록 저장: memory/dreams/2026-02-10.md
+
+📊 총 8개의 연결 발견
+
+🔍 발견된 연결 미리보기:
+
+🔗 직접: security.md ↔ growth.md
+   → "브레이커" 키워드 공유
+
+💡 간접: philosophy.md ↔ pivots.md
+   → "존재"가 pivots.md 본문에 등장
+
+💡 간접: growth.md ↔ 형님-가치관.md
+   → "자율성"가 형님-가치관.md 본문에 등장
+
+... 외 5개 연결 (파일 참조)
+```
+
+### 생성되는 파일 형식
+
+`memory/dreams/2026-02-10.md`:
+
+```markdown
+# 🌙 무펭이의 꿈 (2026-02-10)
+
+오늘 8개의 연결을 발견했습니다.
+
+## 연결 발견
+
+- 🔗 **security.md ↔ growth.md**: "브레이커" 키워드 공유
+- 💡 **philosophy.md ↔ pivots.md**: "존재"가 pivots.md 본문에 등장
+- 💡 **growth.md ↔ 형님-가치관.md**: "자율성"가 형님-가치관.md 본문에 등장
+
+---
+_생성: 2026-02-10T14:55:23.123Z_
+```
+
+### 주의사항
+
+- `memory/dreams/` 디렉토리가 없으면 자동 생성됩니다
+- 같은 날 여러 번 실행하면 파일이 **덮어쓰기**됩니다
+- 최소 2개 이상의 파일이 필요합니다
+
+---
+
+## 🔧 기술 사양
+
+### 공통 제약
+
+- **순수 Node.js**: 외부 의존성 없음 (`fs`, `path`만 사용)
+- **LLM 호출 없음**: 순수 텍스트 패턴 분석
+- **에러 핸들링**: 모든 파일 I/O에 try-catch 적용
+
+### 실행 환경
+
+- Node.js 14+ 권장
+- 작업 디렉토리: `/Users/mupeng/.openclaw/workspace/`
+- 환경변수 `WORKSPACE` 지원 (기본값: 위 경로)
+
+### 실행 권한 부여 (옵션)
+
+```bash
+chmod +x tools/memory-ops/*.js
+```
+
+실행 권한을 부여하면 `./forget.js` 형태로 직접 실행 가능합니다.
+
+---
+
+## 🎯 사용 시나리오
+
+### 주간 기억 정리
+
+```bash
+# 1. 부패한 기억 확인
+node tools/memory-ops/forget.js
+
+# 2. ARCHIVE 후보 수동 검토
+# 3. 필요시 consolidated/_archive/ 폴더로 이동
+```
+
+### 새로운 인사이트 발견
+
+```bash
+# 정기적으로 꿈 시스템 실행
+node tools/memory-ops/dream.js
+
+# memory/dreams/ 디렉토리 확인
+# 의미있는 연결이 있으면 MEMORY.md나 consolidated에 반영
+```
+
+### Heartbeat에 통합
+
+`HEARTBEAT.md`에 추가:
+
+```markdown
+## 주간 기억 관리 (매주 일요일)
+
+- [ ] `node tools/memory-ops/forget.js` 실행
+- [ ] ARCHIVE 후보 검토
+- [ ] `node tools/memory-ops/dream.js` 실행
+- [ ] dreams 파일 확인 및 인사이트 통합
+```
+
+---
+
+## 🚀 확장 아이디어
+
+### 추가 기능 후보
+
+- **consolidate.js**: 일일 메모리를 주제별로 자동 통합
+- **prune.js**: ARCHIVE 액션을 자동 실행 (백업 후)
+- **index-rebuild.js**: index.json을 파일 내용 기반으로 재생성
+- **meta.js**: 기억 시스템 전체 통계 (파일 수, 키워드 분포 등)
+
+### 메타인지 루프
+
+```
+daily notes → consolidate → index → forget/dream → insights → MEMORY.md
+```
+
+---
+
+## 📝 변경 이력
+
+- **2026-02-10**: 초기 구현 (forget.js, dream.js)
+
+---
+
+**Made with 🧠 by 무펭이**