feat: add 4 examples addressing context7 documentation gaps

Add complete, compilable examples for the four areas context7 flagged
as lacking Go implementation guidance:

- flashlight_torch: toggle torch via ICameraService.SetTorchMode
- list_packages: list all installed packages via GetAllPackages
- error_handling: service availability checks, typed AIDL errors, graceful degradation
- server_service: implement TransactionReceiver, register with AddService, self-test

Update spec2readme with matching usage examples and descriptions so
the README (and context7 index) includes inline code for each pattern.

Author: xaionaro@dx.center

README.md

@@ -287,6 +287,118 @@ import (
     fmt.Printf("Is monkey: %v\n", monkey)
 ```
 
+### Toggle Flashlight
+
+```go
+import (
+    "github.com/AndroidGoLab/binder/android/hardware"
+    "github.com/AndroidGoLab/binder/servicemanager"
+)
+
+    svc, err := sm.GetService(ctx, servicemanager.ServiceName("media.camera"))
+    if err != nil {
+        log.Fatal(err)
+    }
+    camera := hardware.NewCameraServiceProxy(svc)
+
+    // Turn torch on for camera "0"
+    if err := camera.SetTorchMode(ctx, "0", true, nil); err != nil {
+        log.Fatal(err)
+    }
+    fmt.Println("Torch ON")
+
+    // Turn torch off
+    _ = camera.SetTorchMode(ctx, "0", false, nil)
+```
+
+### List All Installed Packages
+
+```go
+import (
+    "github.com/AndroidGoLab/binder/android/content/pm"
+    "github.com/AndroidGoLab/binder/servicemanager"
+)
+
+    svc, err := sm.GetService(ctx, servicemanager.ServiceName("package"))
+    if err != nil {
+        log.Fatal(err)
+    }
+    pkgMgr := pm.NewPackageManagerProxy(svc)
+
+    packages, err := pkgMgr.GetAllPackages(ctx)
+    if err != nil {
+        log.Fatal(err)
+    }
+
+    fmt.Printf("Found %d packages:\n", len(packages))
+    for _, pkg := range packages {
+        fmt.Println(" ", pkg)
+    }
+```
+
+### Handle Errors Gracefully
+
+```go
+import (
+    "errors"
+    aidlerrors "github.com/AndroidGoLab/binder/errors"
+    "github.com/AndroidGoLab/binder/servicemanager"
+)
+
+    // Non-blocking service check (returns nil if not found)
+    svc, err := sm.CheckService(ctx, servicemanager.ServiceName("media.camera"))
+    if err != nil {
+        log.Fatal(err)
+    }
+    if svc == nil {
+        fmt.Println("Camera service not available")
+        return
+    }
+
+    // Typed error inspection
+    _, err = someProxy.SomeMethod(ctx)
+    var status *aidlerrors.StatusError
+    if errors.As(err, &status) {
+        switch status.Exception {
+        case aidlerrors.ExceptionSecurity:
+            fmt.Printf("Permission denied: %s\n", status.Message)
+        case aidlerrors.ExceptionServiceSpecific:
+            fmt.Printf("Service error %d: %s\n", status.ServiceSpecificCode, status.Message)
+        default:
+            fmt.Printf("AIDL error: %v\n", status)
+        }
+    }
+```
+
+### Register a Server-Side Service
+
+```go
+import (
+    "github.com/AndroidGoLab/binder/binder"
+    "github.com/AndroidGoLab/binder/parcel"
+    "github.com/AndroidGoLab/binder/servicemanager"
+)
+
+    // Implement the TransactionReceiver interface
+    type myService struct{}
+
+    func (s *myService) Descriptor() string { return "com.example.IPingService" }
+
+    func (s *myService) OnTransaction(
+        ctx context.Context,
+        code binder.TransactionCode,
+        data *parcel.Parcel,
+    ) (*parcel.Parcel, error) {
+        reply := parcel.New()
+        binder.WriteStatus(reply, nil)
+        reply.WriteString16("pong")
+        return reply, nil
+    }
+
+    // Register with ServiceManager
+    err := sm.AddService(ctx, servicemanager.ServiceName("my.service"), &myService{}, false, 0)
+```
+
 More examples: [`examples/`](examples/)
 
 <!-- END GENERATED USAGE_EXAMPLES -->
@@ -303,13 +415,17 @@ More examples: [`examples/`](examples/)
 | [`camera_fwk`](examples/camera_fwk/) |  |
 | [`device_info`](examples/device_info/) | Device properties, build info |
 | [`display_info`](examples/display_info/) | Display IDs, brightness, night mode |
+| [`error_handling`](examples/error_handling/) | Graceful error handling: service checks, typed errors, permissions |
+| [`flashlight_torch`](examples/flashlight_torch/) | Toggle flashlight/torch via ICameraService |
 | [`getservice_vs_checkservice`](examples/getservice_vs_checkservice/) | Binary getservice_vs_checkservice compares GetService vs CheckService |
 | [`gps_location`](examples/gps_location/) | Live GPS fix via ILocationListener callback |
 | [`keymint_delete_test`](examples/keymint_delete_test/) | Binary keymint_delete_test calls DeleteAllKeys on the KeyMint HAL |
+| [`list_packages`](examples/list_packages/) | List all installed packages via GetAllPackages |
 | [`list_services`](examples/list_services/) | Enumerate all binder services, ping each |
 | [`package_query`](examples/package_query/) | Package list, installation info |
 | [`power_status`](examples/power_status/) | Power supply state, charging info |
 | [`security_test_apk`](examples/security_test_apk/) | Binary security_test_apk probes whether an app-sandboxed process can |
+| [`server_service`](examples/server_service/) | Register a Go service and call it back via binder |
 | [`softap_manage`](examples/softap_manage/) | WiFi hotspot enable/disable, config |
 | [`softap_tether_offload`](examples/softap_tether_offload/) | Tethering offload config, stats |
 | [`softap_wifi_hal`](examples/softap_wifi_hal/) | WiFi chip info, AP interface state |
@@ -1833,6 +1949,88 @@ go run ./cmd/binder-mcp/ --mode remote
 
 <!-- END GENERATED BINDER_MCP -->
 
+## Using binder-mcp with AI Agents
+
+<!-- BEGIN GENERATED AGENT_CONFIGS -->
+
+### Installation
+
+```bash
+# Via go install
+go install github.com/AndroidGoLab/binder/cmd/binder-mcp@latest
+
+# Via GitHub releases (pre-built binaries)
+# Download from https://github.com/AndroidGoLab/binder/releases
+
+# Via Docker (host mode)
+docker run ghcr.io/androidgolab/binder-mcp
+```
+
+### Claude Code
+
+```bash
+claude mcp add --transport stdio binder-mcp -- binder-mcp --mode remote
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "binder-mcp": {
+      "command": "binder-mcp",
+      "args": ["--mode", "remote"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "binder-mcp": {
+      "command": "binder-mcp",
+      "args": ["--mode", "remote"]
+    }
+  }
+}
+```
+
+### Cline
+
+Add to Cline MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "binder-mcp": {
+      "command": "binder-mcp",
+      "args": ["--mode", "remote"],
+      "alwaysAllow": ["list_services", "get_device_info", "take_screenshot"]
+    }
+  }
+}
+```
+
+### On-device mode (via adb)
+
+```bash
+# Build for Android
+GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o binder-mcp ./cmd/binder-mcp/
+adb push binder-mcp /data/local/tmp/
+
+# Configure agent to use adb transport
+claude mcp add --transport stdio binder-mcp -- adb shell /data/local/tmp/binder-mcp
+```
+
+<!-- END GENERATED AGENT_CONFIGS -->
+
 ## Interoperability
 
 <!-- BEGIN GENERATED INTEROPERABILITY -->
@@ -1924,6 +2122,6 @@ See the example app at [`examples/gomobile/`](examples/gomobile/).
 │   ├── hardware/             HAL interfaces
 │   └── ...                   399 packages total
 ├── com/                      AOSP com.android.* service proxies
-├── examples/                 19 runnable examples
+├── examples/                 23 runnable examples
 └── .github/workflows/        CI configuration
 ```