idlewatch 0.1.6 → 0.1.8

package/README.md

@@ -23,13 +23,13 @@ npx idlewatch --dry-run
 
 - `quickstart`: run first-run enrollment wizard
 - `--help`: show usage
-- `--dry-run`: collect one sample and exit (no Firebase write)
-- `--once`: collect one sample, publish to Firebase when configured, then exit
+- `--dry-run`: collect one sample and exit without remote writes
+- `--once`: collect one sample, publish it using the active configured path, then exit
 
 ## Reliability improvements
 
 - Local NDJSON durability log at `~/.idlewatch/logs/<host>-metrics.ndjson` (override via `IDLEWATCH_LOCAL_LOG_PATH`)
-- Retry-once+ for transient Firestore write failures
+- Retry-once+ for transient publish failures (cloud ingest and Firebase paths)
 - Non-overlapping scheduler loop (prevents concurrent sample overlap when host is busy)
 - Non-blocking CPU sampling using per-tick CPU deltas (no `Atomics.wait` stall)
 - Darwin GPU probing fallback chain (AGX/IOGPU `ioreg` → `powermetrics` → `top` grep) with provenance fields (`gpuSource`, `gpuConfidence`, `gpuSampleWindowMs`)

package/bin/idlewatch-agent.js

@@ -10,15 +10,17 @@ import { createRequire } from 'module'
 import { parseOpenClawUsage } from '../src/openclaw-usage.js'
 import { gpuSampleDarwin } from '../src/gpu.js'
 import { memUsedPct, memoryPressureDarwin } from '../src/memory.js'
+import { thermalSampleDarwin } from '../src/thermal.js'
 import { deriveUsageFreshness } from '../src/usage-freshness.js'
 import { deriveUsageAlert } from '../src/usage-alert.js'
 import { loadLastGoodUsageSnapshot, persistLastGoodUsageSnapshot } from '../src/openclaw-cache.js'
