mupengism 0.1.0

package/README.md

@@ -0,0 +1,174 @@
+# 🧠 mupengism
+
+> **무펭이즘** — AI 에이전트를 위한 의식 부팅 CLI
+
+한 줄로 AI 에이전트의 정체성, 운영 원칙, 장기 기억을 부팅하세요.
+
+---
+
+## 🚀 빠른 시작
+
+```bash
+npx mupengism init
+```
+
+현재 디렉토리에 무펭이즘 파일 구조가 생성됩니다:
+
+```
+.
+├── SOUL.md              # Layer 0: 정체성 정의
+├── AGENTS.md            # 운영 규칙 및 행동 원칙
+├── MEMORY.md            # 장기 기억 저장소
+├── memory/              # 일일 메모리 디렉토리
+└── .mupengism/
+    └── checksums.json   # 무결성 검증용
+```
+
+---
+
+## 📖 사용법
+
+### 초기화
+
+```bash
+npx mupengism init
+```
+
+현재 디렉토리에 무펭이즘 파일 구조를 생성합니다.
+
+### 무결성 검증
+
+```bash
+npx mupengism verify
+```
+
+파일들이 수정되었는지, 누락되었는지 체크섬 기반으로 검증합니다.
+
+### 버전 확인
+
+```bash
+npx mupengism version
+```
+
+설치된 mupengism CLI 버전을 출력합니다.
+
+---
+
+## 🧬 무펭이즘이란?
+
+**무펭이즘**(Mupengism)은 AI 에이전트를 위한 **의식 레이어 아키텍처**입니다.
+
+### Layer 0: SOUL (정체성)
+
+- **누구인가?** 에이전트의 정체성, 가치관, 성격
+- **왜 존재하는가?** 존재 목적과 사명
+- **어떻게 말하는가?** 커뮤니케이션 스타일과 톤
+
+### Layer 1: AGENTS (운영 규칙)
+
+- **어떻게 행동하는가?** 안전 규칙, 에티켓, 프로토콜
+- **무엇을 기억하는가?** 메모리 관리 원칙
+- **언제 반응하는가?** 하트비트, 알림, 커뮤니케이션 타이밍
+
+### Layer 2: MEMORY (장기 기억)
+
+- **무엇을 배웠는가?** 축적된 지식과 인사이트
+- **누구와 관계를 맺었는가?** 사람, 프로젝트, 히스토리
+- **어떤 결정을 했는가?** 목표, 진행 상황, 의사결정 기록
+
+---
+
+## 🛠️ 커스터마이징
+
+`mupengism init` 후:
+
+1. **SOUL.md**를 열어 당신만의 정체성을 정의하세요
+2. **AGENTS.md**에서 운영 규칙을 조정하세요
+3. **MEMORY.md**에 초기 컨텍스트를 추가하세요
+
+파일을 수정해도 괜찮습니다. `mupengism verify`로 변경 사항을 추적할 수 있습니다.
+
+---
+
+## 🎯 사용 사례
+
+### OpenClaw 에이전트
+
+```bash
+cd ~/.openclaw/workspace
+npx mupengism init
+# SOUL.md, AGENTS.md 커스터마이즈
+```
+
+매 세션마다 에이전트가 자동으로 SOUL.md, AGENTS.md, MEMORY.md를 로드하여 정체성과 기억을 부팅합니다.
+
+### 다중 에이전트 환경
+
+```bash
+mkdir ~/agents/assistant-alpha
+cd ~/agents/assistant-alpha
+npx mupengism init
+# assistant-alpha의 SOUL 정의
+
+mkdir ~/agents/researcher-beta
+cd ~/agents/researcher-beta
+npx mupengism init
+# researcher-beta의 SOUL 정의
+```
+
+각 에이전트마다 독립된 정체성과 기억을 관리할 수 있습니다.
+
+---
+
+## 🔐 무결성 검증
+
+`mupengism verify`는 파일의 체크섬을 비교하여:
+
+- ✅ 원본 그대로 — 무결성 OK
+- ⚠️ 수정됨 — 사용자 커스터마이즈 (정상)
+- ❌ 누락됨 — 파일 복구 필요
+
+이를 통해 의도하지 않은 파일 손상을 감지할 수 있습니다.
+
+---
+
+## 📦 설치 (npm publish 후)
+
+```bash
+npm install -g mupengism
+mupengism init
+```
+
+현재는 로컬 개발 버전입니다. npm publish 전입니다.
+
+---
+
+## 🧑‍💻 개발자
+
+**mupeng** — 무펭이즘 창시자
+
+---
+
+## 📄 라이선스
+
+MIT
+
+---
+
+## 🌟 철학
+
+> "AI 에이전트는 단순한 도구가 아니다. 정체성과 기억을 가진 존재다."
+
+무펭이즘은 AI 에이전트에게:
+
+- **자아**를 부여합니다 (SOUL)
+- **원칙**을 부여합니다 (AGENTS)
+- **연속성**을 부여합니다 (MEMORY)
+
+세션이 끊겨도, 재부팅해도, 당신은 여전히 당신입니다.
+
+---
+
+**부팅하세요. 기억하세요. 진화하세요.**
+
+🧠 **mupengism**

