hae-vault 0.1.0

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "hae-vault",
+  "version": "0.1.0",
+  "description": "CLI + HTTP server for Apple Health data from Health Auto Export",
+  "type": "module",
+  "bin": {
+    "hvault": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepare": "npm run build",
+    "test": "tsx --test tests/**/*.test.ts"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "keywords": [
+    "apple-health",
+    "health-auto-export",
+    "sqlite",
+    "cli",
+    "hvault",
+    "sleep",
+    "hrv",
+    "steps",
+    "fitness",
+    "hae"
+  ],
+  "author": "Ruben Khachaturov <mr.kha4a2rov@protonmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrkhachaturov/hae-vault.git"
+  },
+  "homepage": "https://github.com/mrkhachaturov/hae-vault#readme",
+  "bugs": {
+    "url": "https://github.com/mrkhachaturov/hae-vault/issues"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "better-sqlite3": "^12.6.2",
+    "commander": "^12.1.0",
+    "dotenv": "^17.3.1",
+    "express": "^4.21.0"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}

package/src/cli/dashboard.ts

@@ -0,0 +1,242 @@
+import { Command } from 'commander';
+import { openDb } from '../db/schema.js';
+
+// ── helpers ──────────────────────────────────────────────────────────────────
+
+function pad(s: string, width: number): string {
+  return s.padEnd(width);
+}
+
+function fmt1(n: number | null | undefined): string {
+  if (n == null) return '—';
+  return n.toFixed(1);
+}
+
+function fmtInt(n: number | null | undefined): string {
+  if (n == null) return '—';
+  return Math.round(n).toLocaleString();
+}
+
+function sec2min(s: number | null | undefined): string {
+  if (s == null) return '—';
+  return `${Math.round(s / 60)}min`;
+}
+
+function kj2kcal(kj: number | null | undefined): string {
+  if (kj == null) return '—';
+  return `${Math.round(kj / 4.184)} kcal`;
+}
+
+function arrow(first: number, last: number): string {
+  const delta = last - first;
+  if (Math.abs(delta) < 0.01 * Math.abs(first || 1)) return '→';
+  return delta > 0 ? '↑' : '↓';
+}
+
+function ruler(label: string, width = 43): string {
+  const inner = `── ${label} `;
+  return inner + '─'.repeat(Math.max(0, width - inner.length));
+}
+
+function workoutEmoji(name: string): string {
+  const n = name.toLowerCase();
+  if (n.includes('run')) return '🏃';
+  if (n.includes('walk')) return '🚶';
+  if (n.includes('cycl') || n.includes('bike')) return '🚴';
+  if (n.includes('swim')) return '🏊';
+  if (n.includes('yoga')) return '🧘';
+  if (n.includes('strength') || n.includes('weight') || n.includes('lift')) return '🏋️';
+  if (n.includes('hike')) return '🥾';
+  return '🏅';
+}
+
+function latestMetric(
+  db: ReturnType<typeof openDb>,
+  metricName: string,
+  days = 7
+): number | null {
+  const since = new Date();
+  since.setDate(since.getDate() - days);
+  const row = db.prepare(
+    `SELECT qty FROM metrics WHERE metric = ? AND date >= ? AND qty IS NOT NULL ORDER BY ts DESC LIMIT 1`
+  ).get(metricName, since.toISOString().slice(0, 10)) as { qty: number } | undefined;
+  return row?.qty ?? null;
+}
+
+function dailyAvgs(
+  db: ReturnType<typeof openDb>,
+  metricName: string,
+  days: number
+): number[] {
+  const since = new Date();
+  since.setDate(since.getDate() - days);
+  const rows = db.prepare(
+    `SELECT date, AVG(qty) as avg_qty FROM metrics
+     WHERE metric = ? AND date >= ? AND qty IS NOT NULL
+     GROUP BY date ORDER BY date ASC`
+  ).all(metricName, since.toISOString().slice(0, 10)) as { date: string; avg_qty: number }[];
+  return rows.map(r => r.avg_qty);
+}
+
+function sleepDailyAvgs(
+  db: ReturnType<typeof openDb>,
+  days: number
+): number[] {
+  const since = new Date();
+  since.setDate(since.getDate() - days);
+  const rows = db.prepare(
+    `SELECT asleep_h FROM sleep WHERE date >= ? AND asleep_h IS NOT NULL ORDER BY date ASC`
+  ).all(since.toISOString().slice(0, 10)) as { asleep_h: number }[];
+  return rows.map(r => r.asleep_h);
+}
+
+function trendLine(
+  values: number[],
+  label: string,
+  unit: string,
+  round = false
+): string {
+  if (values.length < 2) return '';
+  const avg = values.reduce((a, b) => a + b, 0) / values.length;
+  const first = values[0];
+  const last = values[values.length - 1];
+  const dir = arrow(first, last);
+  const fmt = round ? fmtInt : fmt1;
+  return `   ${pad(label + ':', 14)} ${fmt(first)} → ${fmt(last)}${unit} ${dir}  (avg ${fmt(avg)})`;
+}
+
+// ── command ───────────────────────────────────────────────────────────────────
+
+export const dashboardCommand = new Command('dashboard')
+  .description('Terminal dashboard: sleep, activity, heart health, workouts, trends')
+  .option('--days <n>', 'Trend window in days', '7')
+  .option('--json', 'Output raw JSON')
+  .action((opts) => {
+    const db = openDb();
+    const trendDays = parseInt(opts.days, 10);
+    const today = new Date().toISOString().slice(0, 10);
+
+    // ── sleep (last night) ─────────────────────────────────────────────────
+    const sleep = db.prepare(
+      `SELECT * FROM sleep ORDER BY date DESC LIMIT 1`
+    ).get() as {
+      date: string; asleep_h: number | null; in_bed_h: number | null;
+      deep_h: number | null; rem_h: number | null; awake_h: number | null;
+      source: string | null;
+    } | undefined;
+
+    // ── activity (today, fallback last 2 days) ─────────────────────────────
+    const steps = latestMetric(db, 'step_count', 2);
+    const activeCal = latestMetric(db, 'active_energy_burned', 2);
+    const standHours = latestMetric(db, 'apple_stand_hour', 2);
+
+    // ── heart health (last 7 days) ─────────────────────────────────────────
+    const restingHR = latestMetric(db, 'resting_heart_rate', 7);
+    const hrv = latestMetric(db, 'heart_rate_variability_sdnn', 7);
+
+    // ── recent workouts ────────────────────────────────────────────────────
+    const workouts = db.prepare(
+      `SELECT date, name, duration_s, calories_kj, avg_hr FROM workouts ORDER BY ts DESC LIMIT 5`
+    ).all() as { date: string; name: string; duration_s: number | null; calories_kj: number | null; avg_hr: number | null }[];
+
+    // ── trends ────────────────────────────────────────────────────────────
+    const stepTrend = dailyAvgs(db, 'step_count', trendDays);
+    const hrTrend = dailyAvgs(db, 'resting_heart_rate', trendDays);
+    const hrvTrend = dailyAvgs(db, 'heart_rate_variability_sdnn', trendDays);
+    const sleepTrend = sleepDailyAvgs(db, trendDays);
+
+    // ── vault stats ───────────────────────────────────────────────────────
+    const metricsCount = (db.prepare('SELECT COUNT(*) as c FROM metrics').get() as { c: number }).c;
+    const sleepCount = (db.prepare('SELECT COUNT(*) as c FROM sleep').get() as { c: number }).c;
+    const workoutsCount = (db.prepare('SELECT COUNT(*) as c FROM workouts').get() as { c: number }).c;
+    const lastSync = db.prepare('SELECT received_at FROM sync_log ORDER BY received_at DESC LIMIT 1').get() as { received_at: string } | undefined;
+
+    if (opts.json) {
+      console.log(JSON.stringify({
+        date: today,
+        sleep: sleep ?? null,
+        activity: { steps, activeCal, standHours },
+        heartHealth: { restingHR, hrv },
+        workouts,
+        trends: { steps: stepTrend, restingHR: hrTrend, hrv: hrvTrend, sleep: sleepTrend },
+        vault: { metricsCount, sleepCount, workoutsCount, lastSync: lastSync?.received_at ?? null }
+      }, null, 2));
+      return;
+    }
+
+    const lines: string[] = [];
+    lines.push(`📅 ${today} | Apple Health Vault`);
+    lines.push('');
+
+    // sleep
+    lines.push(ruler('Sleep (last night)'));
+    if (sleep) {
+      const eff = sleep.in_bed_h && sleep.asleep_h
+        ? Math.round((sleep.asleep_h / sleep.in_bed_h) * 100) : null;
+      lines.push(`😴 ${fmt1(sleep.asleep_h)}h | Efficiency: ${eff != null ? eff + '%' : '—'}`);
+      const light = (sleep.asleep_h ?? 0) - (sleep.deep_h ?? 0) - (sleep.rem_h ?? 0);
+      const deepPct = sleep.asleep_h ? Math.round(((sleep.deep_h ?? 0) / sleep.asleep_h) * 100) : 0;
+      const remPct = sleep.asleep_h ? Math.round(((sleep.rem_h ?? 0) / sleep.asleep_h) * 100) : 0;
+      const lightPct = sleep.asleep_h ? Math.round((light / sleep.asleep_h) * 100) : 0;
+      lines.push(`   Deep: ${fmt1(sleep.deep_h)}h (${deepPct}%) | REM: ${fmt1(sleep.rem_h)}h (${remPct}%) | Light: ${fmt1(light)}h (${lightPct}%)`);
+      lines.push(`   Awake: ${fmt1(sleep.awake_h)}h | Source: ${sleep.source ?? '—'}`);
+    } else {
+      lines.push('   No sleep data');
+    }
+    lines.push('');
+
+    // activity
+    lines.push(ruler('Activity (recent)'));
+    const actParts: string[] = [];
+    if (steps != null) actParts.push(`👟 ${fmtInt(steps)} steps`);
+    if (activeCal != null) actParts.push(`🔥 ${fmtInt(activeCal)} kcal active`);
+    if (actParts.length > 0) {
+      lines.push(actParts.join(' | '));
+      if (standHours != null) lines.push(`   Stand hours: ${Math.round(standHours)}`);
+    } else {
+      lines.push('   No activity data');
+    }
+    lines.push('');
+
+    // heart health
+    lines.push(ruler('Heart Health'));
+    const hh: string[] = [];
+    if (restingHR != null) hh.push(`💓 Resting HR: ${Math.round(restingHR)}bpm`);
+    if (hrv != null) hh.push(`HRV: ${Math.round(hrv)}ms`);
+    lines.push(hh.length > 0 ? hh.join(' | ') : '   No heart data');
+    lines.push('');
+
+    // workouts
+    lines.push(ruler('Recent Workouts'));
+    if (workouts.length > 0) {
+      for (const w of workouts) {
+        const emoji = workoutEmoji(w.name);
+        const namePadded = pad(w.name, 18);
+        const dur = sec2min(w.duration_s);
+        const cal = kj2kcal(w.calories_kj);
+        lines.push(`${emoji} ${w.date}  ${namePadded} ${dur}  ${cal}`);
+      }
+    } else {
+      lines.push('   No workout data');
+    }
+    lines.push('');
+
+    // trends
+    lines.push(ruler(`${trendDays}-Day Trends`));
+    const tl: string[] = [
+      trendLine(stepTrend, 'Steps', '', true),
+      trendLine(sleepTrend, 'Sleep', 'h'),
+      trendLine(hrTrend, 'Resting HR', 'bpm', true),
+      trendLine(hrvTrend, 'HRV', 'ms', true),
+    ].filter(Boolean);
+    if (tl.length > 0) lines.push(...tl);
+    else lines.push('   Insufficient data for trends');
+    lines.push('');
+
+    // vault stats
+    lines.push(ruler('Vault Stats'));
+    lines.push(`   Metrics: ${metricsCount.toLocaleString()} | Sleep: ${sleepCount} | Workouts: ${workoutsCount}`);
+    lines.push(`   Last sync: ${lastSync?.received_at ? new Date(lastSync.received_at).toISOString().replace('T', ' ').slice(0, 16) + ' UTC' : 'never'}`);
+
+    console.log(lines.join('\n'));
+  });

