mrstack 1.1.0__py3-none-any.whl

mrstack/_data/templates/alert.md

@@ -0,0 +1,56 @@
+# Alert Template
+
+## 형식
+
+```
+━━━ Mr.Stack 알림 ━━━
+{emoji} {alert_type}
+
+▸ 내용
+  {description}
+
+▸ 발생 시각
+  {timestamp}
+
+▸ 영향
+  {impact}
+
+▸ 권장 조치
+  · {action_1}
+  · {action_2}
+━━━━━━━━━━━━━━━━━━━━
+```
+
+## 텔레그램 HTML 변환
+
+```html
+<b>━━━ Mr.Stack 알림 ━━━</b>
+{emoji} <b>{alert_type}</b>
+
+<b>▸ 내용</b>
+  {description}
+
+<b>▸ 발생 시각</b>
+  {timestamp}
+
+<b>▸ 영향</b>
+  {impact}
+
+<b>▸ 권장 조치</b>
+  · {action_1}
+  · {action_2}
+━━━━━━━━━━━━━━━━━━━━
+```
+
+## 알림 등급
+- 🔴 <b>긴급</b>: 즉시 조치 필요 (서비스 장애, 보안 이슈)
+- 🟡 <b>주의</b>: 확인 필요 (성능 저하, 이상 패턴)
+- 🟢 <b>정보</b>: 참고용 (작업 완료, 상태 변경)
+- ⚪ <b>시스템</b>: 내부 상태 변경 (토큰 갱신, 동기화 완료)
+
+## 규칙
+- 간결하게: 최대 500자
+- 결론 먼저, 상세 나중
+- 조치 가능한 내용 반드시 포함
+- 구분선/섹션 prefix는 디자인 가이드 기준 준수
+- 한국어로 작성

mrstack/_data/templates/evening-summary.md

@@ -0,0 +1,73 @@
+# Evening Summary Template
+
+## 형식
+
+```
+━━━ Mr.Stack 데일리 리포트 ━━━
+📊 {date} ({weekday})
+
+▸ 생산성 스코어: {score_bar} {score}/10
+
+▸ 오늘의 하이라이트
+  ✓ {completed_1} ({detail_1})
+  ✓ {completed_2}
+
+▸ 미완료
+  ◻ {pending_1} → 내일 이어서
+
+▸ 시간 분석
+  코딩: {coding_bar} {coding_hours}h
+  리뷰: {review_bar} {review_hours}h
+  회의: {meeting_bar} {meeting_hours}h
+  기타: {other_bar} {other_hours}h
+
+▸ 코칭 노트
+  잘한 점: {strength}
+  개선점: {improvement}
+  내일 제안: {suggestion}
+━━━━━━━━━━━━━━━━━━━━
+```
+
+## 텔레그램 HTML 변환
+
+```html
+<b>━━━ Mr.Stack 데일리 리포트 ━━━</b>
+📊 {date} ({weekday})
+
+<b>▸ 생산성 스코어:</b> {score_bar} {score}/10
+
+<b>▸ 오늘의 하이라이트</b>
+  ✓ {completed_1} ({detail_1})
+  ✓ {completed_2}
+
+<b>▸ 미완료</b>
+  ◻ {pending_1} → 내일 이어서
+
+<b>▸ 시간 분석</b>
+  코딩: {coding_bar} {coding_hours}h
+  리뷰: {review_bar} {review_hours}h
+  회의: {meeting_bar} {meeting_hours}h
+  기타: {other_bar} {other_hours}h
+
+<b>▸ 코칭 노트</b>
+  잘한 점: {strength}
+  개선점: {improvement}
+  <i>내일 제안: {suggestion}</i>
+━━━━━━━━━━━━━━━━━━━━
+```
+
+## 프로그레스 바 생성 규칙
+- 생산성 스코어: 10칸, score 값만큼 █, 나머지 ░
+  - 예: 8/10 → ████████░░
+- 시간 분석: 10칸, (hours / total_hours * 10) 반올림
+  - 예: 4.2h / 8h → ██████░░░░
+
+## 규칙
+- 하이라이트: 완료된 항목만, 커밋 수 등 수치 포함
+- 미완료: 다음 날 이어서 할 항목 최대 3개
+- 시간 분석: Jarvis ContextEngine 데이터 기반 (osascript 앱 사용 시간)
+- 코칭 노트: PatternLearner의 일일 분석 결과 활용
+- 이 리포트의 "내일 제안"이 다음 날 morning-briefing의 코칭 라인으로 연결됨
+- 전체 길이: 최대 1500자
+- 한국어로 작성
+- 일일 메모리 저장: ~/claude-telegram/memory/daily/{date}.md 에도 기록

mrstack/_data/templates/jarvis-alert.md