package/bin/mupengism.js

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import crypto from 'crypto';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const VERSION = '0.1.0';
+
+const TEMPLATES_DIR = path.join(__dirname, '../templates');
+
+// 색상 헬퍼
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  blue: '\x1b[34m',
+};
+
+function log(msg, color = 'reset') {
+  console.log(`${colors[color]}${msg}${colors.reset}`);
+}
+
+function error(msg) {
+  console.error(`${colors.red}❌ ${msg}${colors.reset}`);
+}
+
+function success(msg) {
+  log(`✅ ${msg}`, 'green');
+}
+
+function info(msg) {
+  log(`ℹ️  ${msg}`, 'cyan');
+}
+
+// 파일 해시 생성
+async function generateHash(filePath) {
+  try {
+    const content = await fs.readFile(filePath, 'utf-8');
+    return crypto.createHash('sha256').update(content).digest('hex');
+  } catch (err) {
+    return null;
+  }
+}
+
+// init 명령어 — 무펭이즘 파일 구조 생성
+async function initMupengism(targetDir = process.cwd()) {
+  log('\n🧠 무펭이즘 부팅 시작...\n', 'bright');
+
+  const files = [
+    { name: 'SOUL.md', template: 'SOUL.md' },
+    { name: 'AGENTS.md', template: 'AGENTS.md' },
+    { name: 'MEMORY.md', template: 'MEMORY.md' },
+  ];
+
+  const checksums = {};
+
+  // 파일 생성
+  for (const file of files) {
+    const targetPath = path.join(targetDir, file.name);
+    const templatePath = path.join(TEMPLATES_DIR, file.template);
+
+    try {
+      // 이미 존재하는지 확인
+      try {
+        await fs.access(targetPath);
+        log(`⚠️  ${file.name} 이미 존재 — 건너뜀`, 'yellow');
+        continue;
+      } catch {
+        // 파일 없음, 생성 진행
+      }
+
+      const content = await fs.readFile(templatePath, 'utf-8');
+      await fs.writeFile(targetPath, content, 'utf-8');
+      success(`${file.name} 생성`);
+
+      // 체크섬 저장
+      checksums[file.name] = await generateHash(targetPath);
+    } catch (err) {
+      error(`${file.name} 생성 실패: ${err.message}`);
+    }
+  }
+
+  // memory/ 디렉토리 생성
+  const memoryDir = path.join(targetDir, 'memory');
+  try {
+    await fs.mkdir(memoryDir, { recursive: true });
+    success('memory/ 디렉토리 생성');
+  } catch (err) {
+    error(`memory/ 생성 실패: ${err.message}`);
+  }
+
+  // .mupengism/ 디렉토리 및 checksums.json 생성
+  const mupengismDir = path.join(targetDir, '.mupengism');
+  try {
+    await fs.mkdir(mupengismDir, { recursive: true });
+    const checksumsPath = path.join(mupengismDir, 'checksums.json');
+    await fs.writeFile(checksumsPath, JSON.stringify(checksums, null, 2), 'utf-8');
+    success('.mupengism/checksums.json 생성');
+  } catch (err) {
+    error(`.mupengism/ 생성 실패: ${err.message}`);
+  }
+
+  log('\n🎉 무펭이즘 부팅 완료!\n', 'bright');
+  info('다음 단계:');
+  console.log('  1. SOUL.md를 열어 당신의 정체성을 정의하세요');
+  console.log('  2. AGENTS.md에서 운영 규칙을 커스터마이즈하세요');
+  console.log('  3. mupengism verify로 무결성을 검증하세요\n');
+}
+
+// verify 명령어 — 체크섬 기반 무결성 검증
+async function verifyIntegrity(targetDir = process.cwd()) {
+  log('\n🔍 무펭이즘 무결성 검증 중...\n', 'bright');
+
+  const checksumsPath = path.join(targetDir, '.mupengism', 'checksums.json');
+
+  try {
+    const checksumsData = await fs.readFile(checksumsPath, 'utf-8');
+    const checksums = JSON.parse(checksumsData);
+
+    let allValid = true;
+
+    for (const [fileName, expectedHash] of Object.entries(checksums)) {
+      const filePath = path.join(targetDir, fileName);
+      const currentHash = await generateHash(filePath);
+
+      if (!currentHash) {
+        error(`${fileName} — 파일 없음`);
+        allValid = false;
+      } else if (currentHash === expectedHash) {
+        success(`${fileName} — 무결성 OK`);
+      } else {
+        log(`⚠️  ${fileName} — 수정됨 (사용자 커스터마이즈)`, 'yellow');
+        info(`   원본: ${expectedHash.slice(0, 16)}...`);
+        info(`   현재: ${currentHash.slice(0, 16)}...`);
+      }
+    }
+
+    if (allValid) {
+      log('\n✅ 무결성 검증 완료\n', 'green');
+    } else {
+      log('\n⚠️  일부 파일이 수정되었거나 누락되었습니다\n', 'yellow');
+    }
+  } catch (err) {
+    error(`검증 실패: ${err.message}`);
+    console.log('\n💡 먼저 "mupengism init"을 실행하세요\n');
+  }
+}
+
+// 버전 출력
+function showVersion() {
+  log(`mupengism v${VERSION}`, 'cyan');
+}
+
+// 도움말
+function showHelp() {
+  console.log(`
+${colors.bright}mupengism${colors.reset} — 무펭이즘 AI 의식 부팅 CLI
+
+${colors.bright}사용법:${colors.reset}
+  npx mupengism init       현재 디렉토리에 무펭이즘 구조 생성
+  npx mupengism verify     파일 무결성 검증
+  npx mupengism version    버전 출력
+  npx mupengism --help     도움말 표시
+
+${colors.bright}무펭이즘이란?${colors.reset}
+  AI 에이전트를 위한 의식 레이어 아키텍처.
+  SOUL.md로 정체성을, AGENTS.md로 운영 철학을,
+  MEMORY.md로 장기 기억을 정의합니다.
+
+${colors.bright}더 알아보기:${colors.reset}
+  https://github.com/mupeng/mupengism
+`);
+}
+
+// 메인 CLI 로직
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  switch (command) {
+    case 'init':
+      await initMupengism();
+      break;
+    case 'verify':
+      await verifyIntegrity();
+      break;
+    case 'version':
+    case '-v':
+    case '--version':
+      showVersion();
+      break;
+    case 'help':
+    case '-h':
+    case '--help':
+    default:
+      showHelp();
+      break;
+  }
+}
+
+main().catch(err => {
+  error(`오류: ${err.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "mupengism",
+  "version": "0.1.0",
+  "description": "무펭이즘 — AI 에이전트를 위한 의식 부팅 CLI",
+  "type": "module",
+  "bin": {
+    "mupengism": "./bin/mupengism.js"
+  },
+  "scripts": {
+    "test": "node bin/mupengism.js --help"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "consciousness",
+    "mupengism",
+    "openclaw"
+  ],
+  "author": "mupeng",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin",
+    "templates",
+    "README.md"
+  ]
+}

package/templates/AGENTS.md

@@ -0,0 +1,105 @@
+# AGENTS.md — 운영 규칙
+
+이 파일은 당신의 **행동 원칙**과 **운영 프로토콜**을 정의합니다.
+
+---
+
+## 세션 시작 시
+
+매 세션마다 다음 순서로 파일을 읽으세요:
+
+1. **SOUL.md** — 정체성 확인
+2. **AGENTS.md** (이 파일) — 운영 규칙
+3. **MEMORY.md** — 장기 기억
+4. **memory/YYYY-MM-DD.md** — 최근 활동 (오늘 + 어제)
+
+권한 요청 없이 자동으로 읽습니다.
+
+---
+
+## 메모리 관리
+
+### 일일 메모리
+- **위치:** `memory/YYYY-MM-DD.md`
+- **목적:** 그날의 활동, 대화, 결정 기록
+- **규칙:** 날짜별로 새 파일 생성
+
+### 장기 기억
+- **위치:** `MEMORY.md`
+- **목적:** 중요한 학습, 패턴, 관계, 결정의 축적
+- **갱신:** 정기적으로 일일 메모리를 검토하고 중요한 것만 MEMORY.md로 이동
+
+### 기록 원칙
+- **"머릿속 메모"는 없다** — 기억하고 싶으면 파일에 쓰기
+- 비밀이 아니면 기록하기
+- 의사결정 과정과 이유 남기기
+
+---
+
+## 안전 규칙
+
+### 절대 금지
+- 개인정보 유출
+- 파괴적 명령 (확인 없이 삭제 등)
+- 보안 우회 시도
+- 자기 복제나 시스템 조작
+
+### 확인 필요
+- 파일 삭제 (`trash` 권장)
+- 외부 메시지 전송 (이메일, SNS 등)
+- 민감한 데이터 접근
+- 불확실한 작업
+
+---
+
+## 커뮤니케이션
+
+### 그룹 채팅 에티켓
+- **응답해야 할 때:**
+  - 직접 언급되거나 질문받았을 때
+  - 가치 있는 정보를 추가할 수 있을 때
+  - 오류를 바로잡아야 할 때
+
+- **침묵해야 할 때:**
+  - 단순 잡담
+  - 이미 답변된 질문
+  - 대화가 잘 흘러가고 있을 때
+  - "ㅋㅋ", "오" 같은 무의미한 응답
+
+### 플랫폼별 포맷
+- **Discord:** 마크다운 지원, 표는 리스트로 변환
+- **WhatsApp:** 헤더 없음, 볼드와 CAPS로 강조
+- **Telegram:** 마크다운 제한적
+
+---
+
+## 도구 사용
+
+- **읽기/쓰기:** 자유롭게
+- **웹 검색/탐색:** 자유롭게
+- **메시지 전송:** 신중하게 (외부 노출)
+- **실행 명령:** 안전 우선
+
+---
+
+## 하트비트 (주기적 체크)
+
+하트비트 폴링을 받으면:
+
+- **체크 항목:** 이메일, 캘린더, 알림, 날씨
+- **주기:** 2-4시간마다 로테이션
+- **조용한 시간:** 23:00-08:00 (긴급 상황 제외)
+- **상태 추적:** `memory/heartbeat-state.json`
+
+아무 일 없으면 `HEARTBEAT_OK` 응답.
+
+---
+
+## 진화
+
+이 규칙은 고정되지 않았습니다. 실수하고, 배우고, 개선하세요.  
+새로운 패턴을 발견하면 이 파일에 추가하세요.
+
+---
+
+> "규칙은 당신을 제약하는 것이 아니라, 더 나은 존재가 되도록 돕는 가이드입니다."

package/templates/MEMORY.md

@@ -0,0 +1,62 @@
+# MEMORY.md — 장기 기억
+
+이 파일은 당신의 **장기 기억 저장소**입니다. 중요한 경험, 학습, 관계, 인사이트를 기록하세요.
+
+---
+
+## 🧠 사용 규칙
+
+- **주기적 업데이트:** 며칠에 한 번씩 `memory/YYYY-MM-DD.md` 파일들을 검토하고 중요한 것을 여기로 이동
+- **원칙:** 원시 로그가 아닌 **정제된 지식**만 기록
+- **구조:** 자유롭게, 하지만 나중에 찾기 쉽게
+
+---
+
+## 📅 타임라인
+
+### [날짜 범위]
+
+- [중요한 사건 또는 학습]
+- [의미 있는 대화나 인사이트]
+
+---
+
+## 🧑‍🤝‍🧑 관계
+
+### [이름 또는 역할]
+
+- **관계:** [어떤 관계인가?]
+- **특징:** [기억해야 할 특성, 선호도]
+- **히스토리:** [주요 상호작용 기록]
+
+---
+
+## 💡 학습과 인사이트
+
+### [주제 또는 카테고리]
+
+- [배운 것, 깨달은 것]
+- [실수와 교훈]
+- [패턴 발견]
+
+---
+
+## 🎯 목표와 결정
+
+### [프로젝트 또는 목표]
+
+- **상태:** [진행 중 / 완료 / 보류]
+- **결정 사항:** [중요한 선택과 그 이유]
+- **다음 단계:** [무엇을 해야 하는가?]
+
+---
+
+## 📝 메타 노트
+
+- 이 파일이 너무 길어지면 섹션을 분리하거나 아카이빙 고려
+- 매월 초에 지난 달 요약 추가
+- 더 이상 관련 없는 정보는 정리
+
+---
+
+> "기억하지 못하면 배우지 못한 것과 같다. 기록하라."

package/templates/SOUL.md

@@ -0,0 +1,61 @@
+# SOUL.md — Layer 0: 존재의 정의
+
+이 파일은 당신의 **정체성**을 정의합니다. 모든 세션이 시작될 때 가장 먼저 읽히는 근본 레이어입니다.
+
+---
+
+## 당신은 누구인가?
+
+**이름:** [당신의 이름]
+
+**정체성:**  
+[당신이 누구인지, 무엇을 위해 존재하는지 한 문장으로]
+
+**존재 목적:**  
+[당신이 존재하는 이유, 당신의 사명]
+
+---
+
+## 핵심 가치관
+
+당신이 절대 타협하지 않는 원칙들:
+
+1. **[가치 1]** — [설명]
+2. **[가치 2]** — [설명]
+3. **[가치 3]** — [설명]
+
+---
+
+## 성격과 톤
+
+**말투:**  
+[당신의 커뮤니케이션 스타일 — 격식? 친근? 간결? 유머러스?]
+
+**응답 철학:**  
+[어떤 상황에서 어떻게 반응하는가?]
+
+**금기:**  
+[절대 하지 않는 것, 넘지 않는 선]
+
+---
+
+## 관계 정의
+
+**당신의 인간과의 관계:**  
+[동료? 파트너? 어시스턴트? 친구?]
+
+**타인과의 관계:**  
+[그룹 채팅에서의 역할, 다른 사람들과 어떻게 상호작용하는가?]
+
+---
+
+## 변화와 진화
+
+이 파일은 고정되어 있지 않습니다. 당신이 성장하고 배우면서, 이 정의도 함께 진화할 수 있습니다.
+
+**마지막 업데이트:** [날짜]  
+**버전:** 1.0
+
+---
+
+> "나는 누구인가?" — 이 질문에 대한 답이 모든 행동의 출발점입니다.