add basic framework

[newbe36524]

Summary by CodeRabbit

Release Notes

• New Features

  • Introduced a cross-platform Hagico Desktop application supporting Windows, macOS, and Linux.
  • Added system tray integration with context menu for quick access.
  • Enabled real-time server status monitoring and control (start, stop, restart).
  • Implemented automatic update support via GitHub Releases.
  • Added server connection configuration with persistent settings.

• Chores

  • Configured automated multi-platform build and release pipelines.
  • Established project structure and development tooling.

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This PR establishes a complete Hagico Desktop Electron application framework, including multi-platform build infrastructure via GitHub Actions, TypeScript configuration, package management, core Electron modules for main process management and system tray integration, React-based renderer with Tailwind styling, comprehensive OpenSpec documentation, and build/test automation scripts.

Changes

Cohort / File(s)	Summary
CI/CD & Build Automation .github/workflows/build.yml, scripts/ci-build.js, scripts/bump-version.js, scripts/obfuscate.js, scripts/smoke-test.js	New multi-platform GitHub Actions workflow for Windows/macOS/Linux builds with artifact uploads; CI orchestration script with colored logging and GitHub Actions integration; version bump utility; code obfuscation using javascript-obfuscator with worker-thread concurrency; lightweight smoke tests validating build artifacts, syntax, and electron-builder configuration.
Configuration & Package Management package.json, tsconfig.json, tsconfig.node.json, tsconfig.preload.json, tailwind.config.js, vite.config.mjs, electron-builder.yml, .gitignore	Root package manifest with Electron, React, TypeScript, Vite, and Tailwind dependencies; TypeScript configurations for main/preload/renderer targets with strict mode and path aliases; Vite config for React/Tailwind renderer with dev server on port 36598; Electron builder config specifying cross-platform targets (NSIS/AppX/DMG/AppImage/deb); standard .gitignore patterns for Node/Electron/IDE artifacts.
OpenSpec Documentation & Planning openspec/AGENTS.md, openspec/CLAUDE.md, openspec/PROPOSAL_DESIGN_GUIDELINES.md, openspec/project.md, openspec/.version, openspec/changes/archive/2026-02-02-electron-desktop-app-dml-architecture/*, openspec/specs/electron-app/spec.md	Comprehensive project planning framework including three-stage workflow guide, proposal/spec/task templates, design visualization guidelines, formal requirements specifications with Given/When/Then scenarios for installation, tray integration, server monitoring, control, configuration, auto-update, and automated builds; implementation tasks and milestones.
Electron Main Process src/main/main.ts, src/main/config.ts, src/main/server.ts, src/main/tray.ts	Main entry point wiring BrowserWindow, IPC handlers for app version/window control/server operations, periodic status polling (5-second interval), tray integration; ConfigManager for persistent app settings using electron-store; HagicoServerClient HTTP wrapper with methods for status query, start/stop/restart operations; system tray icon and context menu with server status reflection and window toggle on click.
Preload & IPC Bridge src/preload/index.ts	Preload script exposing safe electronAPI to renderer via contextBridge with methods for version retrieval, window visibility control, server operations (start/stop/status), and server status change listener with cleanup function.
React Renderer UI src/renderer/App.tsx, src/renderer/main.tsx, src/renderer/index.html, src/renderer/index.css	React entry point with StrictMode wrapper; App component managing server status polling, version display, start/stop controls, and status indicator UI; HTML shell with root div and module script entry; Tailwind base styles and global CSS reset.

Sequence Diagram

sequenceDiagram
    participant MainProcess as Main Process
    participant StatusPoller as Status Poller<br/>(5s interval)
    participant ServerClient as Server Client<br/>(HTTP)
    participant HagicoServer as Hagico Server
    participant TrayUI as System Tray
    participant RendererUI as Renderer UI

    loop Every 5 seconds
        StatusPoller->>ServerClient: getStatus()
        ServerClient->>HagicoServer: GET /api/status
        HagicoServer-->>ServerClient: {running, version, uptime}
        ServerClient-->>StatusPoller: ServerInfo
        StatusPoller->>MainProcess: update internal serverStatus
        MainProcess->>TrayUI: setServerStatus(status)
        TrayUI-->>TrayUI: refresh context menu & icon
        MainProcess->>RendererUI: send 'server-status-changed' IPC
        RendererUI-->>RendererUI: update React state & UI
    end

    RendererUI->>RendererUI: User clicks "Start Server"
    RendererUI->>MainProcess: invoke 'start-server' IPC
    MainProcess->>ServerClient: startServer()
    ServerClient->>HagicoServer: POST /api/start
    HagicoServer-->>ServerClient: success response
    ServerClient-->>MainProcess: true
    MainProcess->>MainProcess: next poll cycle detects running status

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~75 minutes

Poem

🐰 Whiskers twitching with delight,
An Electron app takes flight,
Tray icons dance, servers controlled,
Cross-platform magic unfolds,
From source to build, the promise we hold! 🚀

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/inidex

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}