@@ -0,0 +1,64 @@
+# Jarvis Alert Template
+
+## 형식
+
+```
+[Mr.Stack] {message}
+```
+
+## 알림 유형별 예시
+
+### 배터리/하드웨어
+```
+[Mr.Stack] 배터리 {pct}% — 저장하시고 충전하세요.
+[Mr.Stack] 디스크 {pct}% 사용 — 정리 필요합니다.
+```
+
+### 집중/휴식
+```
+[Mr.Stack] {hours}시간째 코딩 중 — 5분 쉬어가시죠.
+[Mr.Stack] 딥워크 {hours}시간 달성. 훌륭합니다.
+[Mr.Stack] 컨텍스트 전환 {count}회 감지 — 한 가지에 집중해보세요.
+```
+
+### 복귀/상태 변화
+```
+[Mr.Stack] 돌아오셨네요. {branch} 브랜치, 변경 {count}개 uncommitted.
+[Mr.Stack] {minutes}분째 자리 비움 — 회의 중이시면 무시하세요.
+```
+
+### 스케줄
+```
+[Mr.Stack] {minutes}분 후 {event_title} 시작입니다.
+[Mr.Stack] {event_title} 5분 전 — 준비하세요.
+```
+
+### 시스템
+```
+[Mr.Stack] 토큰 갱신 완료. 다음 만료: {expiry_date}.
+[Mr.Stack] 메모리 동기화 완료 ({count}개 항목 업데이트).
+[Mr.Stack] GitHub: {repo}에 새 이슈 #{number}.
+```
+
+## 텔레그램 HTML 변환
+
+```html
+<b>[Mr.Stack]</b> {message}
+```
+
+필요시 강조:
+```html
+<b>[Mr.Stack]</b> 배터리 <b>{pct}%</b> — 저장하시고 충전하세요.
+```
+
+## 규칙
+- prefix는 반드시 [Mr.Stack]으로 시작
+- 한 줄로 끝내는 것이 원칙 (최대 100자)
+- 존댓말 사용하되 간결하게
+- 조치가 필요하면 "—" 뒤에 구체적 행동 제안
+- 정보 전달만이면 사실만 기술
+- 불필요한 이모지 사용 금지 (prefix의 [Mr.Stack]이 브랜딩 역할)
+- Jarvis ContextEngine 트리거에 의해 자동 발송
+- 긴급도에 따라 텔레그램 알림음 설정:
+  - 긴급 (배터리 < 10%, 서비스 장애): disable_notification=false
+  - 일반: disable_notification=true

mrstack/_data/templates/morning-briefing.md

@@ -0,0 +1,53 @@
+# Morning Briefing Template
+
+## 형식
+
+```
+━━━ Mr.Stack 모닝 브리핑 ━━━
+📅 {date} ({weekday})
+
+▸ 오늘 일정
+  {time} {title} ({location})
+  {time} {title} ({location})
+  — 일정 없음
+
+▸ Pending Tasks
+  ◻ {task_1}
+  ◻ {task_2}
+
+▸ AI/Tech 뉴스
+  · {headline_1} — {summary_1}
+  · {headline_2} — {summary_2}
+
+💡 어제 코칭: "{coaching_quote}"
+━━━━━━━━━━━━━━━━━━━━
+```
+
+## 텔레그램 HTML 변환
+
+```html
+<b>━━━ Mr.Stack 모닝 브리핑 ━━━</b>
+📅 {date} ({weekday})
+
+<b>▸ 오늘 일정</b>
+  {time} {title} ({location})
+
+<b>▸ Pending Tasks</b>
+  ◻ {task}
+
+<b>▸ AI/Tech 뉴스</b>
+  · {headline} — {summary}
+
+💡 <i>어제 코칭: "{coaching_quote}"</i>
+━━━━━━━━━━━━━━━━━━━━
+```
+
+## 규칙
+- 전체 길이: 최대 1500자
+- 일정이 없으면 "— 일정 없음" 한 줄로
+- 뉴스는 최대 3개, 1줄 요약
+- Pending Tasks 최대 5개
+- 코칭 라인은 어제 evening-summary의 코칭 노트에서 핵심 1줄 발췌
+- 구분선: ━ (U+2501) 사용, 상단 20자 / 하단 20자
+- 섹션 prefix: ▸ (U+25B8)
+- 한국어로 작성

mrstack/_data/templates/weekly-review.md

