chore: update sensor configuration docs

Changes:\nM	README.md
M	Sources/com.awareframework.ios.sensor.processor/ProcessorSensor.swift\n\nNotes:\n- Updated implementation, tests, and/or README formatting for this package.\n- agent, ai, and context packages are intentionally excluded.

Author: tetujin

README.md

@@ -1,4 +1,4 @@
-# AWARE Processor Sensor
+# AWARE: Processor
 
 The processor sensor samples app process resource usage and device processor state on iOS.
 It is designed for periodic, low-overhead monitoring of the AwareClient process, not for
@@ -20,11 +20,11 @@ Then import the module:
 import com_awareframework_ios_sensor_processor
 ```
 
-## Usage
+## Example Usage
 
 ```swift
 let sensor = ProcessorSensor(ProcessorSensor.Config().apply { config in
-    config.interval = 60 // seconds
+    config.sampleIntervalSeconds = 60
 })
 
 sensor.start()
@@ -36,18 +36,18 @@ To stop collection:
 sensor.stop()
 ```
 
-## Configuration
+### ProcessorSensor.Config
 
-`ProcessorSensor.Config` extends the common AWARE `SensorConfig`.
+Class to hold the configuration of the sensor.
 
-| Property | Type | Default | Description |
-| --- | --- | --- | --- |
-| `interval` | `Int` | `60` | Sampling interval in seconds. Values less than `1` are ignored. |
-| `sensorObserver` | `ProcessorObserver?` | `nil` | Callback for live processor samples. |
-| `dbPath` | `String` | `aware_processor` | SQLite database path stem. |
-| `dbTableName` | `String?` | `ios_processor` in AwareClient | Active database table name. |
+#### Fields
 
-## Data Model
++ `sampleIntervalSeconds: Int`: Sampling interval in seconds. Values less than `1` are ignored. (default = `60`)
++ `sensorObserver: ProcessorObserver?`: Callback for live processor samples. (default = `nil`)
++ `dbPath: String`: SQLite database path stem. (default = `"aware_processor"`)
++ `dbTableName: String?`: Active database table name. (default = `"ios_processor"` in AwareClient)
+
+## Data Representations
 
 `ProcessorData` stores the following fields:
 
@@ -66,7 +66,7 @@ sensor.stop()
 | `thermalState` | `Int` | `0` nominal, `1` fair, `2` serious, `3` critical, `-1` unknown. |
 | `lowPowerMode` | `Int` | `1` when Low Power Mode is enabled, otherwise `0`. |
 
-## Notifications
+## Broadcasts
 
 | Notification | Description |
 | --- | --- |
@@ -87,7 +87,7 @@ final class Observer: ProcessorObserver {
 }
 
 let config = ProcessorSensor.Config().apply { config in
-    config.interval = 30
+    config.sampleIntervalSeconds = 30
     config.sensorObserver = Observer()
 }
 

Sources/com.awareframework.ios.sensor.processor/ProcessorSensor.swift

@@ -43,15 +43,15 @@ public class ProcessorSensor: AwareSensor {
 
     public class Config: SensorConfig {
         public var sensorObserver: ProcessorObserver?
-        public var interval: Int = 60 {
+        public var sampleIntervalSeconds: Int = 60 {
             didSet {
-                if interval <= 0 {
+                if sampleIntervalSeconds <= 0 {
                     if debug {
                         print(
                             ProcessorSensor.TAG,
-                            "The interval parameter must be greater than 0. Keeping \(oldValue).")
+                            "The sampleIntervalSeconds parameter must be greater than 0. Keeping \(oldValue).")
                     }
-                    interval = oldValue
+                    sampleIntervalSeconds = oldValue
                 }
             }
         }
@@ -64,8 +64,8 @@ public class ProcessorSensor: AwareSensor {
         public convenience init(_ config: Dictionary<String, Any>) {
             self.init()
             set(config: config)
-            if let interval = config["interval"] as? Int {
-                self.interval = interval
+            if let sampleIntervalSeconds = config["sampleIntervalSeconds"] as? Int {
+                self.sampleIntervalSeconds = sampleIntervalSeconds
             }
         }
 
@@ -100,8 +100,8 @@ public class ProcessorSensor: AwareSensor {
 
         let timer = DispatchSource.makeTimerSource(queue: sampleQueue)
         timer.schedule(
-            deadline: .now() + .seconds(max(1, CONFIG.interval)),
-            repeating: .seconds(max(1, CONFIG.interval)))
+            deadline: .now() + .seconds(max(1, CONFIG.sampleIntervalSeconds)),
+            repeating: .seconds(max(1, CONFIG.sampleIntervalSeconds)))
         timer.setEventHandler { [weak self] in
             self?.sample()
         }