@team-semicolon/semo-cli 4.1.1 → 4.1.3

package/dist/commands/sessions.js

@@ -189,6 +189,13 @@ function registerSessionsCommands(program) {
                last_activity = NOW(),
                message_count = COALESCE(EXCLUDED.message_count, semo.bot_sessions.message_count),
                synced_at     = NOW()`, [botId, sessionKey, label, options.kind, messageCount ?? null]);
+                // bot_status.session_count 갱신
+                await client.query(`UPDATE semo.bot_status
+             SET session_count = (
+               SELECT COUNT(*) FROM semo.bot_sessions WHERE bot_id = $1
+             ),
+             synced_at = NOW()
+             WHERE bot_id = $1`, [botId]);
             }
             client.release();
             console.log(chalk_1.default.green(`✔ sessions push [${event}] ${botId}/${sessionKey.slice(0, 8)}`));

package/dist/index.js

@@ -676,6 +676,11 @@ async function confirmOverwrite(itemName, itemPath) {
     if (!fs.existsSync(itemPath)) {
         return true;
     }
+    // 비인터랙티브 환경(CI, 파이프) — 덮어쓰지 않고 기존 파일 유지
+    if (!process.stdin.isTTY) {
+        console.log(chalk_1.default.gray(`  → ${itemName} 이미 존재 (비인터랙티브 모드: 건너뜀)`));
+        return false;
+    }
     const { shouldOverwrite } = await inquirer_1.default.prompt([
         {
             type: "confirm",
@@ -776,7 +781,6 @@ program
     .option("--credentials-gist <gistId>", "Private GitHub Gist에서 팀 DB 접속정보 자동 가져오기")
     .action(async (options) => {
     console.log(chalk_1.default.cyan.bold("\n🚀 SEMO 설치 시작\n"));
-    console.log(chalk_1.default.gray("Gemini 하이브리드 전략: White Box + Black Box\n"));
     const cwd = process.cwd();
     // 0.1. 버전 비교
     await showVersionComparison(cwd);
@@ -810,6 +814,8 @@ program
         fs.mkdirSync(claudeDir, { recursive: true });
         console.log(chalk_1.default.green("\n✓ .claude/ 디렉토리 생성됨"));
     }
+    // 2.5. ~/.semo.env DB 접속 설정 (자동 감지 → Gist → 프롬프트) — DB 연결 전에 먼저
+    await setupSemoEnv(options.credentialsGist);
     // 3. Standard 설치 (semo-core + semo-skills)
     await setupStandard(cwd, options.force);
     // 4. MCP 설정
@@ -822,10 +828,8 @@ program
     if (options.gitignore !== false) {
         updateGitignore(cwd);
     }
-    // 7. Hooks 설치 (대화 로깅)
+    // 7. Hooks 설치
     await setupHooks(cwd, false);
-    // 7.5. ~/.semo.env DB 접속 설정 (자동 감지 → Gist → 프롬프트)
-    await setupSemoEnv(options.credentialsGist);
     // 8. CLAUDE.md 생성
     await setupClaudeMd(cwd, [], options.force);
     // 9. 설치 검증
@@ -845,11 +849,11 @@ program
         console.log(chalk_1.default.yellow.bold("\n⚠️ SEMO 설치 완료 (일부 문제 발견)\n"));
     }
     console.log(chalk_1.default.cyan("설치된 구성:"));
-    console.log(chalk_1.default.gray("  [Standard]"));
-    console.log(chalk_1.default.gray("    ✓ semo-core (원칙, 오케스트레이터)"));
-    console.log(chalk_1.default.gray("    ✓ semo-skills (13개 통합 스킬)"));
-    console.log(chalk_1.default.gray("    ✓ semo-agents (14개 페르소나 Agent)"));
-    console.log(chalk_1.default.gray("    ✓ semo-scripts (자동화 스크립트)"));
+    console.log(chalk_1.default.gray("  ✓ .claude/skills/    (DB 기반 스킬)"));
+    console.log(chalk_1.default.gray("  ✓ .claude/agents/    (DB 기반 에이전트)"));
+    console.log(chalk_1.default.gray("  ✓ .claude/commands/  (슬래시 커맨드)"));
+    console.log(chalk_1.default.gray("  ✓ .claude/memory/    (컨텍스트 동기화)"));
+    console.log(chalk_1.default.gray("  ✓ ~/.claude/settings.local.json  (훅 등록)"));
     console.log(chalk_1.default.cyan("\n다음 단계:"));
     console.log(chalk_1.default.gray("  1. Claude Code에서 프로젝트 열기 (SessionStart 훅이 자동 sync)"));
     console.log(chalk_1.default.gray("  2. 자연어로 요청하기 (예: \"댓글 기능 구현해줘\")"));
@@ -929,8 +933,6 @@ async function setupStandard(cwd, force) {
         }
         console.log(chalk_1.default.green(`  ✓ agents 설치 완료 (${agents.length}개)`));
         spinner.succeed("Standard 설치 완료 (DB 기반)");
-        // CLAUDE.md 생성
-        await generateClaudeMd(cwd);
     }
     catch (error) {
         spinner.fail("Standard 설치 실패");
@@ -1629,54 +1631,11 @@ semo-system/
 async function setupHooks(cwd, isUpdate = false) {
     const action = isUpdate ? "업데이트" : "설치";
     console.log(chalk_1.default.cyan(`\n🪝 Claude Code Hooks ${action}`));
-    console.log(chalk_1.default.gray("   전체 대화 로깅 시스템\n"));
-    const hooksDir = path.join(cwd, "semo-system", "semo-hooks");
-    // semo-hooks 디렉토리 확인
-    if (!fs.existsSync(hooksDir)) {
-        console.log(chalk_1.default.yellow("  ⚠ semo-hooks 디렉토리 없음 (건너뜀)"));
-        return;
-    }
-    // 1. npm install
-    console.log(chalk_1.default.gray("  → 의존성 설치 중..."));
-    try {
-        (0, child_process_1.execSync)("npm install", {
-            cwd: hooksDir,
-            stdio: ["pipe", "pipe", "pipe"],
-        });
-    }
-    catch {
-        console.log(chalk_1.default.yellow("  ⚠ npm install 실패 (건너뜀)"));
-        return;
-    }
-    // 2. 빌드
-    console.log(chalk_1.default.gray("  → 빌드 중..."));
-    try {
-        (0, child_process_1.execSync)("npm run build", {
-            cwd: hooksDir,
-            stdio: ["pipe", "pipe", "pipe"],
-        });
-    }
-    catch {
-        console.log(chalk_1.default.yellow("  ⚠ 빌드 실패 (건너뜀)"));
-        return;
-    }
-    // 3. settings.local.json 설정
     const homeDir = process.env.HOME || process.env.USERPROFILE || "";
     const settingsPath = path.join(homeDir, ".claude", "settings.local.json");
-    const hooksCmd = `node ${path.join(hooksDir, "dist", "index.js")}`;
-    // hooks 설정 객체
+    // Core 훅: semo context sync/push — semo-hooks 유무와 무관하게 항상 등록
     const hooksConfig = {
         SessionStart: [
-            {
-                matcher: "",
-                hooks: [
-                    {
-                        type: "command",
-                        command: `${hooksCmd} session-start`,
-                        timeout: 10,
-                    },
-                ],
-            },
             {
                 matcher: "",
                 hooks: [
@@ -1688,29 +1647,7 @@ async function setupHooks(cwd, isUpdate = false) {
                 ],
             },
         ],
-        UserPromptSubmit: [
-            {
-                matcher: "",
-                hooks: [
-                    {
-                        type: "command",
-                        command: `${hooksCmd} user-prompt`,
-                        timeout: 5,
-                    },
-                ],
-            },
-        ],
         Stop: [
-            {
-                matcher: "",
-                hooks: [
-                    {
-                        type: "command",
-                        command: `${hooksCmd} stop`,
-                        timeout: 10,
-                    },
-                ],
-            },
             {
                 matcher: "",
                 hooks: [
@@ -1722,19 +1659,37 @@ async function setupHooks(cwd, isUpdate = false) {
                 ],
             },
         ],
-        SessionEnd: [
-            {
-                matcher: "",
-                hooks: [
-                    {
-                        type: "command",
-                        command: `${hooksCmd} session-end`,
-                        timeout: 10,
-                    },
-                ],
-            },
-        ],
     };
+    // semo-hooks 빌드 (선택적 — semo-system 레포에서만 동작)
+    const hooksDir = path.join(cwd, "semo-system", "semo-hooks");
+    if (fs.existsSync(hooksDir)) {
+        let hooksBuilt = false;
+        try {
+            (0, child_process_1.execSync)("npm install", { cwd: hooksDir, stdio: ["pipe", "pipe", "pipe"] });
+            (0, child_process_1.execSync)("npm run build", { cwd: hooksDir, stdio: ["pipe", "pipe", "pipe"] });
+            hooksBuilt = true;
+        }
+        catch {
+            console.log(chalk_1.default.yellow("  ⚠ semo-hooks 빌드 실패 (core 훅만 등록)"));
+        }
+        if (hooksBuilt) {
+            const hooksCmd = `node ${path.join(hooksDir, "dist", "index.js")}`;
+            hooksConfig.SessionStart.unshift({
+                matcher: "",
+                hooks: [{ type: "command", command: `${hooksCmd} session-start`, timeout: 10 }],
+            });
+            hooksConfig.UserPromptSubmit = [
+                { matcher: "", hooks: [{ type: "command", command: `${hooksCmd} user-prompt`, timeout: 5 }] },
+            ];
+            hooksConfig.Stop.unshift({
+                matcher: "",
+                hooks: [{ type: "command", command: `${hooksCmd} stop`, timeout: 10 }],
+            });
+            hooksConfig.SessionEnd = [
+                { matcher: "", hooks: [{ type: "command", command: `${hooksCmd} session-end`, timeout: 10 }] },
+            ];
+        }
+    }
     // 기존 설정 로드 또는 새로 생성
     let existingSettings = {};
     const claudeConfigDir = path.join(homeDir, ".claude");
@@ -1935,133 +1890,132 @@ async function setupClaudeMd(cwd, _extensions, force) {
             return;
         }
     }
-    const orchestratorRefSection = `**반드시 읽어야 할 파일**: \`semo-system/semo-core/agents/orchestrator/orchestrator.md\`
-
-이 파일에서 라우팅 테이블, 의도 분류, 메시지 포맷을 확인하세요.`;
-    const claudeMdContent = `# SEMO Project Configuration
+    const projectName = path.basename(cwd);
+    const installDate = new Date().toISOString().split("T")[0];
+    const claudeMdContent = `# ${projectName} — Claude Configuration
 
-> SEMO (Semicolon Orchestrate) - AI Agent Orchestration Framework v${VERSION}
+> SEMO v${VERSION} 설치됨 (${installDate})
 
 ---
 
-## 🔴 MANDATORY: Memory Context (항시 참조)
-
-> **⚠️ 세션 시작 시 반드시 \`.claude/memory/\` 폴더의 파일들을 먼저 읽으세요. 예외 없음.**
+## SEMO란?
 
-### 필수 참조 파일
+**SEMO (Semicolon Orchestrate)** 는 OpenClaw 봇팀과 로컬 Claude Code 세션이
+**팀 Core DB를 단일 진실 공급원(Single Source of Truth)으로 공유**하는 컨텍스트 동기화 시스템이다.
 
 \`\`\`
-.claude/memory/
-├── context.md     # 프로젝트 상태, 기술 스택, 진행 중 작업
-├── decisions.md   # 아키텍처 결정 기록 (ADR)
-├── projects.md    # GitHub Projects 설정
-└── rules/         # 프로젝트별 커스텀 규칙
+로컬 Claude Code 세션
+    ↕ semo context sync / push
+팀 Core DB (PostgreSQL, semo 스키마)
+    ↕ 봇 세션 시작/종료 훅
+OpenClaw 봇팀 (7개 봇)
+  workclaw · reviewclaw · planclaw · designclaw
+  infraclaw · growthclaw · semiclaw
 \`\`\`
 
-**이 파일들은 세션의 컨텍스트를 유지하는 장기 기억입니다. 매 세션마다 반드시 읽고 시작하세요.**
+**이 CLAUDE.md가 설치된 프로젝트는 OpenClaw 봇팀의 컨텍스트를 실시간으로 공유받는다.**
 
 ---
 
-## 🔴 MANDATORY: Orchestrator-First Execution
+## 자동 동기화
 
-> **⚠️ 이 규칙은 모든 사용자 요청에 적용됩니다. 예외 없음.**
+세션 시작/종료 시 팀 Core DB와 자동 동기화됩니다.
 
-### 실행 흐름 (필수)
+| 시점 | 동작 |
+|------|------|
+| 세션 시작 | \`semo context sync\` → \`.claude/memory/\` 최신화 |
+| 세션 종료 | \`semo context push\` → \`decisions.md\` 변경분 DB 저장 |
+
+---
+
+## Memory Context
+
+\`.claude/memory/\` 파일들은 **팀 Core DB (\`semo\` 스키마)에서 자동으로 채워집니다**.
+직접 편집하지 마세요 — 세션 시작 시 덮어씌워집니다.
+
+| 파일 | DB 소스 | 방향 |
+|------|---------|------|
+| \`team.md\` | \`kb WHERE domain='team'\` | DB → 로컬 (읽기 전용) |
+| \`projects.md\` | \`kb WHERE domain='project'\` | DB → 로컬 (읽기 전용) |
+| \`decisions.md\` | \`kb WHERE domain='decision'\` | **양방향** (편집 가능, Stop 시 DB 저장) |
+| \`infra.md\` | \`kb WHERE domain='infra'\` | DB → 로컬 (읽기 전용) |
+| \`process.md\` | \`kb WHERE domain='process'\` | DB → 로컬 (읽기 전용) |
+| \`bots.md\` | \`semo.bot_status\` | DB → 로컬 (봇 상태) |
+| \`ontology.md\` | \`semo.ontology\` | DB → 로컬 (읽기 전용) |
+
+**decisions.md 만 편집 가능합니다.** 아키텍처 결정(ADR)을 여기에 기록하세요.
+
+---
+
+## 설치된 구성
 
 \`\`\`
-1. 사용자 요청 수신
-2. Orchestrator가 의도 분석 후 적절한 Agent/Skill 라우팅
-3. Agent/Skill이 작업 수행
-4. 실행 결과 반환
+.claude/
+├── CLAUDE.md       # 이 파일
+├── settings.json   # MCP 서버 설정 + SessionStart/Stop 훅
+├── memory/         # Core DB → 로컬 자동 동기화 컨텍스트
+├── skills/         # SEMO 스킬 (semo-system/semo-skills/ 링크)
+├── agents/         # SEMO 에이전트 (semo-system/meta/agents/ 링크)
+└── commands/SEMO   # 슬래시 커맨드 (semo-system/semo-core/commands/)
 \`\`\`
 
-### Orchestrator 참조
+---
 
-${orchestratorRefSection}
+## 프로젝트 규칙 (팀이 채워야 함)
 
----
+> 아래 섹션은 이 프로젝트 고유의 규칙을 기록하세요.
+> 팀 공통 규칙은 \`memory/process.md\`에 있습니다.
 
-## 🔴 NON-NEGOTIABLE RULES
+### 기술 스택
 
-### 1. Orchestrator-First Policy
+<!-- 예: Next.js 14, PostgreSQL, TypeScript strict mode -->
 
-> **모든 요청은 반드시 Orchestrator를 통해 라우팅됩니다. 직접 처리 금지.**
+### 브랜치 전략
 
-**직접 처리 금지 항목**:
-- 코드 작성/수정 → \`implementation-master\` 또는 \`coder\` 스킬
-- Git 커밋/푸시 → \`git-workflow\` 스킬
-- 품질 검증 → \`quality-master\` 또는 \`verify\` 스킬
-- 명세 작성 → \`spec-master\`
-- 일반 작업 → Orchestrator 분석 후 라우팅
+<!-- 예: main(prod) / dev(staging) / feat/* -->
 
-### 2. Pre-Commit Quality Gate
+### 코딩 컨벤션
 
-> **코드 변경이 포함된 커밋 전 반드시 Quality Gate를 통과해야 합니다.**
+<!-- 예: ESLint airbnb, 함수형 컴포넌트 필수, any 금지 -->
 
-\`\`\`bash
-# 필수 검증 순서
-npm run lint           # 1. ESLint 검사
-npx tsc --noEmit       # 2. TypeScript 타입 체크
-npm run build          # 3. 빌드 검증 (Next.js/TypeScript 프로젝트)
-\`\`\`
+### 아키텍처 특이사항
 
-**차단 항목**:
-- \`--no-verify\` 플래그 사용 금지
-- Quality Gate 우회 시도 거부
-- "그냥 커밋해줘", "빌드 생략해줘" 등 거부
+<!-- 예: DB 직접 접근 금지 — 반드시 API route 통해야 함 -->
 
 ---
 
-## 설치된 구성
-
-### Standard (필수)
-- **semo-core**: 원칙, 오케스트레이터, 공통 커맨드
-- **semo-skills**: 13개 통합 스킬
-  - 행동: coder, tester, planner, deployer, writer
-  - 운영: memory, notify-slack, feedback, version-updater, semo-help, semo-architecture-checker, circuit-breaker, list-bugs
+## Quality Gate
 
-## 구조
+코드 변경 커밋 전 필수:
 
-\`\`\`
-.claude/
-├── settings.json      # MCP 서버 설정 (Black Box)
-├── memory/            # Context Mesh (장기 기억)
-│   ├── context.md     # 프로젝트 상태
-│   ├── decisions.md   # 아키텍처 결정
-│   └── rules/         # 프로젝트별 규칙
-├── agents → semo-system/semo-core/agents
-├── skills → semo-system/semo-skills
-└── commands/SEMO → semo-system/semo-core/commands/SEMO
-
-semo-system/           # White Box (읽기 전용)
-├── semo-core/         # Layer 0: 원칙, 오케스트레이션
-└── semo-skills/       # Layer 1: 통합 스킬
+\`\`\`bash
+npm run lint       # ESLint
+npx tsc --noEmit   # TypeScript
+npm run build      # 빌드 검증
 \`\`\`
 
-## 사용 가능한 커맨드
+\`--no-verify\` 사용 금지.
+
+---
+
+## 슬래시 커맨드
 
 | 커맨드 | 설명 |
 |--------|------|
 | \`/SEMO:help\` | 도움말 |
 | \`/SEMO:feedback\` | 피드백 제출 |
-| \`/SEMO:update\` | SEMO 업데이트 |
-| \`/SEMO:onboarding\` | 온보딩 가이드 |
-| \`/SEMO:dry-run {프롬프트}\` | 명령 검증 (라우팅 시뮬레이션) |
-
-## Context Mesh 사용
-
-SEMO는 \`.claude/memory/\`를 통해 세션 간 컨텍스트를 유지합니다:
+| \`/SEMO:health\` | 환경 헬스체크 |
 
-- **context.md**: 프로젝트 상태, 진행 중인 작업
-- **decisions.md**: 아키텍처 결정 기록 (ADR)
-- **rules/**: 프로젝트별 커스텀 규칙
-
-memory 스킬이 자동으로 이 파일들을 관리합니다.
+---
 
-## References
+## 복구 명령어
 
-- [SEMO Principles](semo-system/semo-core/principles/PRINCIPLES.md)
-- [SEMO Skills](semo-system/semo-skills/)
+\`\`\`bash
+semo doctor              # 환경 진단 (DB 연결, 설치 상태)
+semo config db           # DB URL 재설정
+semo context sync        # memory/ 수동 최신화
+semo bots status         # 봇 상태 조회
+\`\`\`
 `;
     fs.writeFileSync(claudeMdPath, claudeMdContent);
     console.log(chalk_1.default.green("✓ .claude/CLAUDE.md 생성됨"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@team-semicolon/semo-cli",
-  "version": "4.1.1",
+  "version": "4.1.3",
   "description": "SEMO CLI - AI Agent Orchestration Framework Installer",
   "main": "dist/index.js",
   "bin": {