create-arete-workspace 0.2.0

package/packages/gatsaeng-os/src/types/index.ts

@@ -0,0 +1,320 @@
+// ─── Base Types ───
+export type GoalStatus = 'active' | 'completed' | 'archived'
+export type TaskStatus = 'backlog' | 'todo' | 'doing' | 'done'
+export type TaskPriority = 'low' | 'medium' | 'high' | 'urgent'
+export type EnergyLevel = 'low' | 'medium' | 'high'
+export type ViewType = 'kanban' | 'table' | 'calendar' | 'list'
+export type SessionType = 'pomodoro_25' | 'focus_90' | 'deep_work'
+export type TriggerType = 'time' | 'event' | 'location'
+export type WidgetId = 'routine' | 'goals' | 'heatmap' | 'kanban' | 'timer' | 'zeigarnik' | 'energy' | 'dday' | 'proactive'
+export type ReviewType = 'daily' | 'weekly' | 'monthly'
+export type CreatedBy = 'user' | 'ai'
+
+// ─── Area (영역) ───
+export interface Area {
+  id: string
+  title: string
+  icon: string
+  status: GoalStatus
+  linked_goals: string[]
+  created?: string
+}
+
+// ─── Goal (목표) ───
+export interface KeyMetric {
+  name: string
+  current: number
+  target: number
+  unit: string
+}
+
+export interface Goal {
+  id: string
+  area_id?: string
+  title: string
+  description?: string
+  type: string
+  status: GoalStatus
+  color: string
+  created?: string
+  ai_next_review?: string
+  ai_diagnosis?: string
+  ai_direction?: string
+  linked_milestones: string[]
+  linked_routines: string[]
+  linked_projects: string[]
+  key_metrics: KeyMetric[]
+  why_statement?: string
+  identity_statement?: string
+  when_where_how?: string
+  // v2 compat
+  target_value?: number
+  current_value?: number
+  unit?: string
+  due_date?: string
+  core_value?: string
+  created_at?: string
+  updated_at?: string
+}
+
+// ─── Milestone (마일스톤) ───
+export interface Milestone {
+  id: string
+  goal_id: string
+  title: string
+  target_value: number
+  current_value: number
+  unit: string
+  due_date: string
+  status: GoalStatus
+  created_by: CreatedBy
+  created?: string
+}
+
+// ─── Project (프로젝트) ───
+export interface Project {
+  id: string
+  goal_id?: string
+  milestone_id?: string
+  title: string
+  description?: string
+  status: GoalStatus
+  color: string
+  due_date?: string
+  default_view: ViewType
+  created_by?: CreatedBy
+  created_at: string
+  updated_at: string
+}
+
+// ─── Task (프로젝트 소속 태스크 — 개별 파일) ───
+export interface Task {
+  id: string
+  project_id: string
+  parent_task_id?: string
+  title: string
+  description?: string
+  status: TaskStatus
+  priority: TaskPriority
+  energy_required?: EnergyLevel
+  tag?: string
+  due_date?: string
+  position: number
+  goal_ids?: string[]
+  area_id?: string
+  created_at: string
+  updated_at: string
+}
+
+// ─── Book (독서) ───
+export type BookStatus = 'reading' | 'completed' | 'want_to_read' | 'dropped'
+
+export interface Book {
+  id: string
+  title: string
+  author: string
+  status: BookStatus
+  rating?: number
+  total_pages?: number
+  current_page?: number
+  goal_id?: string
+  started_at?: string
+  finished_at?: string
+  created_at?: string
+}
+
+// ─── CalendarEvent (캘린더) ───
+export type CalendarCategory = 'work' | 'personal' | 'health' | 'study' | 'social' | 'other'
+
+export interface CalendarEvent {
+  id: string
+  title: string
+  date: string
+  time_start?: string
+  time_end?: string
+  all_day?: boolean
+  category?: CalendarCategory
+  location?: string
+  description?: string
+  goal_id?: string
+  created_by?: 'user' | 'ai' | 'telegram'
+  created_at?: string
+}
+
+// ─── Note (노트) ───
+export type NoteType = 'note' | 'file' | 'reference' | 'link'
+export type NotePriority = 1 | 2 | 3
+
+export interface Note {
+  id: string
+  title: string
+  type: NoteType
+  priority: NotePriority
+  area_id?: string
+  project_id?: string
+  url?: string
+  created_at: string
+  updated_at: string
+}
+
+// ─── DailyManifest (일일 매니페스트 — 날짜별 파일) ───
+export interface DailyManifest {
+  date: string
+  gatsaeng_score: number
+  routines_done: number
+  routines_total: number
+  focus_minutes: number
+}
+
+// ─── Routine (루틴) ───
+export interface Routine {
+  id: string
+  title: string
+  area_id?: string
+  goal_id?: string
+  scheduled_time?: string
+  scheduled_days: number[]
+  trigger_cue?: string
+  trigger_type: TriggerType
+  after_routine_id?: string | null
+  reward_note?: string
+  energy_required: EnergyLevel
+  streak: number
+  longest_streak: number
+  is_active: boolean
+  position: number
+  created_by?: CreatedBy
+  created?: string
+  // v2 compat
+  days_of_week?: number[]
+  created_at?: string
+}
+
+export interface RoutineCompletion {
+  routine_id: string
+  completed_at: string
+  mood?: number
+}
+
+export interface RoutineLog {
+  date: string
+  completions: RoutineCompletion[]
+}
+
+// ─── Energy ───
+export interface EnergyEntry {
+  hour: number
+  level: number
+  note?: string
+}
+
+export interface EnergyLog {
+  date: string
+  entries: EnergyEntry[]
+}
+
+// ─── Focus Session ───
+export interface FocusSession {
+  id: string
+  date?: string
+  task_id?: string
+  duration_minutes: number
+  session_type: SessionType
+  energy_level?: number
+  completed: boolean
+  started_at: string
+}
+
+// ─── Review (회고) ───
+export interface Review {
+  id?: string
+  type: ReviewType
+  // daily
+  date?: string
+  // weekly
+  week?: string
+  week_start?: string
+  week_end?: string
+  routines_completion_rate?: number
+  tasks_completed?: number
+  gatsaeng_score_total?: number
+  ai_reanalysis_triggered?: boolean
+  goal_ids_to_review?: string[]
+  // shared
+  accomplished?: string
+  struggled?: string
+  learnings?: string
+  next_week_focus?: string
+  energy_pattern?: string
+  habit_insight?: string
+  mood?: number
+  score?: number
+  created_at?: string
+}
+
+// ─── Profile ───
+export interface Profile {
+  display_name: string
+  level: number
+  total_score: number
+  longest_streak: number
+  current_streak: number
+  peak_hours: number[]
+  dashboard_widgets: WidgetId[]
+  created_at: string
+  updated_at: string
+}
+
+// ─── Derived / UI Types ───
+export interface RoutineWithStatus extends Routine {
+  completed_today: boolean
+}
+
+export interface MilestoneWithDDay extends Milestone {
+  d_day: number
+}
+
+export interface GoalWithMilestones extends Goal {
+  milestones: MilestoneWithDDay[]
+  area?: Area
+}
+
+export interface ProactiveAlert {
+  id: string
+  type: 'skipped_routine' | 'deadline' | 'milestone_dday' | 'reanalysis_due'
+  title: string
+  message: string
+  actions?: { label: string; value: string }[]
+  created_at: string
+}
+
+export type ScoreEventType =
+  | 'routine_complete'
+  | 'task_done'
+  | 'task_done_urgent'
+  | 'milestone_complete'
+  | 'review_written'
+  | 'data_uploaded'
+  | 'goal_25pct'
+  | 'goal_50pct'
+  | 'goal_100pct'
+
+export interface ScoreEvent {
+  type: ScoreEventType
+  streakCount?: number
+}
+
+export interface ScoreResult {
+  points: number
+  bonus_message: string | null
+}
+
+// ─── Constraints (제약 원칙) ───
+export const LIMITS = {
+  MAX_ACTIVE_GOALS: 5,
+  MAX_ACTIVE_ROUTINES: 6,
+  MAX_DAILY_TASKS: 6,
+  MAX_ACTIVE_PROJECTS: 3,
+  MAX_MILESTONES_PER_GOAL: 4,
+  MIN_REANALYSIS_WEEKS: 2,
+} as const