package/src/cli/import.ts

@@ -0,0 +1,85 @@
+import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import { openDb } from '../db/schema.js';
+import { ingest } from '../server/ingest.js';
+import { hasBeenImported, logImport } from '../db/importLog.js';
+import { extractPayloadFromZip } from '../util/zip.js';
+import { config } from '../config.js';
+import type { HaePayload } from '../types/hae.js';
+
+function sha256(buf: Buffer): string {
+  return createHash('sha256').update(buf).digest('hex');
+}
+
+function loadFile(file: string): { payload: HaePayload; hash: string } {
+  let buf: Buffer;
+  try {
+    buf = readFileSync(file);
+  } catch (err) {
+    console.error(JSON.stringify({ error: `Cannot read file: ${String(err)}` }));
+    process.exit(1);
+  }
+
+  const hash = sha256(buf);
+
+  let payload: HaePayload | null;
+  if (file.toLowerCase().endsWith('.zip')) {
+    payload = extractPayloadFromZip(buf);
+    if (!payload) {
+      console.error(JSON.stringify({ error: 'No valid HealthAutoExport-*.json found in zip' }));
+      process.exit(1);
+    }
+  } else {
+    try {
+      payload = JSON.parse(buf.toString('utf-8')) as HaePayload;
+    } catch (err) {
+      console.error(JSON.stringify({ error: `Invalid JSON: ${String(err)}` }));
+      process.exit(1);
+    }
+    if (!payload?.data) {
+      console.error(JSON.stringify({ error: 'Missing data field — not a valid HAE export' }));
+      process.exit(1);
+    }
+  }
+
+  return { payload, hash };
+}
+
+export const importCommand = new Command('import')
+  .description('Import a Health Auto Export JSON or ZIP file into the database')
+  .argument('<file>', 'Path to the HAE JSON or ZIP export file')
+  .option('--target <name>', 'Target name (device/person identifier)', config.target)
+  .option('--pretty', 'Pretty-print summary JSON', false)
+  .action((file: string, opts) => {
+    const db = openDb(config.dbPath);
+    const { payload, hash } = loadFile(file);
+
+    if (hasBeenImported(db, hash)) {
+      const result = { skipped: true, reason: 'already imported', file, hash };
+      console.log(opts.pretty ? JSON.stringify(result, null, 2) : JSON.stringify(result));
+      return;
+    }
+
+    const ingestResult = ingest(db, payload, {
+      target: opts.target,
+      sessionId: null,
+      automationName: 'file-import',
+      automationPeriod: 'manual',
+    });
+
+    logImport(db, file, hash, ingestResult);
+
+    const result = {
+      ok: true,
+      file,
+      target: opts.target,
+      hash,
+      added: {
+        metrics: ingestResult.metricsAdded,
+        sleep: ingestResult.sleepAdded,
+        workouts: ingestResult.workoutsAdded,
+      },
+    };
+    console.log(opts.pretty ? JSON.stringify(result, null, 2) : JSON.stringify(result));
+  });