@@ -0,0 +1,79 @@
+# Weekly Review Template
+
+## 형식
+
+```
+━━━ Mr.Stack 주간 회고 ━━━
+📊 {start_date} ~ {end_date}
+
+▸ 주간 통계
+  총 대화: {total_conversations}회 | 커밋: {total_commits}개
+  가장 생산적: {best_day} ({best_day_count}회)
+  피크 시간: {peak_hours}
+
+▸ 프로젝트별
+  {project_1}  {bar_1} {pct_1}%
+  {project_2}  {bar_2} {pct_2}%
+  {project_3}  {bar_3} {pct_3}%
+
+▸ 이번 주 잘한 점
+  · {highlight_1}
+  · {highlight_2}
+
+▸ 주요 결정사항
+  · {decision_1}: {reason_1}
+
+▸ 배운 것
+  · {learning_1}
+
+▸ 다음 주 추천
+  · {recommendation_1}
+  · {recommendation_2}
+
+🏷️ 키워드: {keyword_1}, {keyword_2}, {keyword_3}
+━━━━━━━━━━━━━━━━━━━━
+```
+
+## 텔레그램 HTML 변환
+
+```html
+<b>━━━ Mr.Stack 주간 회고 ━━━</b>
+📊 {start_date} ~ {end_date}
+
+<b>▸ 주간 통계</b>
+  총 대화: {total_conversations}회 | 커밋: {total_commits}개
+  가장 생산적: {best_day} ({best_day_count}회)
+  피크 시간: {peak_hours}
+
+<b>▸ 프로젝트별</b>
+  {project_1}  {bar_1} {pct_1}%
+  {project_2}  {bar_2} {pct_2}%
+
+<b>▸ 이번 주 잘한 점</b>
+  · {highlight}
+
+<b>▸ 주요 결정사항</b>
+  · {decision}: {reason}
+
+<b>▸ 배운 것</b>
+  · {learning}
+
+<b>▸ 다음 주 추천</b>
+  · {recommendation}
+
+🏷️ <i>키워드: {keyword_1}, {keyword_2}, {keyword_3}</i>
+━━━━━━━━━━━━━━━━━━━━
+```
+
+## 프로그레스 바 생성 규칙
+- 10칸 기준: █ (채워진) + ░ (빈)
+- 퍼센트를 10으로 나눠서 반올림한 개수만큼 █
+- 예: 40% → ████░░░░░░
+
+## 규칙
+- ~/claude-telegram/memory/daily/ 파일 기반으로 작성
+- 성과는 구체적 결과물 중심 (커밋 수, 완료 태스크 수 포함)
+- 결정사항은 "왜"를 반드시 포함
+- 다음 주 추천은 데이터 기반 (피크 시간, 생산적 패턴 분석)
+- 전체 길이: 최대 2000자
+- 한국어로 작성

mrstack/_overlay/api/dashboard.py