package/packages/gatsaeng-os/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

package/templates/scripts/forge_qa.sh.tmpl

@@ -0,0 +1,237 @@
+#!/usr/bin/env bash
+set -e
+
+# forge_qa.sh — Diff-based visual QA via OpenClaw browser
+# Changed files → affected pages → screenshot capture
+
+###############################################################################
+# Config
+###############################################################################
+SCREENSHOT_DIR="/tmp/qa_screenshots"
+DATE_TAG=$(date +%Y%m%d)
+OPENCLAW_BIN=$(command -v openclaw || echo "/opt/homebrew/bin/openclaw")
+GATEWAY_PORT=4000
+
+###############################################################################
+# Usage
+###############################################################################
+usage() {
+  cat <<EOF
+Usage: $(basename "$0") --repo <path> [--url <base_url>] [--quick]
+
+Options:
+  --repo <path>       Git repo root (required)
+  --url <base_url>    Base URL for the app (default: http://localhost:3000)
+  --quick             Quick mode: home + 1 key page only
+  -h, --help          Show this help
+EOF
+  exit 0
+}
+
+###############################################################################
+# Parse args
+###############################################################################
+REPO=""
+BASE_URL=""
+QUICK=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)   REPO="$2"; shift 2 ;;
+    --url)    BASE_URL="$2"; shift 2 ;;
+    --quick)  QUICK=true; shift ;;
+    -h|--help) usage ;;
+    *) echo "Unknown option: $1"; usage ;;
+  esac
+done
+
+if [[ -z "$REPO" ]]; then
+  echo "ERROR: --repo is required"
+  usage
+fi
+
+if [[ ! -d "$REPO/.git" ]]; then
+  echo "ERROR: $REPO is not a git repository"
+  exit 1
+fi
+
+###############################################################################
+# Auto-detect base URL
+###############################################################################
+if [[ -z "$BASE_URL" ]]; then
+  BASE_URL="http://localhost:3000"
+  echo "Using default base URL: $BASE_URL"
+fi
+
+###############################################################################
+# Prepare screenshot dir
+###############################################################################
+mkdir -p "$SCREENSHOT_DIR"
+
+###############################################################################
+# Get changed files
+###############################################################################
+echo ""
+echo "=== Diff Analysis ==="
+CHANGED_FILES=$(cd "$REPO" && git diff --name-only origin/main..HEAD 2>/dev/null || true)
+
+if [[ -z "$CHANGED_FILES" ]]; then
+  CHANGED_FILES=$(cd "$REPO" && git diff --name-only HEAD 2>/dev/null || true)
+fi
+
+if [[ -z "$CHANGED_FILES" ]]; then
+  echo "No changed files detected. Nothing to QA."
+  exit 0
+fi
+
+FILE_COUNT=$(echo "$CHANGED_FILES" | wc -l | tr -d ' ')
+echo "Changed files ($FILE_COUNT):"
+echo "$CHANGED_FILES" | sed 's/^/  /'
+
+###############################################################################
+# Map changed files → affected routes
+###############################################################################
+declare -a PAGES=()
+declare -a PAGE_NAMES=()
+
+add_page() {
+  local route="$1"
+  local name="$2"
+  for existing in "${PAGES[@]}"; do
+    [[ "$existing" == "$route" ]] && return
+  done
+  PAGES+=("$route")
+  PAGE_NAMES+=("$name")
+}
+
+# Always include home
+add_page "/" "home"
+
+while IFS= read -r file; do
+  [[ -z "$file" ]] && continue
+
+  # App router pages → direct route
+  if [[ "$file" =~ ^(web/)?(src/)?app/(.+)/page\.(tsx|ts|jsx|js)$ ]]; then
+    route="/${BASH_REMATCH[3]}"
+    route=$(echo "$route" | sed 's|/\(([^)]*)\)||g; s|//|/|g')
+    name=$(echo "$route" | tr '/' '_' | sed 's/^_//')
+    [[ -z "$name" ]] && name="root"
+    add_page "$route" "$name"
+    continue
+  fi
+
+  # Layout/template changes → affected route
+  if [[ "$file" =~ ^(web/)?(src/)?app/(.+)/(layout|template)\.(tsx|ts|jsx|js)$ ]]; then
+    route="/${BASH_REMATCH[3]}"
+    route=$(echo "$route" | sed 's|/\(([^)]*)\)||g; s|//|/|g')
+    name=$(echo "$route" | tr '/' '_' | sed 's/^_//; s/$/_layout/')
+    add_page "$route" "$name"
+    continue
+  fi
+
+  # Global CSS → home
+  if [[ "$file" =~ \.(css|scss|sass)$ ]] && [[ "$file" =~ global ]]; then
+    add_page "/" "home"
+  fi
+
+done <<< "$CHANGED_FILES"
+
+###############################################################################
+# Quick mode: trim to home + 1 key page
+###############################################################################
+if $QUICK && [[ ${#PAGES[@]} -gt 2 ]]; then
+  PAGES=("${PAGES[0]}" "${PAGES[1]}")
+  PAGE_NAMES=("${PAGE_NAMES[0]}" "${PAGE_NAMES[1]}")
+  echo ""
+  echo "(--quick mode: limited to ${#PAGES[@]} pages)"
+fi
+
+echo ""
+echo "=== Pages to QA (${#PAGES[@]}) ==="
+for i in "${!PAGES[@]}"; do
+  echo "  ${PAGE_NAMES[$i]}  →  ${PAGES[$i]}"
+done
+
+###############################################################################
+# Screenshot helper
+###############################################################################
+take_screenshot() {
+  local url="$1"
+  local output_path="$2"
+
+  if [[ -x "$OPENCLAW_BIN" ]]; then
+    "$OPENCLAW_BIN" browser navigate "$url" --timeout 15000 2>/dev/null || true
+    "$OPENCLAW_BIN" browser wait --load networkidle --timeout-ms 10000 2>/dev/null || true
+    local result
+    result=$("$OPENCLAW_BIN" browser screenshot --json --full-page 2>/dev/null || echo '{"ok":false}')
+    local ok
+    ok=$(echo "$result" | python3 -c "import sys,json; print(json.load(sys.stdin).get('ok',False))" 2>/dev/null || echo "False")
+    if [[ "$ok" == "True" ]]; then
+      local media_path
+      media_path=$(echo "$result" | python3 -c "import sys,json; print(json.load(sys.stdin).get('path',''))" 2>/dev/null)
+      if [[ -n "$media_path" && -f "$media_path" ]]; then
+        cp "$media_path" "$output_path"
+        return 0
+      fi
+    fi
+  fi
+
+  echo "  WARNING: screenshot failed for $url"
+  return 1
+}
+
+###############################################################################
+# Capture screenshots
+###############################################################################
+echo ""
+echo "=== Capturing Screenshots ==="
+
+declare -a CAPTURED=()
+FAIL_COUNT=0
+
+if [[ -x "$OPENCLAW_BIN" ]]; then
+  "$OPENCLAW_BIN" browser start 2>/dev/null || true
+  sleep 1
+fi
+
+for i in "${!PAGES[@]}"; do
+  route="${PAGES[$i]}"
+  name="${PAGE_NAMES[$i]}"
+  url="${BASE_URL}${route}"
+  safe_name=$(echo "$name" | tr -cs 'a-zA-Z0-9_-' '_' | sed 's/_$//')
+  output_file="${SCREENSHOT_DIR}/${DATE_TAG}_${safe_name}.png"
+
+  echo -n "  [$((i+1))/${#PAGES[@]}] ${name} (${url}) ... "
+
+  if take_screenshot "$url" "$output_file"; then
+    echo "OK → $output_file"
+    CAPTURED+=("$output_file")
+  else
+    echo "FAIL"
+    FAIL_COUNT=$((FAIL_COUNT + 1))
+  fi
+done
+
+###############################################################################
+# Summary
+###############################################################################
+echo ""
+echo "========================================="
+echo "  Forge QA Summary"
+echo "========================================="
+echo "  Changed files:     $FILE_COUNT"
+echo "  Pages tested:      ${#PAGES[@]}"
+echo "  Screenshots OK:    ${#CAPTURED[@]}"
+echo "  Screenshots FAIL:  $FAIL_COUNT"
+echo "  Output dir:        $SCREENSHOT_DIR"
+echo ""
+
+if [[ ${#CAPTURED[@]} -gt 0 ]]; then
+  echo "  Screenshots:"
+  for f in "${CAPTURED[@]}"; do
+    echo "    $f"
+  done
+fi
+
+echo ""
+echo "========================================="