package/src/cli/index.ts

@@ -0,0 +1,32 @@
+import { Command } from 'commander';
+import { serveCommand } from './serve.js';
+import { metricsCommand } from './metrics.js';
+import { sleepCommand } from './sleep.js';
+import { workoutsCommand } from './workouts.js';
+import { summaryCommand } from './summary.js';
+import { queryCommand } from './query.js';
+import { sourcesCommand, lastSyncCommand, statsCommand } from './info.js';
+import { importCommand } from './import.js';
+import { watchCommand } from './watch.js';
+import { dashboardCommand } from './dashboard.js';
+import { trendsCommand } from './trends.js';
+
+export const program = new Command();
+program
+  .name('hvault')
+  .description('Apple Health data vault — ingest + query')
+  .version('0.1.0');
+
+program.addCommand(serveCommand);
+program.addCommand(importCommand);
+program.addCommand(watchCommand);
+program.addCommand(metricsCommand);
+program.addCommand(sleepCommand);
+program.addCommand(workoutsCommand);
+program.addCommand(summaryCommand);
+program.addCommand(queryCommand);
+program.addCommand(dashboardCommand);
+program.addCommand(trendsCommand);
+program.addCommand(sourcesCommand);
+program.addCommand(lastSyncCommand);
+program.addCommand(statsCommand);

