claude-pet 2.0.0

package/docs/superpowers/specs/2026-03-14-v1.1-features-design.md

@@ -0,0 +1,342 @@
+# v1.1 Features Design Spec
+
+**Date:** 2026-03-14
+**Features:** Always on Top, Contextual Messages, Achievement Badges, Custom Character Skins
+
+---
+
+## Feature A: Always on Top
+
+### Overview
+데스크톱 마스코트 특성상 항상 다른 윈도우 위에 표시되어야 하므로, `alwaysOnTop` 설정을 추가한다.
+
+### Design
+- `MamaSettings`에 `alwaysOnTop: boolean` 추가 (기본값 `true`)
+- `createWindow()`에서 기존 하드코딩된 `alwaysOnTop: true` (main.ts:115)를 `alwaysOnTop: store.get('alwaysOnTop', true)`로 교체
+- `ipc-handlers.ts`의 `SETTINGS_SET` 핸들러에서 `alwaysOnTop` 변경 시 `mainWindow.setAlwaysOnTop(value)` 호출 (mainWindow 파라미터는 `registerIpcHandlers()`에서 이미 전달됨)
+- `ipc-handlers.ts`의 store `defaults`에 `alwaysOnTop: true` 추가
+- Settings 페이지에 토글 UI 추가
+- 트레이 메뉴에 체크박스 토글 추가 (빠른 접근)
+
+### Files to Modify
+| File | Change |
+|------|--------|
+| `src/shared/types.ts` | `MamaSettings`에 `alwaysOnTop` 필드 추가 |
+| `src/main/main.ts` | `createWindow()`에 `alwaysOnTop` 옵션, 설정 변경 리스너 |
+| `src/main/ipc-handlers.ts` | `SETTINGS_SET`에서 `alwaysOnTop` 변경 시 `setAlwaysOnTop()` 호출 |
+| `src/main/tray.ts` | 트레이 메뉴에 "Always on Top" 체크박스 추가 |
+| `src/renderer/pages/Settings.tsx` | 토글 UI 추가 |
+| `src/shared/i18n.ts` | "항상 위에" 번역 문자열 |
+
+---
+
+## Feature B: Contextual Messages (상황 인식 메시지)
+
+### Overview
+기존 무드 기반 메시지에 상황 인식을 추가하여 더 자연스러운 메시지를 보여준다. 상황 조건이 매칭되면 상황 메시지를 우선 표시하고, 아니면 기존 무드 메시지로 fallback한다.
+
+### Contextual Triggers
+
+| 상황 | 조건 | 적용 무드 |
+|------|------|----------|
+| **요일 (주말)** | `now.getDay()` === 0 or 6 | 모든 무드 |
+| **연속 미사용** | `dailyHistory`에서 N일 연속 percent === 0 (N >= 2) | angry, worried |
+| **급증** | 전일 대비 30%+ 증가 | happy, proud |
+| **리셋 임박** | 리셋까지 3시간 이내 + 주간 50% 미만 | worried, angry |
+
+### Message Selection Logic
+
+```
+getContextualMessage(mood, locale, context):
+  1. Evaluate context triggers in priority order:
+     - 연속 미사용 (highest - most urgent)
+     - 리셋 임박
+     - 급증
+     - 요일 (lowest - most general)
+  2. If trigger matches AND has messages for current mood:
+     return contextual message (time-seeded rotation within context pool)
+  3. Else:
+     return getMessage(mood, locale)  // existing fallback
+```
+
+### Context Message Pools
+
+Contextual messages only apply to `MamaMood` types (angry, worried, happy, proud) — not to error expressions (confused, sleeping) or special states (fiveHourWarning, rateLimited). The `MoodKey` type in `messages.ts` is a local alias and should NOT be reused here.
+
+```typescript
+const CONTEXTUAL_POOLS: Record<ContextTrigger, Partial<Record<MamaMood, Record<Locale, string[]>>>> = {
+  weekend: {
+    angry: {
+      ko: ["주말인데 토큰 안 쓰면 월요일에 후회한다?", ...],
+      en: ["Not using tokens on a weekend? Monday-you will regret it!", ...],
+      ja: [...],
+      zh: [...],
+    },
+    happy: {
+      ko: ["주말에도 열심히 하네~ 역시 내 자식!", ...],
+      ...
+    },
+    // ... other moods
+  },
+  unusedStreak: { ... },
+  spike: { ... },
+  resetImminent: { ... },
+};
+```
+
+### Required Context Extensions
+
+기존 `TriggerContext`에 `resetsAt` 필드를 추가하여 확장. 별도 `MessageContext`를 만들지 않고 `TriggerContext`를 재사용하여 Feature C의 `BadgeTriggerContext extends TriggerContext`와도 일관성 유지.
+
+```typescript
+// types.ts — TriggerContext에 추가
+interface TriggerContext {
+  // ... existing fields ...
+  resetsAt: string | null;       // ISO timestamp — for resetImminent trigger
+}
+```
+
+**Integration with `computeMood` pipeline:** 현재 `main.ts`에서 `getMessage(mood, locale)`을 직접 호출하는 부분을 `getContextualMessage(mood, locale, triggerContext)`로 교체. `computeMood()` 자체는 수정하지 않음 — mood 계산과 메시지 선택을 분리.
+
+**`dailyHistory` 제약:** `dailyHistory`는 최근 14일로 제한됨 (`main.ts`에서 `slice(-14)`). 따라서 `unusedStreak`은 최대 14일까지만 감지 가능.
+
+### Message Count Target
+
+각 트리거당 무드당 5개 이상의 메시지 (4개 언어 × 4개 트리거 × 해당 무드 × 5개 = 상당량).
+초기에는 트리거당 주요 무드 2~3개만 커버하고 점진적으로 확장.
+
+| Trigger | Covered Moods | Messages per mood per locale | Total (4 lang) |
+|---------|--------------|------------------------------|----------------|
+| weekend | angry, worried, happy, proud | 5 | 80 |
+| unusedStreak | angry, worried | 5 | 40 |
+| spike | happy, proud | 5 | 40 |
+| resetImminent | angry, worried | 5 | 40 |
+| **Total** | | | **200** |
+
+### Files to Create/Modify
+| File | Change |
+|------|--------|
+| `src/core/contextual-messages.ts` | **New** — context trigger evaluation + message pools |
+| `src/core/messages.ts` | Export helper, keep existing pools unchanged |
+| `src/shared/types.ts` | `MessageContext` interface, `ContextTrigger` type |
+| `src/main/main.ts` | Pass context to message selection |
+| `src/core/__tests__/contextual-messages.test.ts` | **New** — trigger logic tests |
+
+---
+
+## Feature C: Achievement Badges
+
+### Overview
+사용량 마일스톤, 연속 사용, 엄마 관계 기반의 업적 배지 시스템. 기존 Collection(도감) 페이지에 탭으로 추가.
+
+### Badge Tiers
+
+| Tier | Color | 난이도 |
+|------|-------|--------|
+| Bronze | #CD7F32 | 쉬움 — 기본 사용으로 달성 |
+| Silver | #C0C0C0 | 보통 — 꾸준한 사용 필요 |
+| Gold | #FFD700 | 어려움 — 장기 헌신 필요 |
+
+### Badge Registry
+
+| ID | Tier | Name (ko) | Name (en) | Condition |
+|----|------|-----------|-----------|-----------|
+| `badge_first_call` | Bronze | 첫 걸음 | First Steps | 첫 API 호출 (`firstApiCallSeen` transition) |
+| `badge_streak_3` | Bronze | 3일 연속 | 3-Day Streak | dailyHistory 3일 연속 percent > 0 |
+| `badge_mama_7days` | Bronze | 엄마와 7일 | 7 Days with Mom | 설치 후 7일 경과 |
+| `badge_half` | Silver | 반타작 | Halfway There | 주간 50% 달성 |
+| `badge_streak_7` | Silver | 7일 연속 | 7-Day Streak | dailyHistory 7일 연속 percent > 0 |
+| `badge_proud_10` | Silver | 자랑스러운 아들 | Mom's Pride | proud 상태 누적 10회 |
+| `badge_full` | Gold | 풀 가동 | Full Power | 주간 100% 달성 |
+| `badge_streak_30` | Gold | 30일 연속 | 30-Day Streak | dailyHistory 30일 연속 percent > 0 |
+| `badge_survivor` | Gold | 생존왕 | Survivor | angry 상태 누적 10회 후에도 계속 사용 |
+
+### Architecture
+
+**QuoteCollectionManager 패턴을 따름:**
+
+```typescript
+interface BadgeEntry {
+  id: string;
+  tier: 'bronze' | 'silver' | 'gold';
+  name: Record<Locale, string>;
+  description: Record<Locale, string>;
+  icon: string;  // emoji or icon identifier
+}
+
+interface UnlockedBadge {
+  id: string;
+  unlockedAt: string; // ISO
+}
+
+interface BadgeState {
+  unlocked: UnlockedBadge[];
+  totalCount: number;
+  byTier: Record<BadgeTier, { unlocked: number; total: number }>;
+}
+```
+
+**Pure functions:**
+- `badge-registry.ts` — badge definitions
+- `badge-triggers.ts` — `evaluateBadgeTriggers(ctx): string[]`
+- `badge-manager.ts` — unlock state management
+
+**Persistence context extensions:**
+
+배지 트리거 평가를 위해 추가 통계가 필요:
+
+```typescript
+interface BadgeTriggerContext extends TriggerContext {
+  proudCount: number;     // 누적 proud 상태 횟수
+  angryCount: number;     // 누적 angry 상태 횟수
+}
+```
+
+`electron-store`에 저장 (기존 `(store as any).set()` 패턴 사용):
+- `unlockedBadges: UnlockedBadge[]`
+- `moodCounts: Record<MamaMood, number>` — 무드별 누적 횟수
+
+**`moodCounts` 증가 시점:** 무드가 이전 poll과 다를 때만 증가 (매 poll tick이 아님). `main.ts`의 polling loop에서 이전 무드를 추적하고, 무드 전환 시에만 카운트.
+
+**`badge_survivor` 조건 명확화:** `angryCount >= 10`이고 현재 `weeklyUtilization > 0`이면 해금. 즉, angry를 10번 이상 경험한 뒤에도 여전히 사용 중이면 달성.
+
+### UI
+
+- Collection 페이지 내부에 "명언 | 배지" 탭 추가 (기존 Settings의 `settings | collection` 탭 구조 아래 중첩 탭)
+- 배지 그리드: 아이콘 + 이름 + 설명
+- 미해금: 실루엣(grayscale) + "???" 표시
+- 해금 시: `BADGE_UNLOCKED` IPC 채널로 renderer에 통지 → 토스트 알림 (SpeechBubble 스타일 재활용)
+- 티어별 색상 border/glow
+
+### Files to Create/Modify
+
+| File | Change |
+|------|--------|
+| `src/shared/types.ts` | `BadgeEntry`, `UnlockedBadge`, `BadgeState`, `BadgeTier`, `BadgeTriggerContext`, IPC channels: `BADGE_GET`, `BADGE_UNLOCKED` |
+| `src/core/badge-registry.ts` | **New** — badge definitions (9 badges) |
+| `src/core/badge-triggers.ts` | **New** — `evaluateBadgeTriggers()` pure function |
+| `src/core/badge-manager.ts` | **New** — `BadgeManager` class |
+| `src/core/__tests__/badge-triggers.test.ts` | **New** — trigger tests |
+| `src/main/main.ts` | Badge evaluation in polling loop, mood count tracking |
+| `src/main/ipc-handlers.ts` | Badge IPC handlers |
+| `src/main/preload.ts` | Badge API exposure |
+| `src/renderer/pages/Collection.tsx` | 탭 UI, badge grid |
+| `src/renderer/electron.d.ts` | Badge API types |
+| `src/shared/i18n.ts` | Badge UI strings |
+
+---
+
+## Feature D: Custom Character Skins
+
+### Overview
+유저가 자신만의 캐릭터 이미지를 업로드하여 사용. 4가지 모드 지원 (default 포함).
+
+### Skin Modes
+
+| Mode | Input | Behavior |
+|------|-------|----------|
+| `default` | 없음 | 기본 claude-mama.png 사용 |
+| `single` | PNG 1장 | 전 무드 동일 이미지, MoodOverlay 이펙트 유지 |
+| `per-mood` | PNG 최대 6장 | 무드별 이미지, MoodOverlay 유지. 누락된 무드는 기본 claude-mama.png fallback |
+| `spritesheet` | PNG 1장 + grid config | row/column 그리드로 무드별 프레임 지정. `frameW = naturalWidth / columns`, `frameH = naturalHeight / rows` |
+
+### File Validation
+- 최대 파일 크기: 2MB
+- 최대 이미지 크기: 512x512px (프레임 기준)
+- PNG/JPG/GIF만 허용
+- 유효하지 않은 파일 업로드 시 에러 메시지 표시
+
+### Settings Data Structure
+
+```typescript
+type SkinMode = 'default' | 'single' | 'per-mood' | 'spritesheet';
+type Expression = MamaMood | MamaErrorExpression;
+
+interface SkinConfig {
+  mode: SkinMode;
+  // single mode
+  singleImagePath?: string;
+  // per-mood mode
+  moodImages?: Partial<Record<Expression, string>>;
+  // spritesheet mode
+  spritesheet?: {
+    imagePath: string;
+    columns: number;
+    rows: number;
+    moodMap: Record<Expression, { col: number; row: number }>;
+  };
+}
+```
+
+`MamaSettings`에 `skin?: SkinConfig` 추가. 기본값은 `{ mode: 'default' }`.
+
+### File Storage
+
+- 업로드 이미지를 `app.getPath('userData')/skins/` 에 복사
+- 파일명: `skin-{timestamp}.png`, `skin-{mood}-{timestamp}.png`
+- 설정에는 경로만 저장
+- **Cleanup:** 새 스킨 업로드 시 이전 스킨 파일 삭제 (orphan 방지). `skin-manager.ts`에서 관리
+
+### IPC
+
+| Channel | Direction | Purpose |
+|---------|-----------|---------|
+| `mama:upload-skin` | renderer → main | 파일 선택 다이얼로그 + 복사 |
+| `mama:reset-skin` | renderer → main | 기본 스킨으로 리셋 |
+| `mama:get-skin-config` | renderer → main | 현재 스킨 설정 조회 |
+
+### Character.tsx Changes
+
+```
+기존: mamaPng (하드코딩) → imgStyle에 적용
+변경: skinSrc를 props 또는 IPC로 받아서 적용
+
+single: src = singleImagePath
+per-mood: src = moodImages[expression] ?? fallback
+spritesheet: src = imagePath, objectPosition으로 프레임 선택
+  - objectFit: 'none'
+  - objectPosition: `-${col * frameW}px -${row * frameH}px`
+  - width/height: frameW/frameH
+```
+
+### Settings UI
+
+Settings 페이지에 "캐릭터" 섹션:
+
+1. **모드 선택**: 라디오 (기본 / 단일 이미지 / 무드별 / 스프라이트 시트)
+2. **단일 이미지**: 파일 업로드 버튼 + 미리보기
+3. **무드별**: 6개 업로드 슬롯 (angry, worried, happy, proud, confused, sleeping) + 각각 미리보기
+4. **스프라이트 시트**: 파일 업로드 + columns/rows 숫자 입력 + 무드별 (col, row) 매핑
+5. **기본으로 되돌리기** 버튼
+
+### Files to Create/Modify
+
+| File | Change |
+|------|--------|
+| `src/shared/types.ts` | `SkinConfig`, `SkinMode` types, IPC channels |
+| `src/main/skin-manager.ts` | **New** — 파일 복사, 경로 관리 |
+| `src/main/ipc-handlers.ts` | Skin upload/reset IPC handlers |
+| `src/main/preload.ts` | Skin API exposure |
+| `src/renderer/components/Character.tsx` | skinSrc 로직, spritesheet 렌더링 |
+| `src/renderer/pages/Settings.tsx` | 캐릭터 섹션 UI |
+| `src/renderer/electron.d.ts` | Skin API types |
+| `src/shared/i18n.ts` | Skin UI strings |
+
+---
+
+## Implementation Order
+
+```
+A (Always on Top) → B (Contextual Messages) → C (Badges) → D (Skins)
+```
+
+각 feature는 독립적이며 순차적으로 구현 가능. B와 C는 TriggerContext를 공유하므로 B에서 확장한 context를 C에서 재활용.
+
+## Testing Strategy
+
+| Feature | Test Type |
+|---------|-----------|
+| A | 수동 테스트 (Electron window 동작) |
+| B | Unit test: contextual trigger logic, message selection fallback |
+| C | Unit test: badge trigger evaluation, badge manager unlock logic |
+| D | 수동 테스트 (파일 업로드, 렌더링) |