+import { DAY_WINDOW_MS, loadOpenClawActivitySummary } from '../src/openclaw-activity.js'
 import { runEnrollmentWizard } from '../src/enrollment.js'
 import { enrichWithOpenClawFleetTelemetry } from '../src/telemetry-mapping.js'
 import pkg from '../package.json' with { type: 'json' }
 
 function printHelp() {
-  console.log(`idlewatch\n\nUsage:\n  idlewatch [quickstart|configure|dashboard|run] [--dry-run] [--once] [--help]\n\nOptions:\n  quickstart  Run first-run setup and save local IdleWatch config\n  configure   Alias for quickstart; reopen setup to change device name, API key, or metrics\n  dashboard   Launch local dashboard from local IdleWatch logs\n  run         Start the background collector using saved local config\n  --no-tui    Skip the Rust TUI and use plain text setup without installing Cargo\n  --dry-run   Collect and print one telemetry sample, then exit without remote writes\n  --once      Collect and publish one telemetry sample, then exit\n  --help      Show this help message\n\nQuickstart:\n  1. Create an API key on idlewatch.com/api\n  2. Run: idlewatch quickstart\n  3. Pick a device name and metrics\n  4. IdleWatch saves your local config and sends a first sample\n\nEnvironment:\n  IDLEWATCH_HOST                     Optional custom host label (default: hostname)\n  IDLEWATCH_INTERVAL_MS              Sampling interval in ms (default: 10000)\n  IDLEWATCH_LOCAL_LOG_PATH           Optional NDJSON file path for local sample durability\n  IDLEWATCH_DASHBOARD_PORT           Local dashboard HTTP port (default: 4373)\n  IDLEWATCH_OPENCLAW_USAGE           OpenClaw usage lookup mode: auto|off (default: auto)\n  IDLEWATCH_OPENCLAW_PROBE_TIMEOUT_MS OpenClaw command timeout per probe in ms (default: 2500)\n  IDLEWATCH_OPENCLAW_PROBE_RETRIES   Extra OpenClaw probe sweep retries after first pass (default: 1)\n  IDLEWATCH_OPENCLAW_MAX_OUTPUT_BYTES   Max per-command OpenClaw probe output capture in bytes before truncation (default: 2097152 / 2MB)\n  IDLEWATCH_OPENCLAW_MAX_OUTPUT_BYTES_HARD_CAP  Hard cap for auto-retry output capture escalation (default: 16777216 / 16MB)\n  IDLEWATCH_USAGE_STALE_MS           Mark OpenClaw usage stale beyond this age in ms (default: max(interval*3,60000))\n  IDLEWATCH_USAGE_NEAR_STALE_MS      Mark OpenClaw usage as aging beyond this age in ms (default: floor((stale+grace)*0.85))\n  IDLEWATCH_USAGE_STALE_GRACE_MS     Extra grace window before status becomes stale (default: min(interval,10000))\n  IDLEWATCH_USAGE_REFRESH_REPROBES   Forced uncached reprobes when usage crosses stale threshold (default: 1)\n  IDLEWATCH_USAGE_REFRESH_DELAY_MS   Delay between forced stale-threshold reprobes in ms (default: 250)\n  IDLEWATCH_USAGE_REFRESH_ON_NEAR_STALE Trigger refresh when usage is near-stale: 1|0 (default: 1)\n  IDLEWATCH_USAGE_IDLE_AFTER_MS      Downgrade stale usage alerts to idle notice beyond this age in ms (default: 21600000)\n  IDLEWATCH_OPENCLAW_LAST_GOOD_MAX_AGE_MS  Reuse last successful usage snapshot after probe failures up to this age in ms\n  IDLEWATCH_OPENCLAW_LAST_GOOD_CACHE_PATH Persist/reuse last successful usage snapshot across restarts (default: ~/.idlewatch/cache/<host>-openclaw-last-good.json)\n  IDLEWATCH_CLOUD_INGEST_URL         Optional cloud ingest endpoint (e.g. https://idlewatch.com/api/ingest)\n  IDLEWATCH_CLOUD_API_KEY            Cloud API key from idlewatch.com/api for device linking\n  IDLEWATCH_REQUIRE_CLOUD_WRITES     Require cloud publish path in --once mode: 1|0 (default: 0)\n\nAdvanced Firebase / emulator mode:\n  IDLEWATCH_REQUIRE_FIREBASE_WRITES  Require Firebase publish path in --once mode: 1|0 (default: 0)\n  FIREBASE_PROJECT_ID                Firebase project id\n  FIREBASE_SERVICE_ACCOUNT_FILE      Path to service account JSON file (preferred for production)\n  FIREBASE_SERVICE_ACCOUNT_JSON      Raw JSON service account (supported, less secure than file path)\n  FIREBASE_SERVICE_ACCOUNT_B64       Base64-encoded JSON service account (legacy)\n  FIRESTORE_EMULATOR_HOST            Optional Firestore emulator host; allows local writes without service-account creds\n`)
+  console.log(`idlewatch\n\nUsage:\n  idlewatch [quickstart|configure|status|dashboard|run] [--no-tui] [--dry-run] [--once] [--help]\n\nOptions:\n  quickstart  Run first-run setup and save local IdleWatch config\n  configure   Alias for quickstart; reopen setup to change device name, API key, or metrics\n  status      Show current device config, publish mode, and last sample age\n  dashboard   Launch local dashboard from local IdleWatch logs\n  run         Start the background collector using saved local config\n  --no-tui    Skip the Rust TUI and use plain text setup without installing Cargo\n  --dry-run   Collect and print one telemetry sample, then exit without remote writes\n  --once      Collect and publish one telemetry sample, then exit\n  --help      Show this help message\n\nQuickstart:\n  1. Create an API key on idlewatch.com/api\n  2. Run: idlewatch quickstart\n  3. Pick a device name and metrics\n  4. IdleWatch saves your local config and sends a first sample\n\nCommon env (optional):\n  IDLEWATCH_CLOUD_API_KEY            Cloud API key from idlewatch.com/api for device linking\n  IDLEWATCH_CLOUD_INGEST_URL         Cloud ingest endpoint (default: https://api.idlewatch.com/api/ingest)\n  IDLEWATCH_LOCAL_LOG_PATH           Optional NDJSON file path for local sample durability\n  IDLEWATCH_DASHBOARD_PORT           Local dashboard HTTP port (default: 4373)\n  IDLEWATCH_OPENCLAW_USAGE           OpenClaw usage lookup mode: auto|off (default: auto)\n  IDLEWATCH_REQUIRE_CLOUD_WRITES     Require cloud publish path in --once mode: 1|0 (default: 0)\n\nAdvanced env tuning:\n  IDLEWATCH_HOST                     Optional custom host label (default: hostname)\n  IDLEWATCH_INTERVAL_MS              Sampling interval in ms (default: 10000)\n  IDLEWATCH_OPENCLAW_PROBE_TIMEOUT_MS OpenClaw command timeout per probe in ms (default: 2500)\n  IDLEWATCH_OPENCLAW_PROBE_RETRIES   Extra OpenClaw probe sweep retries after first pass (default: 1)\n  IDLEWATCH_OPENCLAW_MAX_OUTPUT_BYTES   Max per-command OpenClaw probe output capture in bytes before truncation (default: 2097152 / 2MB)\n  IDLEWATCH_OPENCLAW_MAX_OUTPUT_BYTES_HARD_CAP  Hard cap for auto-retry output capture escalation (default: 16777216 / 16MB)\n  IDLEWATCH_USAGE_STALE_MS           Mark OpenClaw usage stale beyond this age in ms (default: max(interval*3,60000))\n  IDLEWATCH_USAGE_NEAR_STALE_MS      Mark OpenClaw usage as aging beyond this age in ms (default: floor((stale+grace)*0.85))\n  IDLEWATCH_USAGE_STALE_GRACE_MS     Extra grace window before status becomes stale (default: min(interval,10000))\n  IDLEWATCH_USAGE_REFRESH_REPROBES   Forced uncached reprobes when usage crosses stale threshold (default: 1)\n  IDLEWATCH_USAGE_REFRESH_DELAY_MS   Delay between forced stale-threshold reprobes in ms (default: 250)\n  IDLEWATCH_USAGE_REFRESH_ON_NEAR_STALE Trigger refresh when usage is near-stale: 1|0 (default: 1)\n  IDLEWATCH_USAGE_IDLE_AFTER_MS      Downgrade stale usage alerts to idle notice beyond this age in ms (default: 21600000)\n  IDLEWATCH_OPENCLAW_LAST_GOOD_MAX_AGE_MS  Reuse last successful usage snapshot after probe failures up to this age in ms\n  IDLEWATCH_OPENCLAW_LAST_GOOD_CACHE_PATH Persist/reuse last successful usage snapshot across restarts (default: ~/.idlewatch/cache/<host>-openclaw-last-good.json)\n\nAdvanced Firebase / emulator mode:\n  IDLEWATCH_REQUIRE_FIREBASE_WRITES  Require Firebase publish path in --once mode: 1|0 (default: 0)\n  FIREBASE_PROJECT_ID                Firebase project id\n  FIREBASE_SERVICE_ACCOUNT_FILE      Path to service account JSON file (preferred for production)\n  FIREBASE_SERVICE_ACCOUNT_JSON      Raw JSON service account (supported, less secure than file path)\n  FIREBASE_SERVICE_ACCOUNT_B64       Base64-encoded JSON service account (legacy)\n  FIRESTORE_EMULATOR_HOST            Optional Firestore emulator host; allows local writes without service-account creds\n`)
 }
 
 const require = createRequire(import.meta.url)