package/src/cli/info.ts

@@ -0,0 +1,36 @@
+import { Command } from 'commander';
+import { openDb } from '../db/schema.js';
+
+export const sourcesCommand = new Command('sources')
+  .description('Show what metrics are in the DB and their date coverage')
+  .option('--pretty', 'Pretty-print JSON', false)
+  .action((opts) => {
+    const db = openDb();
+    const rows = db.prepare(`
+      SELECT metric, units, COUNT(*) as count, MIN(date) as first_date, MAX(date) as last_date
+      FROM metrics GROUP BY metric, units ORDER BY metric
+    `).all();
+    console.log(opts.pretty ? JSON.stringify(rows, null, 2) : JSON.stringify(rows));
+  });
+
+export const lastSyncCommand = new Command('last-sync')
+  .description('Show when the last HAE push was received')
+  .option('--pretty', 'Pretty-print JSON', false)
+  .action((opts) => {
+    const db = openDb();
+    const row = db.prepare(`SELECT * FROM sync_log ORDER BY received_at DESC LIMIT 1`).get() ?? null;
+    console.log(opts.pretty ? JSON.stringify(row, null, 2) : JSON.stringify(row));
+  });
+
+export const statsCommand = new Command('stats')
+  .description('Show row counts per table')
+  .option('--pretty', 'Pretty-print JSON', false)
+  .action((opts) => {
+    const db = openDb();
+    const metrics = (db.prepare('SELECT COUNT(*) as count FROM metrics').get() as { count: number }).count;
+    const sleep = (db.prepare('SELECT COUNT(*) as count FROM sleep').get() as { count: number }).count;
+    const workouts = (db.prepare('SELECT COUNT(*) as count FROM workouts').get() as { count: number }).count;
+    const syncs = (db.prepare('SELECT COUNT(*) as count FROM sync_log').get() as { count: number }).count;
+    const result = { metrics, sleep, workouts, syncs };
+    console.log(opts.pretty ? JSON.stringify(result, null, 2) : JSON.stringify(result));
+  });

