verify-widget-build

name	verify-widget-build
description	Verify macOS menu bar widget builds correctly and app bundle structure is valid. Trigger after any changes to widget/ directory files (main.swift, build.sh, Info.plist, widget.html, widget.css).

Widget Build Verification

Verify the ClaudeVille macOS menu bar widget compiles, produces a valid .app bundle, and all required resources are present.

Prerequisites

• Xcode Command Line Tools installed (xcode-select -p)
• Node.js available (for server dependency)

Check Items

1. Swift Compilation

Run the widget build script and verify it compiles without errors:

cd widget && bash build.sh

• PASS: Exit code 0, "빌드 완료" message printed
• FAIL: Compilation errors or non-zero exit code

2. App Bundle Structure

Verify the .app bundle contains all required files:

widget/ClaudeVilleWidget.app/
├── Contents/
│   ├── MacOS/ClaudeVilleWidget    (executable, must be executable)
│   ├── Info.plist                  (must contain LSUIElement=true)
│   └── Resources/
│       ├── widget.html
│       ├── widget.css
│       ├── project_path           (must contain valid path)
│       └── node_path              (must contain valid node binary path)

• PASS: All files exist with correct content
• WARN: project_path or node_path points to non-existent location
• FAIL: Missing executable, Info.plist, or HTML/CSS resources

3. Info.plist Validity

Parse Info.plist and verify required keys:

• LSUIElement = true (menu bar app, no Dock icon)

• CFBundleExecutable = "ClaudeVilleWidget"

• NSHighResolutionCapable = true

• NSAppTransportSecurity.NSAllowsLocalNetworking = true

• PASS: All keys present and correct

• FAIL: Missing or incorrect key values

4. Node Path Resolution

Verify the recorded node_path is a real binary (not an fnm temp symlink):

cat widget/ClaudeVilleWidget.app/Contents/Resources/node_path

• PASS: Path exists AND does NOT contain fnm_multishells (permanent path)
• WARN: Path exists but contains fnm_multishells (temporary, will break on restart)
• FAIL: Path does not exist

5. Port Configuration Consistency

Verify port 4000 is used consistently across all files:

• claudeville/server.js: const PORT = 4000

• widget/Sources/main.swift: all localhost references use port 4000

• widget/Resources/widget.html: WS_URL uses port 4000

• PASS: All files use port 4000

• FAIL: Any file uses a different port (e.g., 3000)