packwise-skills 1.0.0 → 1.2.0

package/sub-skills/desktop/web-to-desktop.md

@@ -1,153 +1,153 @@
-# Web-to-Desktop Build Sub-Skill
-
-Quickly wrap existing web applications as desktop clients. For scenarios not requiring complex backends, pursuing minimal footprint.
-
----
-
-## Solution Comparison
-
-| Framework | Language | Size | Engine | Platform | Best For |
-|-----------|---------|------|--------|----------|---------|
-| Pake/PakePlus | Rust (Tauri) | ~3-10MB | System WebView | Win/Mac/Linux/Android | Website → desktop minimal wrapper |
-| Neutralinojs | JS + C++ | ~1-3MB | System WebView | Win/Mac/Linux | Lightweight Electron alternative |
-| Capacitor | JS/TS | ~20MB | Chromium (Electron) | Win/Mac/Linux/iOS/Android | Web → all platforms |
-| Carlo | JS | ~0MB | System Chrome | Win/Mac/Linux | Users with Chrome installed |
-
----
-
-## Pake / PakePlus (Recommended: Minimal Wrapper)
-
-**Version**: PakePlus 2.7.x (2025-2026) — the actively maintained successor to the original Pake project.
-
-### When to Use
-- Any website wrapped as desktop app
-- No backend logic needed
-- Minimal size (~3MB)
-- Custom window styling
-
-### Usage
-
-```bash
-npm install -g pake-cli
-
-# Basic
-pake https://example.com --name MyApp
-
-# Custom window
-pake https://example.com \
-  --name MyApp \
-  --icon ./icon.png \
-  --width 1200 --height 800 \
-  --hide-title-bar \
-  --fullscreen false \
-  --resizable true
-
-# Multi-platform
-pake https://example.com --name MyApp --platform all
-```
-
-### Limitations
-- No Node.js backend support
-- No native module support
-- Features limited to WebView capabilities
-
----
-
-## Neutralinojs (5.6.x)
-
-**Version**: Neutralinojs 5.6.x (2025-2026)
-
-### When to Use
-- Need lightweight backend (file system, network)
-- Don't need full Node.js
-- Minimal footprint (~2MB)
-
-### Setup
-
-```bash
-npm install -g @nicepkg/neutralino
-neu create myapp
-```
-
-### Frontend API
-
-```javascript
-// File system
-await Neutralino.filesystem.writeFile('data.txt', 'Hello');
-const data = await Neutralino.filesystem.readFile('data.txt');
-
-// Window control
-await Neutralino.window.setTitle('New Title');
-
-// System
-await Neutralino.os.open('https://example.com');
-```
-
-### Build
-
-```bash
-neu run    # Development
-neu build  # Production
-# Output: dist/myapp-win_x64/, dist/myapp-mac_x64/, dist/myapp-linux_x64/
-```
-
----
-
-## Capacitor (Web → All Platforms)
-
-### When to Use
-- Existing web application
-- Need desktop + mobile support simultaneously
-- Need native API access (camera, filesystem, notifications)
-
-### Setup
-
-```bash
-npm install @capacitor/core @capacitor/cli
-npx cap init MyApp com.example.myapp
-npm install @capacitor/electron
-npx cap add electron
-npx cap copy electron
-npx cap open electron
-```
-
-### Native API Usage
-
-```typescript
-import { Filesystem, Directory } from '@capacitor/filesystem';
-import { LocalNotifications } from '@capacitor/local-notifications';
-
-await Filesystem.writeFile({
-  path: 'data.txt',
-  data: 'Hello World',
-  directory: Directory.Documents,
-});
-
-await LocalNotifications.schedule({
-  notifications: [{ title: 'Alert', body: 'New message', id: 1 }],
-});
-```
-
----
-
-## Selection Guide
-
-| Your Situation | Recommended |
-|---------------|------------|
-| Pure website wrap, minimal size | Pake |
-| Need filesystem/network backend | Neutralinojs |
-| Need desktop + mobile unified | Capacitor |
-| Need full Node.js backend | Electron (see electron.md) |
-| Need Rust backend + minimal size | Tauri (see tauri.md) |
-
----
-
-## Common Pitfalls
-
-| Issue | Fix |
-|-------|-----|
-| WebView display differences | Use standard CSS, avoid experimental features |
-| CORS cross-origin | Configure WebView to allow cross-origin or use proxy |
-| WebView missing (Linux) | Install libwebkit2gtk-4.1-dev |
-| Local storage lost | Use filesystem API instead of localStorage |
-| Keyboard shortcut conflicts | Configure WebView to ignore system shortcuts |
+# Web-to-Desktop Build Sub-Skill
+
+Quickly wrap existing web applications as desktop clients. For scenarios not requiring complex backends, pursuing minimal footprint.
+
+---
+
+## Solution Comparison
+
+| Framework | Language | Size | Engine | Platform | Best For |
+|-----------|---------|------|--------|----------|---------|
+| Pake/PakePlus | Rust (Tauri) | ~3-10MB | System WebView | Win/Mac/Linux/Android | Website → desktop minimal wrapper |
+| Neutralinojs | JS + C++ | ~1-3MB | System WebView | Win/Mac/Linux | Lightweight Electron alternative |
+| Capacitor | JS/TS | ~20MB | Chromium (Electron) | Win/Mac/Linux/iOS/Android | Web → all platforms |
+| Carlo | JS | ~0MB | System Chrome | Win/Mac/Linux | Users with Chrome installed |
+
+---
+
+## Pake / PakePlus (Recommended: Minimal Wrapper)
+
+**Version**: PakePlus 2.7.x (2025-2026) — the actively maintained successor to the original Pake project.
+
+### When to Use
+- Any website wrapped as desktop app
+- No backend logic needed
+- Minimal size (~3MB)
+- Custom window styling
+
+### Usage
+
+```bash
+npm install -g pake-cli
+
+# Basic
+pake https://example.com --name MyApp
+
+# Custom window
+pake https://example.com \
+  --name MyApp \
+  --icon ./icon.png \
+  --width 1200 --height 800 \
+  --hide-title-bar \
+  --fullscreen false \
+  --resizable true
+
+# Multi-platform
+pake https://example.com --name MyApp --platform all
+```
+
+### Limitations
+- No Node.js backend support
+- No native module support
+- Features limited to WebView capabilities
+
+---
+
+## Neutralinojs (5.6.x)
+
+**Version**: Neutralinojs 5.6.x (2025-2026)
+
+### When to Use
+- Need lightweight backend (file system, network)
+- Don't need full Node.js
+- Minimal footprint (~2MB)
+
+### Setup
+
+```bash
+npm install -g @nicepkg/neutralino
+neu create myapp
+```
+
+### Frontend API
+
+```javascript
+// File system
+await Neutralino.filesystem.writeFile('data.txt', 'Hello');
+const data = await Neutralino.filesystem.readFile('data.txt');
+
+// Window control
+await Neutralino.window.setTitle('New Title');
+
+// System
+await Neutralino.os.open('https://example.com');
+```
+
+### Build
+
+```bash
+neu run    # Development
+neu build  # Production
+# Output: dist/myapp-win_x64/, dist/myapp-mac_x64/, dist/myapp-linux_x64/
+```
+
+---
+
+## Capacitor (Web → All Platforms)
+
+### When to Use
+- Existing web application
+- Need desktop + mobile support simultaneously
+- Need native API access (camera, filesystem, notifications)
+
+### Setup
+
+```bash
+npm install @capacitor/core @capacitor/cli
+npx cap init MyApp com.example.myapp
+npm install @capacitor/electron
+npx cap add electron
+npx cap copy electron
+npx cap open electron
+```
+
+### Native API Usage
+
+```typescript
+import { Filesystem, Directory } from '@capacitor/filesystem';
+import { LocalNotifications } from '@capacitor/local-notifications';
+
+await Filesystem.writeFile({
+  path: 'data.txt',
+  data: 'Hello World',
+  directory: Directory.Documents,
+});
+
+await LocalNotifications.schedule({
+  notifications: [{ title: 'Alert', body: 'New message', id: 1 }],
+});
+```
+
+---
+
+## Selection Guide
+
+| Your Situation | Recommended |
+|---------------|------------|
+| Pure website wrap, minimal size | Pake |
+| Need filesystem/network backend | Neutralinojs |
+| Need desktop + mobile unified | Capacitor |
+| Need full Node.js backend | Electron (see electron.md) |
+| Need Rust backend + minimal size | Tauri (see tauri.md) |
+
+---
+
+## Common Pitfalls
+
+| Issue | Fix |
+|-------|-----|
+| WebView display differences | Use standard CSS, avoid experimental features |
+| CORS cross-origin | Configure WebView to allow cross-origin or use proxy |
+| WebView missing (Linux) | Install libwebkit2gtk-4.1-dev |
+| Local storage lost | Use filesystem API instead of localStorage |
+| Keyboard shortcut conflicts | Configure WebView to ignore system shortcuts |