package/electron-builder.yml

@@ -0,0 +1,75 @@
+appId: com.claudepet.app
+productName: Claude Pet
+directories:
+  output: release
+files:
+  - dist/**/*
+  - package.json
+  - "!dist/renderer/**/*.map"
+asar: true
+publish:
+  provider: github
+  owner: scm1400
+  repo: claude-pet
+win:
+  target:
+    - target: nsis
+      arch:
+        - x64
+  icon: build/icon.ico
+mac:
+  target:
+    - target: dmg
+      arch:
+        - x64
+        - arm64
+    - target: zip
+      arch:
+        - x64
+        - arm64
+  icon: build/icon.png
+  category: public.app-category.utilities
+  hardenedRuntime: true
+  gatekeeperAssess: true
+  entitlements: build/entitlements.mac.plist
+  entitlementsInherit: build/entitlements.mac.plist
+  notarize: false
+#afterSign: scripts/notarize.js
+linux:
+  target:
+    - target: AppImage
+      arch:
+        - x64
+    - target: deb
+      arch:
+        - x64
+  icon: build/icon.png
+  category: Utility
+nsis:
+  oneClick: true
+  allowToChangeInstallationDirectory: false
+  perMachine: false
+  createDesktopShortcut: true
+  createStartMenuShortcut: true
+  installerSidebar: build/installerSidebar.bmp
+  uninstallerSidebar: build/installerSidebar.bmp
+  installerHeader: build/installerHeader.bmp
+dmg:
+  writeUpdateInfo: false
+  background: build/dmg-background.png
+  window:
+    width: 540
+    height: 380
+  contents:
+    - x: 140
+      y: 250
+      type: file
+    - x: 400
+      y: 250
+      type: link
+      path: /Applications
+extraResources:
+  - from: build/tray-icon.png
+    to: tray-icon.png
+extraMetadata:
+  main: dist/main/main/main.js

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "claude-pet",
+  "version": "2.0.0",
+  "description": "Claude Pet - virtual pet coding companion desktop widget",
+  "main": "dist/main/main/main.js",
+  "bin": {
+    "claude-pet": "bin/claude-pet.js"
+  },
+  "scripts": {
+    "prepare": "npm run build",
+    "dev": "npm run build:main && concurrently -k -n VITE,ELECTRON -c cyan,yellow \"vite\" \"cross-env NODE_ENV=development electron dist/main/main/main.js\"",
+    "build:renderer": "vite build",
+    "build:main": "tsc -p tsconfig.main.json",
+    "build": "npm run build:renderer && npm run build:main",
+    "start": "electron dist/main/main/main.js",
+    "test": "vitest run",
+    "make-icon": "node scripts/make-icon.js",
+    "build:win": "electron-builder --win",
+    "build:mac": "electron-builder --mac",
+    "build:all": "electron-builder --win --mac"
+  },
+  "keywords": [],
+  "author": "scm1400",
+  "license": "ISC",
+  "type": "commonjs",
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.4",
+    "concurrently": "^9.2.1",
+    "cross-env": "^10.1.0",
+    "electron-builder": "^26.8.1",
+    "png-to-ico": "^3.0.1",
+    "sharp": "^0.34.5",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "auto-launch": "^5.0.6",
+    "electron": "^40.8.0",
+    "electron-store": "8.2.0",
+    "electron-updater": "^6.8.3",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4"
+  }
+}