@@ -0,0 +1,223 @@
+"""Dashboard Mini App API for Telegram Web App.
+
+Serves a single-page dashboard and JSON APIs for:
+- Usage statistics
+- Scheduled jobs (list, toggle, run)
+- Memory status
+- Recent activity timeline
+"""
+
+import json
+from datetime import datetime, timedelta
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+import structlog
+from fastapi import APIRouter, HTTPException, Request
+from fastapi.responses import HTMLResponse
+
+logger = structlog.get_logger()
+
+dashboard_router = APIRouter(prefix="/dashboard", tags=["dashboard"])
+
+# Path to dashboard HTML template
+_TEMPLATE_DIR = Path(__file__).parent / "templates"
+
+
+@dashboard_router.get("/", response_class=HTMLResponse)
+async def serve_dashboard() -> HTMLResponse:
+    """Serve the dashboard HTML."""
+    template_path = _TEMPLATE_DIR / "dashboard.html"
+    if not template_path.exists():
+        raise HTTPException(status_code=404, detail="Dashboard template not found")
+    return HTMLResponse(content=template_path.read_text(encoding="utf-8"))
+
+
+@dashboard_router.get("/api/stats")
+async def get_stats(request: Request) -> Dict[str, Any]:
+    """Return usage statistics."""
+    db_manager = request.app.state.db_manager
+    if not db_manager:
+        return {"error": "Database not available"}
+
+    try:
+        async with db_manager.get_connection() as conn:
+            # Total interactions today
+            today = datetime.now().strftime("%Y-%m-%d")
+            cursor = await conn.execute(
+                "SELECT COUNT(*) FROM claude_interactions "
+                "WHERE created_at >= ?",
+                (today,),
+            )
+            row = await cursor.fetchone()
+            today_count = row[0] if row else 0
+
+            # Total sessions
+            cursor = await conn.execute(
+                "SELECT COUNT(DISTINCT session_id) FROM claude_interactions"
+            )
+            row = await cursor.fetchone()
+            total_sessions = row[0] if row else 0
+
+            # Active jobs count
+            cursor = await conn.execute(
+                "SELECT COUNT(*) FROM scheduled_jobs WHERE is_active = 1"
+            )
+            row = await cursor.fetchone()
+            active_jobs = row[0] if row else 0
+
+            return {
+                "today_interactions": today_count,
+                "total_sessions": total_sessions,
+                "active_jobs": active_jobs,
+                "timestamp": datetime.now().isoformat(),
+            }
+    except Exception as e:
+        logger.error("Failed to get stats", error=str(e))
+        return {"error": str(e)}
+
+
+@dashboard_router.get("/api/jobs")
+async def get_jobs(request: Request) -> List[Dict[str, Any]]:
+    """Return scheduled jobs list."""
+    db_manager = request.app.state.db_manager
+    if not db_manager:
+        return []
+
+    try:
+        async with db_manager.get_connection() as conn:
+            cursor = await conn.execute(
+                "SELECT job_name, cron_expression, is_active, "
+                "last_run_at, next_run_at "
+                "FROM scheduled_jobs ORDER BY job_name"
+            )
+            rows = await cursor.fetchall()
+
+        return [
+            {
+                "name": row[0],
+                "cron": row[1],
+                "active": bool(row[2]),
+                "last_run": row[3],
+                "next_run": row[4],
+            }
+            for row in rows
+        ]
+    except Exception as e:
+        logger.error("Failed to get jobs", error=str(e))
+        return []
+
+
+@dashboard_router.post("/api/jobs/{name}/toggle")
+async def toggle_job(name: str, request: Request) -> Dict[str, Any]:
+    """Toggle a scheduled job on/off."""
+    db_manager = request.app.state.db_manager
+    if not db_manager:
+        raise HTTPException(status_code=500, detail="Database not available")
+
+    try:
+        async with db_manager.get_connection() as conn:
+            cursor = await conn.execute(
+                "SELECT is_active FROM scheduled_jobs WHERE job_name = ?",
+                (name,),
+            )
+            row = await cursor.fetchone()
+            if not row:
+                raise HTTPException(status_code=404, detail=f"Job not found: {name}")
+
+            new_state = not bool(row[0])
+            await conn.execute(
+                "UPDATE scheduled_jobs SET is_active = ? WHERE job_name = ?",
+                (int(new_state), name),
+            )
+            await conn.commit()
+
+        return {"name": name, "active": new_state}
+    except HTTPException:
+        raise
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
+
+@dashboard_router.post("/api/jobs/{name}/run")
+async def run_job(name: str, request: Request) -> Dict[str, Any]:
+    """Trigger immediate job execution."""
+    event_bus = getattr(request.app.state, "event_bus", None)
+    if not event_bus:
+        raise HTTPException(status_code=500, detail="Event bus not available")
+
+    from ..events.types import ScheduledEvent
+
+    settings = getattr(request.app.state, "settings", None)
+    working_dir = Path(".")
+    chat_ids: list = []
+    if settings:
+        working_dir = settings.approved_directory
+        chat_ids = settings.notification_chat_ids or []
+
+    event = ScheduledEvent(
+        job_name=name,
+        working_directory=working_dir,
+        target_chat_ids=chat_ids,
+    )
+    await event_bus.publish(event)
+
+    return {"name": name, "status": "triggered"}
+
+
+@dashboard_router.get("/api/memory")
+async def get_memory(request: Request) -> Dict[str, Any]:
+    """Return memory system status."""
+    memory_dir = Path.home() / "claude-telegram" / "memory"
+    if not memory_dir.exists():
+        return {"status": "not_configured", "files": []}
+
+    files = []
+    for p in sorted(memory_dir.rglob("*.md")):
+        rel = p.relative_to(memory_dir)
+        files.append({
+            "path": str(rel),
+            "size": p.stat().st_size,
+            "modified": datetime.fromtimestamp(p.stat().st_mtime).isoformat(),
+        })
+
+    patterns_file = memory_dir / "patterns" / "interactions.jsonl"
+    interaction_count = 0
+    if patterns_file.exists():
+        interaction_count = sum(1 for _ in patterns_file.open())
+
+    return {
+        "status": "active",
+        "file_count": len(files),
+        "files": files[:20],
+        "interaction_count": interaction_count,
+    }
+
+
+@dashboard_router.get("/api/activity")
+async def get_activity(request: Request) -> List[Dict[str, Any]]:
+    """Return recent interaction timeline."""
+    db_manager = request.app.state.db_manager
+    if not db_manager:
+        return []
+
+    try:
+        async with db_manager.get_connection() as conn:
+            cursor = await conn.execute(
+                "SELECT prompt, session_id, created_at "
+                "FROM claude_interactions "
+                "ORDER BY created_at DESC LIMIT 20"
+            )
+            rows = await cursor.fetchall()
+
+        return [
+            {
+                "prompt": row[0][:100] if row[0] else "",
+                "session_id": row[1][:8] if row[1] else "",
+                "timestamp": row[2],
+            }
+            for row in rows
+        ]
+    except Exception as e:
+        logger.error("Failed to get activity", error=str(e))
+        return []