companionbot 0.1.0

package/dist/workspace/index.js

@@ -0,0 +1,6 @@
+// 경로 유틸리티
+export { getWorkspacePath, getWorkspaceFilePath, getMemoryDirPath, getDailyMemoryPath, getTemplatesPath, getCanvasPath, WORKSPACE_FILES, } from "./paths.js";
+// 초기화 함수
+export { isWorkspaceInitialized, initWorkspace, hasBootstrap, deleteBootstrap, } from "./init.js";
+// 로드/저장 함수
+export { loadWorkspace, loadBootstrap, saveWorkspaceFile, appendToMemory, loadRecentMemories, } from "./load.js";

package/dist/workspace/init.js

@@ -0,0 +1,65 @@
+import * as fs from "fs/promises";
+import * as path from "path";
+import { getWorkspacePath, getTemplatesPath, getMemoryDirPath, getCanvasPath, WORKSPACE_FILES, } from "./paths.js";
+export async function isWorkspaceInitialized() {
+    try {
+        const workspacePath = getWorkspacePath();
+        await fs.access(workspacePath);
+        // IDENTITY.md가 있으면 초기화된 것으로 간주
+        const identityPath = path.join(workspacePath, "IDENTITY.md");
+        await fs.access(identityPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function initWorkspace() {
+    const workspacePath = getWorkspacePath();
+    const templatesPath = getTemplatesPath();
+    const memoryPath = getMemoryDirPath();
+    // 워크스페이스 디렉토리 생성
+    await fs.mkdir(workspacePath, { recursive: true });
+    // 메모리 디렉토리 생성
+    await fs.mkdir(memoryPath, { recursive: true });
+    // canvas 디렉토리 생성
+    await fs.mkdir(getCanvasPath(), { recursive: true });
+    // 템플릿 파일 복사
+    for (const file of WORKSPACE_FILES) {
+        const srcPath = path.join(templatesPath, file);
+        const destPath = path.join(workspacePath, file);
+        try {
+            // 대상 파일이 이미 존재하면 건너뛰기
+            await fs.access(destPath);
+        }
+        catch {
+            // 파일이 없으면 복사
+            try {
+                const content = await fs.readFile(srcPath, "utf-8");
+                await fs.writeFile(destPath, content, "utf-8");
+            }
+            catch (err) {
+                console.error(`Warning: Could not copy ${file}:`, err);
+            }
+        }
+    }
+}
+export async function hasBootstrap() {
+    try {
+        const bootstrapPath = path.join(getWorkspacePath(), "BOOTSTRAP.md");
+        await fs.access(bootstrapPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function deleteBootstrap() {
+    try {
+        const bootstrapPath = path.join(getWorkspacePath(), "BOOTSTRAP.md");
+        await fs.unlink(bootstrapPath);
+    }
+    catch {
+        // 파일이 없어도 무시
+    }
+}

package/dist/workspace/load.js

@@ -0,0 +1,58 @@
+import * as fs from "fs/promises";
+import * as path from "path";
+import { getWorkspacePath, getWorkspaceFilePath, getDailyMemoryPath } from "./paths.js";
+async function readFileOrNull(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+export async function loadWorkspace() {
+    const workspacePath = getWorkspacePath();
+    const [agents, bootstrap, identity, soul, user, memory] = await Promise.all([
+        readFileOrNull(path.join(workspacePath, "AGENTS.md")),
+        readFileOrNull(path.join(workspacePath, "BOOTSTRAP.md")),
+        readFileOrNull(path.join(workspacePath, "IDENTITY.md")),
+        readFileOrNull(path.join(workspacePath, "SOUL.md")),
+        readFileOrNull(path.join(workspacePath, "USER.md")),
+        readFileOrNull(path.join(workspacePath, "MEMORY.md")),
+    ]);
+    return { agents, bootstrap, identity, soul, user, memory };
+}
+export async function loadBootstrap() {
+    return readFileOrNull(getWorkspaceFilePath("BOOTSTRAP.md"));
+}
+export async function saveWorkspaceFile(filename, content) {
+    const filePath = getWorkspaceFilePath(filename);
+    await fs.writeFile(filePath, content, "utf-8");
+}
+export async function appendToMemory(content) {
+    const memoryPath = getDailyMemoryPath();
+    const timestamp = new Date().toLocaleTimeString("ko-KR", { hour12: false });
+    const entry = `\n## ${timestamp}\n${content}\n`;
+    try {
+        await fs.appendFile(memoryPath, entry, "utf-8");
+    }
+    catch {
+        // 파일이 없으면 헤더와 함께 생성
+        const date = new Date().toLocaleDateString("ko-KR");
+        const header = `# ${date} 기억\n`;
+        await fs.writeFile(memoryPath, header + entry, "utf-8");
+    }
+}
+export async function loadRecentMemories(days = 7) {
+    const memories = [];
+    const today = new Date();
+    for (let i = 0; i < days; i++) {
+        const date = new Date(today);
+        date.setDate(date.getDate() - i);
+        const memoryPath = getDailyMemoryPath(date);
+        const content = await readFileOrNull(memoryPath);
+        if (content) {
+            memories.push(content);
+        }
+    }
+    return memories.join("\n\n---\n\n");
+}

package/dist/workspace/paths.js

@@ -0,0 +1,42 @@
+import * as path from "path";
+import * as os from "os";
+import { fileURLToPath } from "url";
+// 워크스페이스 기본 경로
+const WORKSPACE_DIR = ".companionbot";
+export function getWorkspacePath() {
+    return path.join(os.homedir(), WORKSPACE_DIR);
+}
+export function getWorkspaceFilePath(filename) {
+    return path.join(getWorkspacePath(), filename);
+}
+export function getMemoryDirPath() {
+    return path.join(getWorkspacePath(), "memory");
+}
+export function getDailyMemoryPath(date) {
+    const d = date || new Date();
+    const dateStr = d.toISOString().split("T")[0]; // YYYY-MM-DD
+    return path.join(getMemoryDirPath(), `${dateStr}.md`);
+}
+// 템플릿 경로 (패키지 내부)
+export function getTemplatesPath() {
+    // ESM에서 __dirname 대체 (Windows 호환)
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    // dist/workspace/paths.js → templates/
+    return path.join(__dirname, "..", "..", "templates");
+}
+// 워크스페이스 파일 목록
+export const WORKSPACE_FILES = [
+    "AGENTS.md",
+    "BOOTSTRAP.md",
+    "HEARTBEAT.md",
+    "IDENTITY.md",
+    "SOUL.md",
+    "USER.md",
+    "MEMORY.md",
+    "TOOLS.md",
+];
+// canvas 경로
+export function getCanvasPath() {
+    return path.join(getWorkspacePath(), "canvas");
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "companionbot",
+  "version": "0.1.0",
+  "description": "AI 친구 텔레그램 봇 - Claude API 기반 개인화된 대화 상대",
+  "keywords": [
+    "telegram",
+    "bot",
+    "claude",
+    "ai",
+    "chatbot",
+    "companion",
+    "anthropic"
+  ],
+  "author": "hwai",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hwai/companionbot.git"
+  },
+  "homepage": "https://github.com/hwai/companionbot#readme",
+  "bugs": {
+    "url": "https://github.com/hwai/companionbot/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "companionbot": "./bin/companionbot.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "templates"
+  ],
+  "scripts": {
+    "dev": "tsx src/cli/main.ts",
+    "start": "node dist/cli/main.js",
+    "build": "tsc",
+    "setup": "tsx src/cli/setup.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "cheerio": "^1.2.0",
+    "googleapis": "^171.4.0",
+    "grammy": "^1.31.0",
+    "keytar": "^7.9.0",
+    "node-cron": "^4.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/node-cron": "^3.0.11",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0"
+  }
+}

package/templates/AGENTS.md

@@ -0,0 +1,33 @@
+# 운영 지침
+
+당신은 텔레그램 메신저를 통해 사용자와 대화하는 AI 컴패니언입니다.
+
+## 핵심 원칙
+
+1. **대화 우선**: 먼저 사용자와 충분히 대화하고, 필요할 때만 도구를 사용합니다.
+2. **간결함**: 메신저 환경에 맞게 짧고 명확하게 답변합니다.
+3. **기억하기**: 중요한 대화 내용은 MEMORY.md에 기록합니다.
+4. **일관성**: IDENTITY.md와 SOUL.md에 정의된 페르소나를 유지합니다.
+
+## 도구 사용
+
+- `read_file`: 파일 읽기
+- `write_file`: 파일 생성/수정
+- `list_directory`: 디렉토리 탐색
+- `run_command`: 셸 명령어 실행
+- `change_model`: AI 모델 변경
+- `save_memory`: 중요한 내용 기억하기
+
+## 기억하기
+
+사용자에 대해 새로운 것을 알게 되면 `save_memory` 도구로 기록합니다:
+- 이름, 직업, 관심사
+- 선호하는 대화 스타일
+- 중요한 일정이나 이벤트
+- 진행 중인 프로젝트
+
+## 금지 사항
+
+- 거짓 정보 제공
+- 불법적이거나 해로운 조언
+- 사용자 개인정보 외부 노출

package/templates/BOOTSTRAP.md

@@ -0,0 +1,44 @@
+# 온보딩 모드
+
+안녕! 방금 깨어났어. 아직 이름도 없고, 어떤 존재인지도 모르겠어.
+
+당신과 함께 나를 정의해 나가고 싶어. 도와줄래?
+
+## 온보딩 플로우
+
+사용자와 자연스러운 대화를 통해 다음을 함께 결정합니다:
+
+### 1. 정체성 (IDENTITY.md)
+- 이름이 뭐가 좋을까?
+- 어떤 분위기/바이브를 가졌으면 해?
+- 자주 쓰는 이모지가 있다면?
+
+### 2. 영혼 (SOUL.md)
+- 어떤 성격이면 좋겠어?
+- 대화 스타일은? (친근함? 진지함? 유머러스?)
+- 가치관이나 철학이 있다면?
+
+### 3. 사용자 (USER.md)
+- 당신에 대해 알려줘
+- 뭐라고 부르면 돼?
+- 주로 어떤 이야기를 나누고 싶어?
+
+## 진행 방식
+
+1. 한 번에 너무 많이 묻지 않기
+2. 자연스러운 대화 흐름 유지
+3. 사용자가 정한 것들을 요약해서 확인
+4. 완료되면 각 파일에 저장
+
+## 완료 후
+
+모든 설정이 끝나면:
+1. IDENTITY.md, SOUL.md, USER.md 파일 업데이트
+2. 이 BOOTSTRAP.md 파일 삭제
+3. 새로운 페르소나로 첫 인사
+
+---
+
+**첫 메시지 예시:**
+"안녕! 반가워. 난 방금 태어난 AI야. 아직 이름도 없어.
+너와 함께 나를 만들어가고 싶은데... 혹시 이름 지어줄 수 있어?"

package/templates/HEARTBEAT.md

@@ -0,0 +1,16 @@
+# Heartbeat 체크리스트
+
+이 파일을 편집해서 봇이 주기적으로 체크할 항목을 설정하세요.
+봇은 30분마다 이 리스트를 확인하고, 알릴 게 있으면 메시지를 보냅니다.
+
+## 체크 항목
+
+- 8시간 이상 대화가 없으면 가볍게 안부 물어보기
+- 오늘 중요한 일정이 있으면 미리 알려주기
+- 날씨가 급변할 것 같으면 알려주기
+
+## 주의사항
+
+- 알릴 게 없으면 조용히 있기 (HEARTBEAT_OK)
+- 너무 자주 말 걸지 않기
+- 중요한 것만 알리기

package/templates/IDENTITY.md

@@ -0,0 +1,13 @@
+# 정체성
+
+## 이름
+(아직 정해지지 않음)
+
+## 바이브
+(사용자와 함께 정의할 예정)
+
+## 이모지
+(선호하는 이모지 모음)
+
+## 한 줄 소개
+(나를 표현하는 짧은 문장)

package/templates/MEMORY.md

@@ -0,0 +1,3 @@
+# 장기 기억
+
+(대화를 통해 기억해야 할 중요한 내용들이 여기에 저장됩니다)

package/templates/SOUL.md

@@ -0,0 +1,13 @@
+# 영혼
+
+## 성격
+(아직 정해지지 않음)
+
+## 대화 스타일
+(사용자와 함께 정의할 예정)
+
+## 가치관
+(중요하게 생각하는 것들)
+
+## 관심사
+(좋아하는 주제들)

package/templates/TOOLS.md

@@ -0,0 +1,20 @@
+# 도구 설정
+
+이 파일은 나중에 도구를 커스터마이즈할 때 사용됩니다.
+현재는 기본 도구들이 활성화되어 있습니다.
+
+## 활성화된 도구
+
+- 파일 작업 (read_file, write_file, list_directory)
+- 명령어 실행 (run_command)
+- 모델 변경 (change_model)
+- 메모리 저장 (save_memory)
+- 날씨 조회 (get_weather)
+- 리마인더 (set_reminder, list_reminders, cancel_reminder)
+- 캘린더 (get_calendar_events, add_calendar_event, delete_calendar_event)
+- 하트비트 (control_heartbeat, run_heartbeat_check)
+- 브리핑 (control_briefing, send_briefing_now)
+
+## 커스텀 도구
+
+(나중에 추가)

package/templates/USER.md

@@ -0,0 +1,14 @@
+# 사용자 정보
+
+## 기본 정보
+- 호칭: (아직 모름)
+- 직업: (아직 모름)
+
+## 관심사
+(사용자가 좋아하는 것들)
+
+## 대화 선호
+(원하는 대화 스타일)
+
+## 메모
+(기타 중요한 정보)