package/scripts/AGENTS.md

@@ -0,0 +1,60 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-03-14 -->
+
+# scripts/
+
+## Purpose
+Build-time utility scripts that run outside the Electron app. `make-icon.js` generates all platform-specific icon and installer image assets from the source character artwork. `notarize.js` is an electron-builder afterSign hook that submits the packaged macOS `.app` to Apple's notarization service.
+
+## Key Files
+| File | Description |
+|------|-------------|
+| `make-icon.js` | Reads `docs/images/character.webp`, uses `sharp` to resize and composite, and writes: `build/icon.png` (512×512, macOS), `build/tray-icon.png` (32×32, runtime tray), `build/icon.ico` (256×256 via `png-to-ico`, Windows), `build/installerSidebar.bmp` (164×314, NSIS sidebar), `build/installerHeader.bmp` (150×57, NSIS header), `build/dmg-background.png` (540×380, macOS DMG). Run with `npm run make-icon`. |
+| `notarize.js` | electron-builder `afterSign` hook. Calls `@electron/notarize` with `APPLE_ID`, `APPLE_APP_SPECIFIC_PASSWORD`, and `APPLE_TEAM_ID` environment variables. No-ops on non-macOS platforms. Invoked automatically by electron-builder during `npm run build:mac`. |
+
+## Subdirectories
+| Directory | Purpose |
+|-----------|---------|
+| *(none)* | — |
+
+## For AI Agents
+
+### Working In This Directory
+- `make-icon.js` uses CommonJS `require()` — it is a plain Node script, not compiled TypeScript.
+- The source artwork must be at `docs/images/character.webp`. If the character art changes, re-run `npm run make-icon` to regenerate all build assets.
+- `notarize.js` requires three environment variables at build time: `APPLE_ID`, `APPLE_APP_SPECIFIC_PASSWORD`, `APPLE_TEAM_ID`. These are set as GitHub Actions secrets in `.github/workflows/build.yml`.
+- Do not run `notarize.js` manually — it is invoked by electron-builder's `afterSign` hook configured in `electron-builder.yml`.
+- The NSIS installer images (`.bmp`) must be exact pixel dimensions: sidebar 164×314, header 150×57. `sharp` enforces this via `removeAlpha()` + BMP output.
+- The DMG background (540×380 PNG) must have a transparent-safe format — `sharp` outputs PNG here (not BMP).
+
+### Testing Requirements
+- Run `npm run make-icon` and verify all six output files appear in `build/` with correct dimensions using any image viewer.
+- `notarize.js` is tested implicitly by the macOS CI job in `.github/workflows/build.yml`.
+
+### Common Patterns
+- Sharp pipeline pattern used throughout `make-icon.js`:
+  ```js
+  await sharp(src)
+    .resize(W, H, { fit: 'contain', background: { r: 0, g: 0, b: 0, alpha: 0 } })
+    .png()
+    .toFile(outPath);
+  ```
+- Composite (SVG background + character image):
+  ```js
+  await sharp(Buffer.from(svgString))
+    .composite([{ input: charBuf, left: x, top: y }])
+    .removeAlpha()
+    .toFile(outPath);
+  ```
+
+## Dependencies
+### Internal
+- Reads from `docs/images/character.webp`
+- Writes to `build/`
+
+### External
+- `sharp` ^0.34 — image processing
+- `png-to-ico` ^3 — PNG-to-ICO conversion
+- `@electron/notarize` — Apple notarization (consumed by `notarize.js`)
+
+<!-- MANUAL: -->