package/src/cli/metrics.ts

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+import { openDb } from '../db/schema.js';
+
+export const metricsCommand = new Command('metrics')
+  .description('Query health metrics')
+  .requiredOption('--metric <name>', 'Metric name (e.g. step_count, heart_rate)')
+  .option('--days <n>', 'Last N days', '30')
+  .option('--pretty', 'Pretty-print JSON', false)
+  .action((opts) => {
+    const db = openDb();
+    const since = new Date();
+    since.setDate(since.getDate() - parseInt(opts.days, 10));
+    const rows = db.prepare(`
+      SELECT ts, date, qty, min, avg, max, units, source, target
+      FROM metrics
+      WHERE metric = ? AND date >= ?
+      ORDER BY ts ASC
+    `).all(opts.metric, since.toISOString().slice(0, 10));
+    console.log(opts.pretty ? JSON.stringify(rows, null, 2) : JSON.stringify(rows));
+  });

package/src/cli/query.ts

@@ -0,0 +1,17 @@
+import { Command } from 'commander';
+import { openDb } from '../db/schema.js';
+
+export const queryCommand = new Command('query')
+  .description('Run raw SQL against the health database (returns JSON)')
+  .argument('<sql>', 'SQL query to run')
+  .option('--pretty', 'Pretty-print JSON', false)
+  .action((sql: string, opts) => {
+    const db = openDb();
+    try {
+      const rows = db.prepare(sql).all();
+      console.log(opts.pretty ? JSON.stringify(rows, null, 2) : JSON.stringify(rows));
+    } catch (err) {
+      console.error(JSON.stringify({ error: String(err) }));
+      process.exit(1);
+    }
+  });

package/src/cli/serve.ts

@@ -0,0 +1,18 @@
+import { Command } from 'commander';
+import { createApp } from '../server/app.js';
+import { openDb } from '../db/schema.js';
+import { config } from '../config.js';
+
+export const serveCommand = new Command('serve')
+  .description('Start HTTP server to receive Health Auto Export pushes')
+  .option('-p, --port <number>', 'Port to listen on', String(config.port))
+  .option('--token <secret>', 'Require Authorization: Bearer <secret>', config.token)
+  .action((opts) => {
+    const db = openDb(config.dbPath);
+    const app = createApp(db, { token: opts.token });
+    const port = parseInt(opts.port, 10);
+    app.listen(port, () => {
+      console.log(`hvault server listening on http://0.0.0.0:${port}/api/ingest`);
+      if (opts.token) console.log('Auth: Bearer token required');
+    });
+  });