package/sub-skills/embedded/car-infotainment.md

@@ -1,129 +1,129 @@
-# Car Infotainment Build Sub-Skill
-
-Build applications for automotive infotainment systems: Android Automotive OS, QNX, AGL (Automotive Grade Linux), and HarmonyOS Car.
-
-**Current versions**: Android Automotive 14 / QNX 8.0 / AGL UCB 16 (2025-2026)
-
-## When to Use
-
-- In-vehicle infotainment (IVI) systems
-- Digital instrument clusters
-- Heads-up display (HUD) applications
-- Rear-seat entertainment
-- Telematics and fleet management
-- EV charging station UI
-
-## Platform Comparison
-
-| Platform | Base OS | Language | Market Share | Best For |
-|----------|---------|----------|-------------|---------|
-| Android Automotive OS (AAOS) | Android 14 | Kotlin/Java | Growing fast | Mass-market vehicles (Volvo, GM, Ford, Honda) |
-| QNX | QNX Neutrino RTOS | C/C++ | Largest (safety-critical) | Instrument clusters, safety systems |
-| AGL | Linux | C/C++, HTML5/JS | Growing (open-source) | Custom IVI, fleet vehicles |
-| HarmonyOS Car | HarmonyOS | ArkTS | China market | Huawei ecosystem vehicles |
-| webOS Auto | Linux | JavaScript | Niche | LG-based IVI systems |
-| Custom Linux (Yocto) | Linux | C/C++/Qt/QML | Many | Full control, custom hardware |
-
----
-
-## Android Automotive OS (AAOS)
-
-### Key Differences from Android Mobile
-
-| Feature | Android Mobile | Android Automotive |
-|---------|---------------|-------------------|
-| Display | Single screen | Multiple displays (IVI, cluster, HUD) |
-| Input | Touch, voice | Touch, rotary controller, steering wheel, voice |
-| Audio | Single zone | Multi-zone (driver, passenger, rear) |
-| Lifecycle | Phone lifecycle | Vehicle lifecycle (10+ years) |
-
-### Build
-
-```kotlin
-// build.gradle.kts
-android {
-    defaultConfig {
-        minSdk = 28
-        targetSdk = 34
-    }
-}
-
-dependencies {
-    implementation("androidx.car.app:app:1.7.0")
-    implementation("androidx.media3:media3-session:1.5.0")
-}
-```
-
-```xml
-<manifest>
-    <uses-feature android:name="android.hardware.type.automotive" android:required="true" />
-    <application>
-        <service android:name=".MyCarService" android:exported="true">
-            <intent-filter>
-                <action android:name="android.car.app.CarAppService" />
-            </intent-filter>
-        </service>
-    </application>
-</manifest>
-```
-
-```bash
-./gradlew assembleRelease
-# Test with Android Automotive emulator in Android Studio
-```
-
----
-
-## QNX (Safety-Critical)
-
-- **Microkernel RTOS** — deterministic real-time behavior
-- **Safety certified** — ISO 26262 ASIL-D, IEC 61508 SIL-3
-- **Used by**: BlackBerry QNX, deployed in 200M+ vehicles
-
-```bash
-# Cross-compile from Linux/macOS host
-qcc -Vgcc_ntoaarch64le -o myapp myapp.c -lGL -lEGL
-
-# Build with CMake
-cmake -DCMAKE_TOOLCHAIN_FILE=qnx-aarch64.cmake ..
-make
-```
-
----
-
-## AGL (Automotive Grade Linux)
-
-```bash
-# AGL uses Yocto/BitBake build system
-repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
-repo sync
-
-source meta-agl/scripts/aglsetup.sh -m qemux86-64 -b build agl-demo agl-appfw-smack
-bitbake agl-demo-platform
-```
-
----
-
-## Selection Guide
-
-| Project Type | Recommended Platform |
-|-------------|---------------------|
-| Consumer car IVI | Android Automotive |
-| Instrument cluster | QNX |
-| Fleet management | AGL or custom Linux |
-| Chinese market vehicle | HarmonyOS Car |
-| Research/prototype | AGL or Raspberry Pi + custom |
-| Motorcycle/scooter IVI | Custom Linux (Yocto/Buildroot) |
-
-## Universal Car Software Packaging Checklist
-
-1. **Driver distraction** — no interactive content while vehicle is moving
-2. **Startup time** — must be < 2 seconds
-3. **Temperature range** — test at -40°C to +85°C
-4. **Long lifecycle** — support for 10+ years
-5. **OTA updates** — must support over-the-air updates
-6. **Multi-display** — support IVI + instrument cluster + HUD
-7. **Audio zones** — separate audio for driver vs passenger
-8. **Safety compliance** — ASIL rating if interacting with vehicle systems
-9. **Power management** — handle ignition on/off, sleep/wake gracefully
-10. **CAN bus integration** — vehicle data via CAN
+# Car Infotainment Build Sub-Skill
+
+Build applications for automotive infotainment systems: Android Automotive OS, QNX, AGL (Automotive Grade Linux), and HarmonyOS Car.
+
+**Current versions**: Android Automotive 14 / QNX 8.0 / AGL UCB 16 (2025-2026)
+
+## When to Use
+
+- In-vehicle infotainment (IVI) systems
+- Digital instrument clusters
+- Heads-up display (HUD) applications
+- Rear-seat entertainment
+- Telematics and fleet management
+- EV charging station UI
+
+## Platform Comparison
+
+| Platform | Base OS | Language | Market Share | Best For |
+|----------|---------|----------|-------------|---------|
+| Android Automotive OS (AAOS) | Android 14 | Kotlin/Java | Growing fast | Mass-market vehicles (Volvo, GM, Ford, Honda) |
+| QNX | QNX Neutrino RTOS | C/C++ | Largest (safety-critical) | Instrument clusters, safety systems |
+| AGL | Linux | C/C++, HTML5/JS | Growing (open-source) | Custom IVI, fleet vehicles |
+| HarmonyOS Car | HarmonyOS | ArkTS | China market | Huawei ecosystem vehicles |
+| webOS Auto | Linux | JavaScript | Niche | LG-based IVI systems |
+| Custom Linux (Yocto) | Linux | C/C++/Qt/QML | Many | Full control, custom hardware |
+
+---
+
+## Android Automotive OS (AAOS)
+
+### Key Differences from Android Mobile
+
+| Feature | Android Mobile | Android Automotive |
+|---------|---------------|-------------------|
+| Display | Single screen | Multiple displays (IVI, cluster, HUD) |
+| Input | Touch, voice | Touch, rotary controller, steering wheel, voice |
+| Audio | Single zone | Multi-zone (driver, passenger, rear) |
+| Lifecycle | Phone lifecycle | Vehicle lifecycle (10+ years) |
+
+### Build
+
+```kotlin
+// build.gradle.kts
+android {
+    defaultConfig {
+        minSdk = 28
+        targetSdk = 34
+    }
+}
+
+dependencies {
+    implementation("androidx.car.app:app:1.7.0")
+    implementation("androidx.media3:media3-session:1.5.0")
+}
+```
+
+```xml
+<manifest>
+    <uses-feature android:name="android.hardware.type.automotive" android:required="true" />
+    <application>
+        <service android:name=".MyCarService" android:exported="true">
+            <intent-filter>
+                <action android:name="android.car.app.CarAppService" />
+            </intent-filter>
+        </service>
+    </application>
+</manifest>
+```
+
+```bash
+./gradlew assembleRelease
+# Test with Android Automotive emulator in Android Studio
+```
+
+---
+
+## QNX (Safety-Critical)
+
+- **Microkernel RTOS** — deterministic real-time behavior
+- **Safety certified** — ISO 26262 ASIL-D, IEC 61508 SIL-3
+- **Used by**: BlackBerry QNX, deployed in 200M+ vehicles
+
+```bash
+# Cross-compile from Linux/macOS host
+qcc -Vgcc_ntoaarch64le -o myapp myapp.c -lGL -lEGL
+
+# Build with CMake
+cmake -DCMAKE_TOOLCHAIN_FILE=qnx-aarch64.cmake ..
+make
+```
+
+---
+
+## AGL (Automotive Grade Linux)
+
+```bash
+# AGL uses Yocto/BitBake build system
+repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
+repo sync
+
+source meta-agl/scripts/aglsetup.sh -m qemux86-64 -b build agl-demo agl-appfw-smack
+bitbake agl-demo-platform
+```
+
+---
+
+## Selection Guide
+
+| Project Type | Recommended Platform |
+|-------------|---------------------|
+| Consumer car IVI | Android Automotive |
+| Instrument cluster | QNX |
+| Fleet management | AGL or custom Linux |
+| Chinese market vehicle | HarmonyOS Car |
+| Research/prototype | AGL or Raspberry Pi + custom |
+| Motorcycle/scooter IVI | Custom Linux (Yocto/Buildroot) |
+
+## Universal Car Software Packaging Checklist
+
+1. **Driver distraction** — no interactive content while vehicle is moving
+2. **Startup time** — must be < 2 seconds
+3. **Temperature range** — test at -40°C to +85°C
+4. **Long lifecycle** — support for 10+ years
+5. **OTA updates** — must support over-the-air updates
+6. **Multi-display** — support IVI + instrument cluster + HUD
+7. **Audio zones** — separate audio for driver vs passenger
+8. **Safety compliance** — ASIL rating if interacting with vehicle systems
+9. **Power management** — handle ignition on/off, sleep/wake gracefully
+10. **CAN bus integration** — vehicle data via CAN