package/scripts/install.ps1

@@ -0,0 +1,47 @@
+# Claude Pet Installer for Windows
+# Usage: irm https://raw.githubusercontent.com/scm1400/claude-pet/main/scripts/install.ps1 | iex
+$ErrorActionPreference = "Stop"
+
+$Repo = "scm1400/claude-pet"
+$ApiUrl = "https://api.github.com/repos/$Repo/releases/latest"
+
+function Info($msg)  { Write-Host "→ $msg" -ForegroundColor Blue }
+function Ok($msg)    { Write-Host "✓ $msg" -ForegroundColor Green }
+function Err($msg)   { Write-Host "✗ $msg" -ForegroundColor Red; exit 1 }
+
+Info "Fetching latest release..."
+try {
+    $release = Invoke-RestMethod -Uri $ApiUrl -Headers @{ "User-Agent" = "claude-pet-installer" }
+} catch {
+    Err "Failed to fetch release info: $_"
+}
+
+$version = $release.tag_name
+Info "Latest version: $version"
+
+# Find .exe installer asset
+$asset = $release.assets | Where-Object { $_.name -match '\.exe$' } | Select-Object -First 1
+if (-not $asset) {
+    Err "No Windows installer found in release $version"
+}
+
+$downloadUrl = $asset.browser_download_url
+$fileName = $asset.name
+$tempPath = Join-Path $env:TEMP $fileName
+
+Info "Downloading $fileName..."
+try {
+    $ProgressPreference = 'SilentlyContinue'
+    Invoke-WebRequest -Uri $downloadUrl -OutFile $tempPath -UseBasicParsing
+} catch {
+    Err "Download failed: $_"
+}
+Ok "Downloaded to $tempPath"
+
+Info "Running installer..."
+Start-Process -FilePath $tempPath -Wait
+Ok "Installation complete!"
+
+# Cleanup
+Remove-Item -Path $tempPath -ErrorAction SilentlyContinue
+Info "Claude Pet should now be available in your Start Menu."