package/src/cli/sleep.ts

@@ -0,0 +1,19 @@
+import { Command } from 'commander';
+import { openDb } from '../db/schema.js';
+
+export const sleepCommand = new Command('sleep')
+  .description('Query sleep data')
+  .option('--days <n>', 'Last N days', '14')
+  .option('--pretty', 'Pretty-print JSON', false)
+  .action((opts) => {
+    const db = openDb();
+    const since = new Date();
+    since.setDate(since.getDate() - parseInt(opts.days, 10));
+    const rows = db.prepare(`
+      SELECT date, sleep_start, sleep_end, core_h, deep_h, rem_h, awake_h, asleep_h, in_bed_h, schema_ver, source
+      FROM sleep
+      WHERE date >= ?
+      ORDER BY date ASC
+    `).all(since.toISOString().slice(0, 10));
+    console.log(opts.pretty ? JSON.stringify(rows, null, 2) : JSON.stringify(rows));
+  });

package/src/cli/summary.ts

@@ -0,0 +1,58 @@
+import { Command } from 'commander';
+import { openDb } from '../db/schema.js';
+
+export const summaryCommand = new Command('summary')
+  .description('Summarise metrics (averages) over N days')
+  .option('--days <n>', 'Last N days', '90')
+  .option('--pretty', 'Pretty-print JSON', false)
+  .option('-c, --color', 'Pretty terminal output with emoji indicators', false)
+  .action((opts) => {
+    const db = openDb();
+    const since = new Date();
+    since.setDate(since.getDate() - parseInt(opts.days, 10));
+    const sinceStr = since.toISOString().slice(0, 10);
+
+    if (opts.color) {
+      const days = parseInt(opts.days, 10);
+
+      function avgMetric(metricName: string): number | null {
+        const row = db.prepare(
+          `SELECT AVG(qty) as avg FROM metrics WHERE metric = ? AND date >= ? AND qty IS NOT NULL`
+        ).get(metricName, sinceStr) as { avg: number | null } | undefined;
+        return row?.avg ?? null;
+      }
+
+      const steps = avgMetric('step_count');
+      const restingHR = avgMetric('resting_heart_rate');
+      const hrv = avgMetric('heart_rate_variability_sdnn');
+      const activeCal = avgMetric('active_energy_burned');
+
+      const sleepRow = db.prepare(
+        `SELECT AVG(asleep_h) as avg FROM sleep WHERE date >= ? AND asleep_h IS NOT NULL`
+      ).get(sinceStr) as { avg: number | null } | undefined;
+      const sleep = sleepRow?.avg ?? null;
+
+      const lines: string[] = [`📊 ${days}-Day Summary`, ''];
+      if (steps != null) lines.push(`👟 Avg Steps:       ${Math.round(steps).toLocaleString()}`);
+      if (restingHR != null) lines.push(`💓 Avg Resting HR:  ${Math.round(restingHR)}bpm`);
+      if (hrv != null) lines.push(`🧠 Avg HRV:         ${Math.round(hrv)}ms`);
+      if (sleep != null) lines.push(`😴 Avg Sleep:       ${sleep.toFixed(1)}h`);
+      if (activeCal != null) lines.push(`🔥 Avg Active Cal:  ${Math.round(activeCal).toLocaleString()} kcal`);
+
+      if (lines.length === 2) lines.push('   No summary data available');
+      console.log(lines.join('\n'));
+      return;
+    }
+
+    const rows = db.prepare(`
+      SELECT metric, units,
+             AVG(qty) as avg_qty, MIN(qty) as min_qty, MAX(qty) as max_qty,
+             COUNT(*) as count,
+             MIN(date) as first_date, MAX(date) as last_date
+      FROM metrics
+      WHERE date >= ? AND qty IS NOT NULL
+      GROUP BY metric, units
+      ORDER BY metric ASC
+    `).all(sinceStr);
+    console.log(opts.pretty ? JSON.stringify(rows, null, 2) : JSON.stringify(rows));
+  });