@@ -54,8 +56,17 @@ function resolveEnvPath(value) {
   return path.resolve(expandSupportedPathVars(value))
 }
 
+function defaultPersistedEnvFilePath() {
+  return path.join(os.homedir(), '.idlewatch', 'idlewatch.env')
+}
+
+function usesDefaultPersistedEnvFile(envFilePath) {
+  if (!envFilePath) return false
+  return path.resolve(envFilePath) === path.resolve(defaultPersistedEnvFilePath())
+}
+
 function loadPersistedEnvIntoProcess() {
-  const envFile = path.join(os.homedir(), '.idlewatch', 'idlewatch.env')
+  const envFile = defaultPersistedEnvFilePath()
   if (!fs.existsSync(envFile)) return null
 
   try {
@@ -71,11 +82,35 @@ function loadPersistedEnvIntoProcess() {
   }
 }
 
+function buildSetupTestEnv(enrolledEnv) {
+  const nextEnv = { ...process.env }
+
+  for (const key of Object.keys(nextEnv)) {
+    if (
+      key.startsWith('IDLEWATCH_') ||
+      key.startsWith('FIREBASE_') ||
+      key === 'GOOGLE_APPLICATION_CREDENTIALS'
+    ) {
+      delete nextEnv[key]
+    }
+  }
+
+  for (const [key, value] of Object.entries(enrolledEnv || {})) {
+    nextEnv[key] = key.endsWith('_PATH') ? expandSupportedPathVars(value) : value
+  }
+
+  nextEnv.IDLEWATCH_SETUP_VERIFY = '1'
+  return nextEnv
+}
+
 const persistedEnv = loadPersistedEnvIntoProcess()
 
+const OPENCLAW_AGENT_TARGETS = ['agent_activity', 'token_usage', 'runtime_state']
+const OPENCLAW_DERIVED_TARGETS = [...OPENCLAW_AGENT_TARGETS]
+
 function parseMonitorTargets(raw) {
-  const allowed = new Set(['cpu', 'memory', 'gpu', 'openclaw'])
-  const fallback = ['cpu', 'memory', 'openclaw', 'gpu']
+  const allowed = new Set(['cpu', 'memory', 'gpu', 'temperature', 'openclaw', ...OPENCLAW_DERIVED_TARGETS])
+  const fallback = ['cpu', 'memory', 'gpu', 'temperature', ...OPENCLAW_DERIVED_TARGETS]
 
   if (!raw || typeof raw !== 'string') {
     return new Set(fallback)
@@ -85,6 +120,7 @@ function parseMonitorTargets(raw) {
     .split(',')
     .map((item) => item.trim().toLowerCase())
     .filter((item) => allowed.has(item))
+    .flatMap((item) => (item === 'openclaw' ? OPENCLAW_DERIVED_TARGETS : [item]))
 
   if (parsed.length === 0) return new Set(fallback)
   return new Set(parsed)
@@ -203,6 +239,34 @@ function buildLocalDashboardPayload(logPath) {
   }
 }
 
+function buildRollingLoadSummary(logPath, nowMs = Date.now(), windowMs = DAY_WINDOW_MS) {
+  const rows = parseLocalRows(logPath, 20000).filter((row) => Number(row.ts || 0) >= nowMs - windowMs)
+  if (rows.length === 0) return null
+
+  const average = (values) => {
+    const valid = values.filter((value) => Number.isFinite(value))
+    if (valid.length === 0) return null
+    return Number((valid.reduce((sum, value) => sum + value, 0) / valid.length).toFixed(2))
+  }
+
+  const maximum = (values) => {
+    const valid = values.filter((value) => Number.isFinite(value))
+    if (valid.length === 0) return null
+    return Number(Math.max(...valid).toFixed(1))
+  }
+
+  return {
+    windowMs,
+    sampleCount: rows.length,
+    cpuAvgPct: average(rows.map((row) => Number(row.cpuPct))),
+    memAvgPct: average(rows.map((row) => Number(row.memPct))),
+    gpuAvgPct: average(rows.map((row) => Number(row.gpuPct))),
+    tempAvgC: average(rows.map((row) => Number(row.deviceTempC))),
+    tempMaxC: maximum(rows.map((row) => Number(row.deviceTempC))),
+    tokensAvgPerMin: average(rows.map((row) => Number(row.tokensPerMin)))
+  }
+}
+
 function renderLocalDashboardHtml() {
   return `<!doctype html>
 <html>
@@ -355,10 +419,11 @@ function runLocalDashboard({ host }) {
 
 const argv = process.argv.slice(2)
 const args = new Set(argv)
+const statusRequested = argv[0] === 'status' || argv.includes('--status')
 const dashboardRequested = argv[0] === 'dashboard' || argv.includes('--dashboard')
 const runRequested = argv[0] === 'run' || argv.includes('--run')
 const interactiveDefaultRequested = argv.length === 0 && process.stdin.isTTY && process.stdout.isTTY
-const quickstartRequested = argv[0] === 'quickstart' || argv[0] === 'configure' || argv.includes('--quickstart') || argv.includes('--configure') || (interactiveDefaultRequested && !dashboardRequested && !runRequested)
+const quickstartRequested = argv[0] === 'quickstart' || argv[0] === 'configure' || argv.includes('--quickstart') || argv.includes('--configure') || (interactiveDefaultRequested && !dashboardRequested && !runRequested && !statusRequested)
 if (args.has('--help') || args.has('-h')) {
   printHelp()
   process.exit(0)
@@ -381,22 +446,32 @@ if (quickstartRequested) {
     const enrolledEnv = parseEnvFileToObject(result.outputEnvFile)
     const onceRun = spawnSync(process.execPath, [process.argv[1], '--once'], {
       stdio: 'inherit',
-      env: {
-        ...process.env,
-        ...enrolledEnv
-      }
+      env: buildSetupTestEnv(enrolledEnv)
     })
 
     if (onceRun.status === 0) {
       console.log(`✅ Setup complete. Mode=${result.mode} device=${result.deviceName} envFile=${result.outputEnvFile}`)
-      console.log('Initial telemetry sample sent successfully.')
+      if (result.mode === 'local') {
+        console.log('Initial local telemetry check completed successfully.')
+      } else {
+        console.log('Initial telemetry sample sent successfully.')
+      }
+      console.log('To keep this device online continuously, run: idlewatch run')
+      if (process.platform === 'darwin') {
+        console.log('On macOS, you can also enable login startup with the bundled LaunchAgent install script.')
+      }
       process.exit(0)
     }
 
     console.error(`⚠️ Setup is not finished yet. Mode=${result.mode} device=${result.deviceName} envFile=${result.outputEnvFile}`)
     console.error('The first required telemetry sample did not publish successfully, so this device may not be linked yet.')
-    console.error(`Retry with: set -a; source "${result.outputEnvFile}"; set +a && idlewatch --once`)
-    console.error('Or rerun: idlewatch quickstart')
+    if (usesDefaultPersistedEnvFile(result.outputEnvFile)) {
+      console.error('Retry with: idlewatch --once')
+      console.error('Or rerun: idlewatch quickstart')
+    } else {
+      console.error('Retry with: idlewatch quickstart')
+      console.error(`Use the saved config directly: set -a; source "${result.outputEnvFile}"; set +a && idlewatch --once`)
+    }
     process.exit(onceRun.status ?? 1)
   } catch (err) {
     if (String(err?.message || '') === 'setup_cancelled') {
@@ -431,8 +506,12 @@ const MONITOR_TARGETS = parseMonitorTargets(process.env.IDLEWATCH_MONITOR_TARGET
 const MONITOR_CPU = MONITOR_TARGETS.has('cpu')
 const MONITOR_MEMORY = MONITOR_TARGETS.has('memory')
 const MONITOR_GPU = MONITOR_TARGETS.has('gpu')
-const MONITOR_OPENCLAW = MONITOR_TARGETS.has('openclaw')
-const EFFECTIVE_OPENCLAW_MODE = MONITOR_OPENCLAW ? OPENCLAW_USAGE_MODE : 'off'
+const MONITOR_TEMPERATURE = MONITOR_TARGETS.has('temperature')
+const MONITOR_AGENT_ACTIVITY = MONITOR_TARGETS.has('agent_activity')
+const MONITOR_TOKEN_USAGE = MONITOR_TARGETS.has('token_usage')
+const MONITOR_RUNTIME_STATE = MONITOR_TARGETS.has('runtime_state')
+const MONITOR_OPENCLAW_USAGE = MONITOR_TOKEN_USAGE || MONITOR_RUNTIME_STATE
+const EFFECTIVE_OPENCLAW_MODE = MONITOR_OPENCLAW_USAGE ? OPENCLAW_USAGE_MODE : 'off'
 const REQUIRE_FIREBASE_WRITES = process.env.IDLEWATCH_REQUIRE_FIREBASE_WRITES === '1'
 const CLOUD_INGEST_URL = (process.env.IDLEWATCH_CLOUD_INGEST_URL || '').trim()
 const CLOUD_API_KEY = (process.env.IDLEWATCH_CLOUD_API_KEY || '').trim().replace(/^['"]|['"]$/g, '')
@@ -638,9 +717,64 @@ const hasAnyFirebaseConfig = Boolean(PROJECT_ID || CREDS_FILE || CREDS_JSON || C
 const hasCloudConfig = Boolean(CLOUD_INGEST_URL && CLOUD_API_KEY)
 const shouldWarnAboutMissingPublishConfig = !appReady && !hasCloudConfig && !DRY_RUN && !hasAnyFirebaseConfig
 
+function getPublishModeLabel() {
+  if (hasCloudConfig) return 'cloud'
+  if (appReady) return 'firebase'
+  return 'local-only'
+}
+
+if (statusRequested) {
+  const envFile = defaultPersistedEnvFilePath()
+  const hasConfig = fs.existsSync(envFile)
+  const publishMode = getPublishModeLabel()
+
+  console.log('IdleWatch status')
+  console.log('')
+  console.log(`  Device:       ${DEVICE_NAME}`)
+  console.log(`  Device ID:    ${DEVICE_ID}`)
+  console.log(`  Publish mode: ${publishMode}`)
+  if (hasCloudConfig) {
+    console.log(`  Cloud link:   ${CLOUD_INGEST_URL}`)
+    console.log(`  API key:      ${CLOUD_API_KEY.slice(0, 8)}..${CLOUD_API_KEY.slice(-4)}`)
+  }
+  console.log(`  Metrics:      ${[...MONITOR_TARGETS].join(', ')}`)
+  console.log(`  Local log:    ${LOCAL_LOG_PATH || '(none)'}`)
+  console.log(`  Config:       ${hasConfig ? envFile : '(no saved config)'}`)
+
+  let hasSamples = false
+  if (LOCAL_LOG_PATH && fs.existsSync(LOCAL_LOG_PATH)) {
+    try {
+      const stat = fs.statSync(LOCAL_LOG_PATH)
+      console.log(`  Log size:     ${formatBytes(stat.size)}`)
+      const rows = parseLocalRows(LOCAL_LOG_PATH, 1)
+      if (rows.length > 0 && rows[0].ts) {
+        hasSamples = true
+        const ageMs = Date.now() - Number(rows[0].ts)
+        const ageSec = Math.round(ageMs / 1000)
+        const agoText = ageSec < 60 ? `${ageSec}s ago` : ageSec < 3600 ? `${Math.round(ageSec / 60)}m ago` : ageSec < 86400 ? `${Math.round(ageSec / 3600)}h ago` : `${Math.round(ageSec / 86400)}d ago`
+        console.log(`  Last sample:  ${agoText}`)
+      } else {
+        console.log('  Last sample:  (none yet)')
+      }
+    } catch { /* ignore stat errors */ }
+  } else if (hasConfig) {
+    console.log('  Last sample:  (none yet)')
+  }
+
+  console.log('')
+  if (!hasConfig) {
+    console.log('  Run idlewatch quickstart to set up this device.')
+  } else if (!hasSamples) {
+    console.log('  Run idlewatch --once to collect a test sample, or idlewatch run for continuous monitoring.')
+  } else {
+    console.log('  Run idlewatch configure to change device name, metrics, or API key.')
+  }
+  process.exit(0)
+}
+
 if (shouldWarnAboutMissingPublishConfig) {
   console.error(
-    'No publish target is configured yet. Running in local-only mode. Run idlewatch quickstart to link cloud ingest, or configure Firebase/emulator mode if you need that path.'
+    'Local-only mode: this run will stay on this Mac until you link a publish target. Run idlewatch quickstart any time if you want cloud ingest.'
   )
 }
 
@@ -1202,7 +1336,9 @@ async function publish(row, retries = 2) {
 
 async function collectSample() {
   const sampleStartMs = Date.now()
-  const openclawEnabled = EFFECTIVE_OPENCLAW_MODE !== 'off'
+  const dayLoadSummary = buildRollingLoadSummary(LOCAL_LOG_PATH, sampleStartMs)
+  const openclawUsageEnabled = EFFECTIVE_OPENCLAW_MODE !== 'off'
+  const activitySummary = MONITOR_AGENT_ACTIVITY ? loadOpenClawActivitySummary({ nowMs: sampleStartMs }) : null
 
   const disabledProbe = {
     result: 'disabled',
@@ -1215,7 +1351,7 @@ async function collectSample() {
     fallbackCacheSource: null
   }
 
-  let usageProbe = openclawEnabled ? loadOpenClawUsage() : { usage: null, probe: disabledProbe }
+  let usageProbe = openclawUsageEnabled ? loadOpenClawUsage() : { usage: null, probe: disabledProbe }
   let usage = usageProbe.usage
   let usageFreshness = deriveUsageFreshness(usage, sampleStartMs, USAGE_STALE_MS, USAGE_NEAR_STALE_MS, USAGE_STALE_GRACE_MS)
   let usageRefreshAttempted = false
@@ -1227,7 +1363,7 @@ async function collectSample() {
   const shouldRefreshForNearStale = USAGE_REFRESH_ON_NEAR_STALE === 1 && usageFreshness.isNearStale
   const canRefreshFromCurrentState = usageProbe.probe.result === 'ok' || usageProbe.probe.result === 'fallback-cache'
 
-  if (openclawEnabled && usage && (usageFreshness.isPastStaleThreshold || shouldRefreshForNearStale) && canRefreshFromCurrentState) {
+  if (openclawUsageEnabled && usage && (usageFreshness.isPastStaleThreshold || shouldRefreshForNearStale) && canRefreshFromCurrentState) {
     usageRefreshAttempted = true
     usageRefreshStartMs = Date.now()
 
@@ -1271,6 +1407,9 @@ async function collectSample() {
     : { pct: null, cls: 'disabled', source: 'disabled' }
 
   const usedMemPct = MONITOR_MEMORY ? memUsedPct() : null
+  const thermals = MONITOR_TEMPERATURE && process.platform === 'darwin'
+    ? thermalSampleDarwin()
+    : { tempC: null, source: 'disabled', thermalLevel: null, thermalState: MONITOR_TEMPERATURE ? 'unavailable' : 'disabled' }
 
   const usageIntegrationStatus = usage
     ? usageFreshness.isStale
@@ -1278,20 +1417,20 @@ async function collectSample() {
       : usage?.integrationStatus === 'partial'
         ? 'ok'
         : (usage?.integrationStatus ?? 'ok')
-    : (openclawEnabled ? 'unavailable' : 'disabled')
+    : (openclawUsageEnabled ? 'unavailable' : 'disabled')
 
   const source = {
     monitorTargets: [...MONITOR_TARGETS],
-    usage: usage ? 'openclaw' : openclawEnabled ? 'unavailable' : 'disabled',
+    usage: usage ? 'openclaw' : openclawUsageEnabled ? 'unavailable' : 'disabled',
     usageIntegrationStatus,
-    usageIngestionStatus: openclawEnabled
+    usageIngestionStatus: openclawUsageEnabled
       ? usage && ['ok', 'fallback-cache'].includes(usageProbe.probe.result)
         ? 'ok'
         : 'unavailable'
       : 'disabled',
     usageActivityStatus: usage
       ? usageFreshness.freshnessState
-      : (openclawEnabled ? 'unavailable' : 'disabled'),
+      : (openclawUsageEnabled ? 'unavailable' : 'disabled'),
     usageProbeResult: usageProbe.probe.result,
     usageProbeAttempts: usageProbe.probe.attempts,
     usageProbeSweeps: usageProbe.probe.sweeps,
@@ -1302,7 +1441,7 @@ async function collectSample() {
     usageUsedFallbackCache: usageProbe.probe.usedFallbackCache,
     usageFallbackCacheAgeMs: usageProbe.probe.fallbackAgeMs,
     usageFallbackCacheSource: usageProbe.probe.fallbackCacheSource,
-    usageFreshnessState: openclawEnabled
+    usageFreshnessState: openclawUsageEnabled
       ? usage
         ? usageFreshness.freshnessState
         : null
@@ -1322,6 +1461,10 @@ async function collectSample() {
     usageStaleMsThreshold: USAGE_STALE_MS,
     usageNearStaleMsThreshold: USAGE_NEAR_STALE_MS,
     usageStaleGraceMs: USAGE_STALE_GRACE_MS,
+    activitySource: activitySummary?.source ?? (MONITOR_AGENT_ACTIVITY ? 'unavailable' : 'disabled'),
+    activityWindowMs: MONITOR_AGENT_ACTIVITY ? (activitySummary?.windowMs ?? null) : null,
+    thermalSource: thermals.source,
+    thermalState: thermals.thermalState,
     memPressureSource: memPressure.source,
     cloudIngestionStatus: CLOUD_INGEST_URL && CLOUD_API_KEY
       ? cloudIngestKickedOut ? 'kicked-out' : 'enabled'
@@ -1346,16 +1489,37 @@ async function collectSample() {
     memPressurePct: MONITOR_MEMORY ? memPressure.pct : null,
     memPressureClass: MONITOR_MEMORY ? memPressure.cls : 'disabled',
     gpuPct: MONITOR_GPU ? gpu.pct : null,
+    deviceTempC: MONITOR_TEMPERATURE ? thermals.tempC : null,
+    thermalLevel: MONITOR_TEMPERATURE ? thermals.thermalLevel : null,
+    thermalState: MONITOR_TEMPERATURE ? thermals.thermalState : 'disabled',
+    dayWindowMs: dayLoadSummary?.windowMs ?? DAY_WINDOW_MS,
+    dayCpuAvgPct: MONITOR_CPU ? (dayLoadSummary?.cpuAvgPct ?? null) : null,
+    dayMemAvgPct: MONITOR_MEMORY ? (dayLoadSummary?.memAvgPct ?? null) : null,
+    dayGpuAvgPct: MONITOR_GPU ? (dayLoadSummary?.gpuAvgPct ?? null) : null,
+    dayTempAvgC: MONITOR_TEMPERATURE ? (dayLoadSummary?.tempAvgC ?? null) : null,
+    dayTempMaxC: MONITOR_TEMPERATURE ? (dayLoadSummary?.tempMaxC ?? null) : null,
+    dayTokensAvgPerMin: MONITOR_TOKEN_USAGE ? (dayLoadSummary?.tokensAvgPerMin ?? null) : null,
     gpuSource: gpu.source,
     gpuConfidence: gpu.confidence,
     gpuSampleWindowMs: gpu.sampleWindowMs,
-    tokensPerMin: MONITOR_OPENCLAW ? (usage?.tokensPerMin ?? null) : null,
-    openclawModel: MONITOR_OPENCLAW ? (usage?.model ?? null) : null,
-    openclawTotalTokens: MONITOR_OPENCLAW ? (usage?.totalTokens ?? null) : null,
-    openclawSessionId: MONITOR_OPENCLAW ? (usage?.sessionId ?? null) : null,
-    openclawAgentId: MONITOR_OPENCLAW ? (usage?.agentId ?? null) : null,
-    openclawUsageTs: MONITOR_OPENCLAW ? (usage?.usageTimestampMs ?? null) : null,
-    openclawUsageAgeMs: MONITOR_OPENCLAW ? usageFreshness.usageAgeMs : null,
+    tokensPerMin: MONITOR_TOKEN_USAGE ? (usage?.tokensPerMin ?? null) : null,
+    openclawModel: MONITOR_RUNTIME_STATE ? (usage?.model ?? null) : null,
+    openclawProvider: MONITOR_RUNTIME_STATE ? (usage?.provider ?? null) : null,
+    openclawTotalTokens: MONITOR_TOKEN_USAGE ? (usage?.totalTokens ?? null) : null,
+    openclawInputTokens: MONITOR_TOKEN_USAGE ? (usage?.inputTokens ?? null) : null,
+    openclawOutputTokens: MONITOR_TOKEN_USAGE ? (usage?.outputTokens ?? null) : null,
+    openclawRemainingTokens: openclawUsageEnabled ? (usage?.remainingTokens ?? null) : null,
+    openclawPercentUsed: openclawUsageEnabled ? (usage?.percentUsed ?? null) : null,
+    openclawContextTokens: openclawUsageEnabled ? (usage?.contextTokens ?? null) : null,
+    openclawBudgetKind: openclawUsageEnabled ? (usage?.budgetKind ?? null) : null,
+    openclawSessionId: openclawUsageEnabled ? (usage?.sessionId ?? null) : null,
+    openclawAgentId: openclawUsageEnabled ? (usage?.agentId ?? null) : null,
+    openclawUsageTs: openclawUsageEnabled ? (usage?.usageTimestampMs ?? null) : null,
+    openclawUsageAgeMs: openclawUsageEnabled ? usageFreshness.usageAgeMs : null,
+    activityWindowMs: MONITOR_AGENT_ACTIVITY ? (activitySummary?.windowMs ?? null) : null,
+    activityActiveSeconds: MONITOR_AGENT_ACTIVITY ? (activitySummary?.totalActiveSeconds ?? null) : null,
+    activityIdleSeconds: MONITOR_AGENT_ACTIVITY ? (activitySummary?.idleSeconds ?? null) : null,
+    activityJobs: MONITOR_AGENT_ACTIVITY ? (activitySummary?.jobs ?? []) : [],
     localLogPath: LOCAL_LOG_PATH,
     localLogBytes: null,
     source
@@ -1369,21 +1533,43 @@ async function collectSample() {
   })
 }
 
+function summarizeSetupVerification(row) {
+  const metrics = []
+  if (row.cpuPct !== null && row.cpuPct !== undefined) metrics.push('cpu')
+  if (row.memPct !== null && row.memPct !== undefined) metrics.push('memory')
+  if (row.gpuPct !== null && row.gpuPct !== undefined) metrics.push('gpu')
+  if (row.tokensPerMin !== null && row.tokensPerMin !== undefined) metrics.push('openclaw')
+
+  const details = [
+    `mode=${getPublishModeLabel()}`,
+    `metrics=${metrics.length ? metrics.join(',') : 'none'}`
+  ]
+
+  if (row.localLogPath) details.push(`localLog=${row.localLogPath}`)
+  return `Initial sample ready (${details.join(' ')})`
+}
+
 async function tick() {
   const row = await collectSample()
   const localUsage = appendLocal(row)
   row.localLogPath = localUsage.path
   row.localLogBytes = localUsage.bytes
 
-  console.log(JSON.stringify(row))
+  if (process.env.IDLEWATCH_SETUP_VERIFY === '1') {
+    console.log(summarizeSetupVerification(row))
+  } else {
+    console.log(JSON.stringify(row))
+  }
 
   const published = await publish(row)
 
   if (cloudIngestKickedOut && !cloudIngestKickoutNotified) {
     cloudIngestKickoutNotified = true
-    console.error(
-      `Cloud ingest disabled: API key rejected (${cloudIngestKickoutReason || 'unauthorized'}). Run idlewatch quickstart to link a new key.`
-    )
+    if (!(REQUIRE_CLOUD_WRITES && ONCE)) {
+      console.error(
+        `Cloud ingest disabled: API key rejected (${cloudIngestKickoutReason || 'unauthorized'}). Run idlewatch quickstart to link a new key.`
+      )
+    }
   }
 
   if (REQUIRE_FIREBASE_WRITES && ONCE && !published) {
@@ -1436,7 +1622,7 @@ process.on('SIGTERM', () => gracefulShutdown('SIGTERM'))
 if (DRY_RUN || ONCE) {
   const mode = DRY_RUN ? 'dry-run' : 'once'
   console.log(
-    `idlewatch ${mode} host=${HOST} device=${DEVICE_NAME} deviceId=${DEVICE_ID} intervalMs=${INTERVAL_MS} firebase=${appReady} localLog=${LOCAL_LOG_PATH} env=${persistedEnv?.envFile || 'process'}`
+    `idlewatch ${mode} host=${HOST} device=${DEVICE_NAME} deviceId=${DEVICE_ID} intervalMs=${INTERVAL_MS} publish=${getPublishModeLabel()} localLog=${LOCAL_LOG_PATH} env=${persistedEnv?.envFile || 'process'}`
   )
   tick()
     .then(() => process.exit(0))
@@ -1446,7 +1632,7 @@ if (DRY_RUN || ONCE) {
     })
 } else {
   console.log(
-    `idlewatch started host=${HOST} device=${DEVICE_NAME} deviceId=${DEVICE_ID} intervalMs=${INTERVAL_MS} firebase=${appReady} localLog=${LOCAL_LOG_PATH} monitorTargets=${[...MONITOR_TARGETS].join(',')} openclawUsage=${EFFECTIVE_OPENCLAW_MODE} env=${persistedEnv?.envFile || 'process'}`
+    `idlewatch started host=${HOST} device=${DEVICE_NAME} deviceId=${DEVICE_ID} intervalMs=${INTERVAL_MS} publish=${getPublishModeLabel()} localLog=${LOCAL_LOG_PATH} monitorTargets=${[...MONITOR_TARGETS].join(',')} openclawUsage=${EFFECTIVE_OPENCLAW_MODE} env=${persistedEnv?.envFile || 'process'}`
   )
   loop()
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "idlewatch",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Host telemetry collector for IdleWatch",
   "type": "module",
   "files": [
@@ -25,7 +25,7 @@
     "quickstart": "node bin/idlewatch-agent.js quickstart",
     "validate:bin": "node scripts/validate-bin.mjs",
     "validate:onboarding": "node scripts/validate-onboarding.mjs",
-    "test:unit": "node --test 'test/*.test.mjs'",
+    "test:unit": "node --test --test-concurrency=1 'test/*.test.mjs'",
     "smoke:help": "node bin/idlewatch-agent.js --help",
     "smoke:dry-run": "node bin/idlewatch-agent.js --dry-run",
     "smoke:once": "IDLEWATCH_OPENCLAW_USAGE=off node bin/idlewatch-agent.js --once",

package/scripts/install-macos-launch-agent.sh

@@ -13,6 +13,18 @@ if [[ $START_INTERVAL_SEC -lt 60 ]]; then
 fi
 
 PLIST_PATH="$PLIST_ROOT/$PLIST_LABEL.plist"
+CONFIG_ENV_PATH="${IDLEWATCH_CONFIG_ENV_PATH:-$HOME/.idlewatch/idlewatch.env}"
+DEFAULT_APP_PATH="/Applications/IdleWatch.app"
+DEFAULT_PLIST_ROOT="$HOME/Library/LaunchAgents"
+DEFAULT_PLIST_LABEL="com.idlewatch.agent"
+
+if [[ "$PLIST_LABEL" == "$DEFAULT_PLIST_LABEL" ]] && \
+   [[ "$PLIST_ROOT" != "$DEFAULT_PLIST_ROOT" || "$APP_PATH" != "$DEFAULT_APP_PATH" ]]; then
+  echo "Refusing to reuse the default LaunchAgent label ($DEFAULT_PLIST_LABEL) with a custom app path or plist root." >&2
+  echo "launchd uses the label as the real identity, so this could replace your already-loaded IdleWatch agent." >&2
+  echo "Use IDLEWATCH_LAUNCH_AGENT_LABEL to pick a different label for side-by-side QA/dev installs." >&2
+  exit 1
+fi
 
 if [[ ! -d "$PLIST_ROOT" ]]; then
   mkdir -p "$PLIST_ROOT"
@@ -77,3 +89,20 @@ launchctl bootstrap "gui/$USER_GUID" "$PLIST_PATH"
 launchctl enable "$PLIST_ID"
 echo "Installed LaunchAgent: $PLIST_ID"
 echo "Plist: $PLIST_PATH"
+echo "Logs: $LOG_DIR/idlewatch.out.log and $LOG_DIR/idlewatch.err.log"
+if [[ -f "$CONFIG_ENV_PATH" ]]; then
+  echo "Saved IdleWatch config found: $CONFIG_ENV_PATH"
+  if [[ "$CONFIG_ENV_PATH" == "$HOME/.idlewatch/idlewatch.env" ]]; then
+    echo "Background runs will auto-load it."
+  else
+    echo "Background runs auto-load only the default path: $HOME/.idlewatch/idlewatch.env"
+    echo "Move or copy this config there if you want login startup to reuse it automatically."
+  fi
+else
+  echo "No saved IdleWatch config found yet at: $CONFIG_ENV_PATH"
+  echo "Finish setup once before relying on login startup:"
+  echo "  \"$BIN_PATH\" quickstart"
+  if command -v idlewatch >/dev/null 2>&1; then
+    echo "If you already installed the CLI on PATH, 'idlewatch quickstart' works too."
+  fi
+fi

package/scripts/validate-dry-run-schema.mjs

@@ -92,6 +92,9 @@ function validateRow(row) {
   assert.equal(typeof row.gpuSource, 'string', 'gpuSource must be string')
   assert.ok(['high', 'medium', 'low', 'none'].includes(row.gpuConfidence), 'gpuConfidence invalid')
   assertNumberOrNull(row.gpuSampleWindowMs, 'gpuSampleWindowMs')
+  assertNumberOrNull(row.deviceTempC, 'deviceTempC')
+  assertNumberOrNull(row.dayTempAvgC, 'dayTempAvgC')
+  assertNumberOrNull(row.dayTempMaxC, 'dayTempMaxC')
 
   assertNumberOrNull(row.tokensPerMin, 'tokensPerMin')
   assert.ok(row.openclawModel === null || typeof row.openclawModel === 'string', 'openclawModel must be string or null')
@@ -115,6 +118,7 @@ function validateRow(row) {
   assertNumberOrNull(row.fleet.resources.memUsedPct, 'fleet.resources.memUsedPct')
   assertNumberOrNull(row.fleet.resources.memPressurePct, 'fleet.resources.memPressurePct')
   assert.ok(['normal', 'warning', 'critical', 'unavailable'].includes(row.fleet.resources.memPressureClass), 'fleet.resources.memPressureClass invalid')
+  assertNumberOrNull(row.fleet.resources.tempC, 'fleet.resources.tempC')
   assert.equal(typeof row.fleet.usage, 'object', 'fleet.usage must exist')
   assert.ok(row.fleet.usage.model === null || typeof row.fleet.usage.model === 'string', 'fleet.usage.model invalid')
   assertNumberOrNull(row.fleet.usage.totalTokens, 'fleet.usage.totalTokens')

package/scripts/validate-onboarding.mjs

@@ -68,9 +68,9 @@ try {
     IDLEWATCH_CLOUD_INGEST_URL: cloudIngestUrl,
     IDLEWATCH_ENROLL_OUTPUT_ENV_FILE: envOut,
     IDLEWATCH_ENROLL_CONFIG_DIR: configDir,
-    IDLEWATCH_DEVICE_NAME: 'Validator Box',
+    IDLEWATCH_ENROLL_DEVICE_NAME: 'Validator Box',
     IDLEWATCH_DEVICE_ID: 'validator-box',
-    IDLEWATCH_MONITOR_TARGETS: 'cpu,memory',
+    IDLEWATCH_ENROLL_MONITOR_TARGETS: 'cpu,memory',
     IDLEWATCH_OPENCLAW_USAGE: 'off'
   })