package/scripts/install.sh

@@ -0,0 +1,98 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Claude Pet Installer — downloads the latest release from GitHub
+REPO="scm1400/claude-pet"
+API_URL="https://api.github.com/repos/$REPO/releases/latest"
+
+info()  { printf "\033[1;34m→\033[0m %s\n" "$*"; }
+ok()    { printf "\033[1;32m✓\033[0m %s\n" "$*"; }
+err()   { printf "\033[1;31m✗\033[0m %s\n" "$*" >&2; exit 1; }
+
+# Detect OS and architecture
+OS="$(uname -s)"
+ARCH="$(uname -m)"
+
+case "$OS" in
+  Darwin)  PLATFORM="mac" ;;
+  Linux)   PLATFORM="linux" ;;
+  *)       err "Unsupported OS: $OS. Use install.ps1 for Windows." ;;
+esac
+
+case "$ARCH" in
+  x86_64|amd64) ARCH_LABEL="x64" ;;
+  arm64|aarch64) ARCH_LABEL="arm64" ;;
+  *)             err "Unsupported architecture: $ARCH" ;;
+esac
+
+info "Detected: $OS ($ARCH_LABEL)"
+
+# Fetch latest release info
+info "Fetching latest release..."
+RELEASE_JSON=$(curl -fsSL "$API_URL") || err "Failed to fetch release info"
+VERSION=$(echo "$RELEASE_JSON" | grep '"tag_name"' | head -1 | sed 's/.*"tag_name": *"//;s/".*//')
+info "Latest version: $VERSION"
+
+# Determine download asset
+if [ "$PLATFORM" = "mac" ]; then
+  if [ "$ARCH_LABEL" = "arm64" ]; then
+    PATTERN="arm64.*\.dmg"
+  else
+    PATTERN="x64.*\.dmg\|Claude.Pet.*\.dmg"
+  fi
+  ASSET_URL=$(echo "$RELEASE_JSON" | grep '"browser_download_url"' | grep -i '\.dmg"' | head -1 | sed 's/.*"browser_download_url": *"//;s/".*//')
+  FILENAME="Claude-Pet-${VERSION}.dmg"
+elif [ "$PLATFORM" = "linux" ]; then
+  # Prefer AppImage
+  ASSET_URL=$(echo "$RELEASE_JSON" | grep '"browser_download_url"' | grep -i '\.AppImage"' | head -1 | sed 's/.*"browser_download_url": *"//;s/".*//')
+  if [ -z "$ASSET_URL" ]; then
+    ASSET_URL=$(echo "$RELEASE_JSON" | grep '"browser_download_url"' | grep -i '\.deb"' | head -1 | sed 's/.*"browser_download_url": *"//;s/".*//')
+    FILENAME="claude-pet-${VERSION}.deb"
+  else
+    FILENAME="Claude-Pet-${VERSION}.AppImage"
+  fi
+fi
+
+[ -z "${ASSET_URL:-}" ] && err "No installer found for $PLATFORM ($ARCH_LABEL)"
+
+TMPDIR="${TMPDIR:-/tmp}"
+DOWNLOAD_PATH="$TMPDIR/$FILENAME"
+
+info "Downloading $FILENAME..."
+curl -fSL --progress-bar -o "$DOWNLOAD_PATH" "$ASSET_URL" || err "Download failed"
+ok "Downloaded to $DOWNLOAD_PATH"
+
+# Install
+if [ "$PLATFORM" = "mac" ]; then
+  info "Mounting DMG..."
+  MOUNT_POINT=$(hdiutil attach "$DOWNLOAD_PATH" -nobrowse | tail -1 | awk '{print $NF}')
+  APP_PATH=$(find "$MOUNT_POINT" -name "*.app" -maxdepth 1 | head -1)
+  if [ -n "$APP_PATH" ]; then
+    info "Installing to /Applications..."
+    cp -R "$APP_PATH" /Applications/
+    hdiutil detach "$MOUNT_POINT" -quiet
+    ok "Claude Pet installed to /Applications!"
+    info "Run: open '/Applications/Claude Pet.app'"
+  else
+    hdiutil detach "$MOUNT_POINT" -quiet
+    err "No .app found in DMG"
+  fi
+elif [ "$PLATFORM" = "linux" ]; then
+  if [[ "$FILENAME" == *.AppImage ]]; then
+    INSTALL_DIR="${HOME}/.local/bin"
+    mkdir -p "$INSTALL_DIR"
+    mv "$DOWNLOAD_PATH" "$INSTALL_DIR/claude-pet"
+    chmod +x "$INSTALL_DIR/claude-pet"
+    ok "Claude Pet installed to $INSTALL_DIR/claude-pet"
+    info "Make sure $INSTALL_DIR is in your PATH"
+    info "Run: claude-pet"
+  elif [[ "$FILENAME" == *.deb ]]; then
+    info "Installing .deb package..."
+    sudo dpkg -i "$DOWNLOAD_PATH" || sudo apt-get install -f -y
+    ok "Claude Pet installed!"
+    info "Run: claude-pet"
+  fi
+fi
+
+rm -f "$DOWNLOAD_PATH" 2>/dev/null || true
+ok "Installation complete!"