hae-vault 0.1.0 → 0.2.1

package/README.md

@@ -21,6 +21,9 @@ hvault summary --color                # N-day averages with emoji indicators
 
 1. Install the [Health Auto Export](https://www.healthexportapp.com) iOS app
 2. In HAE: Settings → REST API → set server URL to `http://your-server:4242/api/ingest`
+   - Endpoint: `POST /api/ingest` (JSON body, max 50mb)
+   - Health check: `GET /health` → `{"status":"ok"}`
+   - Optional: append `?target=me` to tag data by device/person
 3. Or: export a ZIP from HAE and run `hvault import export.zip`
 
 **Optional:** create `.env` in your working directory to override defaults:
@@ -29,7 +32,9 @@ hvault summary --color                # N-day averages with emoji indicators
 HVAULT_DB_PATH=~/.hae-vault/health.db   # SQLite DB location
 HVAULT_PORT=4242                         # ingest server port
 HVAULT_TOKEN=secret                      # bearer token for serve (optional)
+HVAULT_AUTH=secret                       # alias for HVAULT_TOKEN (use if _TOKEN is blocked)
 HVAULT_WATCH_DIR=~/Downloads             # directory to watch for exports
+HVAULT_WATCH_INTERVAL=60                 # watch poll interval in seconds (default: 60)
 ```
 
 ## Commands
@@ -38,10 +43,15 @@ HVAULT_WATCH_DIR=~/Downloads             # directory to watch for exports
 
 | Command | Description |
 | --- | --- |
-| `hvault serve` | Start HTTP server, receive HAE REST API pushes |
+| `hvault start` | Start server + watcher based on env vars (recommended for Docker/daemons) |
+| `hvault serve` | Start HTTP server only |
 | `hvault import <file>` | Import HAE JSON or ZIP export (idempotent) |
 | `hvault watch` | Watch directory and auto-import new HAE exports |
 
+> **`watch` file matching:** only files matching `/^HealthAutoExport.*\.(zip|json)$/i` are picked up.
+> The Health Auto Export app names files this way by default (e.g. `HealthAutoExport-2020-2025.zip`).
+> Files with any other name are silently ignored.
+
 ### Query
 
 Output is JSON by default. Add `--pretty` for formatted JSON.
@@ -168,6 +178,7 @@ Load order: CLI flag > env var > `.env` file > default.
 HVAULT_DB_PATH=~/.hae-vault/health.db   # SQLite DB location
 HVAULT_PORT=4242                         # serve port
 HVAULT_TOKEN=secret                      # bearer token for serve
+HVAULT_AUTH=secret                       # alias for HVAULT_TOKEN (use if _TOKEN is blocked by your env)
 HVAULT_WATCH_DIR=~/Downloads             # directory to watch
 HVAULT_WATCH_INTERVAL=60                 # watch poll interval (seconds)
 HVAULT_TARGET=default                    # default target name

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,eAAO,MAAM,OAAO,SAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,eAAO,MAAM,OAAO,SAAgB,CAAC"}

package/dist/cli/index.js

@@ -10,11 +10,13 @@ import { importCommand } from './import.js';
 import { watchCommand } from './watch.js';
 import { dashboardCommand } from './dashboard.js';
 import { trendsCommand } from './trends.js';
+import { startCommand } from './start.js';
 export const program = new Command();
 program
     .name('hvault')
     .description('Apple Health data vault — ingest + query')
-    .version('0.1.0');
+    .version('0.2.0');
+program.addCommand(startCommand);
 program.addCommand(serveCommand);
 program.addCommand(importCommand);
 program.addCommand(watchCommand);

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AACrC,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,0CAA0C,CAAC;KACvD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AACrC,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,0CAA0C,CAAC;KACvD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC"}

package/dist/cli/start.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const startCommand: Command;
+//# sourceMappingURL=start.d.ts.map

package/dist/cli/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,eAAO,MAAM,YAAY,SAiBrB,CAAC"}

package/dist/cli/start.js

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+import { createApp } from '../server/app.js';
+import { openDb } from '../db/schema.js';
+import { tick } from './watch.js';
+import { config } from '../config.js';
+export const startCommand = new Command('start')
+    .description('Start server and watcher based on environment variables (HVAULT_PORT, HVAULT_WATCH_DIR)')
+    .action(() => {
+    const db = openDb(config.dbPath);
+    // Always start HTTP server
+    const app = createApp(db, { token: config.token });
+    app.listen(config.port, () => {
+        console.log(JSON.stringify({ server: `http://0.0.0.0:${config.port}/api/ingest`, auth: !!config.token }));
+    });
+    // Start watcher only if HVAULT_WATCH_DIR is set
+    if (config.watchDir) {
+        console.log(JSON.stringify({ watching: config.watchDir, intervalSeconds: config.watchInterval, target: config.target }));
+        tick(db, config.watchDir, config.target);
+        setInterval(() => tick(db, config.watchDir, config.target), config.watchInterval * 1000);
+    }
+});
+//# sourceMappingURL=start.js.map

package/dist/cli/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,yFAAyF,CAAC;KACtG,MAAM,CAAC,GAAG,EAAE;IACX,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEjC,2BAA2B;IAC3B,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QAC3B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,kBAAkB,MAAM,CAAC,IAAI,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5G,CAAC,CAAC,CAAC;IAEH,gDAAgD;IAChD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACzH,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,QAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/config.js

@@ -17,7 +17,7 @@ const DEFAULT_DB_PATH = join(homedir(), '.hae-vault', 'health.db');
 export const config = {
     dbPath: expandTilde(process.env.HVAULT_DB_PATH ?? DEFAULT_DB_PATH),
     port: Number(process.env.HVAULT_PORT ?? 4242),
-    token: process.env.HVAULT_TOKEN,
+    token: process.env.HVAULT_TOKEN ?? process.env.HVAULT_AUTH,
     watchDir: process.env.HVAULT_WATCH_DIR ? expandTilde(process.env.HVAULT_WATCH_DIR) : undefined,
     watchInterval: Number(process.env.HVAULT_WATCH_INTERVAL ?? 60),
     target: process.env.HVAULT_TARGET ?? 'default',

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,SAAS,WAAW,CAAC,CAAS;IAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,qEAAqE;AACrE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;AAC3E,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAS,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,eAAe,CAAC;IACzE,IAAI,EAAW,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC;IACtD,KAAK,EAAU,OAAO,CAAC,GAAG,CAAC,YAAY;IACvC,QAAQ,EAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS;IACnG,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;IAC9D,MAAM,EAAS,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS;CAC7C,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,SAAS,WAAW,CAAC,CAAS;IAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,qEAAqE;AACrE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;AAC3E,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAS,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,eAAe,CAAC;IACzE,IAAI,EAAW,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC;IACtD,KAAK,EAAU,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW;IAClE,QAAQ,EAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS;IACnG,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;IAC9D,MAAM,EAAS,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,SAAS;CAC7C,CAAC"}

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "hae-vault",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "CLI + HTTP server for Apple Health data from Health Auto Export",
   "type": "module",
   "bin": {
     "hvault": "./dist/index.js"
   },
   "main": "./dist/index.js",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsc",

package/.env.example

@@ -1,7 +0,0 @@
-HVAULT_DB_PATH=~/.hae-vault/health.db
-HVAULT_PORT=4242
-HVAULT_TOKEN=
-HVAULT_WATCH_DIR=~/Downloads
-HVAULT_WATCH_INTERVAL=60
-HVAULT_TARGET=default
-HVAULT_ENV_FILE=

package/CLAUDE.md

@@ -1,220 +0,0 @@
-# hae-vault — Claude Code Guide
-
-## Project Identity
-
-- **npm package name:** `hae-vault`
-- **CLI command:** `hvault`
-- **Install:** `npm install -g hae-vault`
-- **Language:** TypeScript (Node.js 22+, ESM, NodeNext)
-- **Status:** Implemented and working — 570k+ rows ingested from real Apple Health data
-
----
-
-## What This Project Does
-
-`hae-vault` is an npm package with three responsibilities:
-
-1. **Server** (`hvault serve`): HTTP server that receives health data pushed from the **Health Auto Export** iOS app. POST to `/api/ingest`, writes to local SQLite.
-
-2. **Import** (`hvault import <file>`): Bulk import from a HAE JSON or ZIP export file. Idempotent via SHA-256 hash tracking — skips already-imported files.
-
-3. **Watch** (`hvault watch`): Polls a directory for new HAE export files, auto-imports on schedule. Configurable via env vars.
-
-4. **CLI** (`hvault <command>`): Query interface for AI agents (OpenClaw). Returns JSON.
-
----
-
-## Ecosystem Context
-
-```
-OpenClaw (AI agent platform, remote server)
-├── skill: whoop-up       ← existing, WHOOP wearable, live API calls
-├── skill: hae-vault      ← Apple Health archive, queries SQLite
-│
-├── whoop-up CLI          ← npm install -g whoop-up (already published)
-└── hvault CLI            ← npm install -g hae-vault (local install)
-     └── reads ~/.hae-vault/health.db (SQLite)
-
-iPhone (Health Auto Export app)
-  └── REST API automation → POST http://server:4242/api/ingest
-        └── writes to health.db via hvault serve
-
-OR
-
-HAE Manual Export → .zip file → hvault import export.zip
-```
-
----
-
-## Source Structure
-
-```
-hae-vault/
-├── src/
-│   ├── index.ts             ← entry point, Commander CLI
-│   ├── config.ts            ← env config singleton (dotenv + HVAULT_* vars)
-│   ├── server/
-│   │   ├── app.ts           ← Express HTTP server
-│   │   └── ingest.ts        ← parse payload → write to DB, returns IngestResult
-│   ├── db/
-│   │   ├── schema.ts        ← SQLite schema + openDb() + closeDb()
-│   │   ├── metrics.ts       ← upsertMetrics()
-│   │   ├── sleep.ts         ← upsertSleep()
-│   │   ├── workouts.ts      ← upsertWorkout()
-│   │   └── importLog.ts     ← hasBeenImported() + logImport() (SHA-256 dedup)
-│   ├── parse/
-│   │   ├── time.ts          ← 5-format date parser
-│   │   ├── metrics.ts       ← MetricData[] → NormalizedMetric[]
-│   │   ├── sleep.ts         ← detect 3 variants, normalizeSleep()
-│   │   └── workouts.ts      ← WorkoutData[] → NormalizedWorkout
-│   ├── util/
-│   │   └── zip.ts           ← extractPayloadFromZip() — adm-zip, finds HealthAutoExport-*.json
-│   ├── cli/
-│   │   ├── index.ts         ← program + all command registrations
-│   │   ├── serve.ts         ← hvault serve
-│   │   ├── import.ts        ← hvault import <file> (JSON or ZIP, dedup via import_log)
-│   │   ├── watch.ts         ← hvault watch (polls dir, auto-imports, exports tick())
-│   │   ├── metrics.ts       ← hvault metrics --metric <name> --days N
-│   │   ├── sleep.ts         ← hvault sleep --days N
-│   │   ├── workouts.ts      ← hvault workouts --days N
-│   │   ├── summary.ts       ← hvault summary --days N
-│   │   ├── query.ts         ← hvault query "<sql>"
-│   │   └── info.ts          ← hvault sources | last-sync | stats
-│   └── types/
-│       └── hae.ts           ← TypeScript interfaces for HAE payload
-├── tests/
-│   ├── types.test.ts
-│   ├── parse-time.test.ts
-│   ├── parse-sleep.test.ts
-│   ├── parse-metrics.test.ts
-│   ├── parse-workouts.test.ts
-│   ├── db-schema.test.ts
-│   ├── db-metrics.test.ts
-│   ├── db-sleep.test.ts
-│   ├── db-workouts.test.ts
-│   ├── db-import-log.test.ts
-│   ├── ingest.test.ts
-│   ├── util-zip.test.ts
-│   └── cli-watch.test.ts
-├── docs/plans/              ← design + implementation plan docs
-├── CLAUDE.md
-├── SKILL.md                 ← OpenClaw skill definition
-├── package.json             ← bin: { "hvault": "dist/index.js" }
-└── tsconfig.json
-```
-
----
-
-## CLI Commands
-
-```bash
-# Server
-hvault serve                          # start HTTP ingest server (default port 4242)
-hvault serve --port 4242              # custom port
-hvault serve --token <secret>         # require Authorization: Bearer <secret>
-
-# Import from file (JSON or ZIP)
-hvault import export.json             # import HAE JSON export
-hvault import export.zip              # import HAE zip (extracts HealthAutoExport-*.json)
-hvault import export.zip --target me  # tag with device/person name
-
-# Watch directory for new exports
-hvault watch                          # uses HVAULT_WATCH_DIR env var
-hvault watch --dir ~/Downloads        # watch specific directory
-hvault watch --interval 60            # check every 60 seconds
-
-# Query (all return JSON, --pretty for formatted)
-hvault metrics --metric step_count --days 30
-hvault metrics --metric heart_rate --days 7
-hvault sleep --days 14
-hvault workouts --days 30
-hvault summary --days 90
-hvault query "<sql>"                  # raw SQL → JSON
-hvault sources                        # metric coverage in DB
-hvault last-sync                      # last REST API push received
-hvault stats                          # row counts per table
-```
-
----
-
-## Environment Variables
-
-Load order: CLI flag > env var > `.env` file > hardcoded default.
-
-In Docker: set env vars directly — no `.env` file needed.
-
-```bash
-HVAULT_ENV_FILE=/path/to/.env            # override .env file location (default: CWD/.env)
-HVAULT_DB_PATH=~/.hae-vault/health.db   # SQLite DB location (tilde expanded)
-HVAULT_PORT=4242                         # serve port
-HVAULT_TOKEN=secret                      # bearer token for serve
-HVAULT_WATCH_DIR=~/Downloads             # directory to watch for exports (tilde expanded)
-HVAULT_WATCH_INTERVAL=60                 # watch poll interval (seconds)
-HVAULT_TARGET=default                    # default target name
-```
-
----
-
-## SQLite Schema
-
-Database: `~/.hae-vault/health.db`
-
-### Tables
-- `metrics` — all health metrics (steps, HR, HRV, etc.)  `UNIQUE(ts, metric, source, target)`
-- `sleep` — nightly sleep records (3 schema variants handled)  `UNIQUE(date, source, target)`
-- `workouts` — workout sessions  `UNIQUE(ts, name, target)`
-- `sync_log` — REST API push history
-- `import_log` — file import history with SHA-256 hash for deduplication  `UNIQUE(file_hash)`
-
-### Key implementation notes
-- **WAL mode** — concurrent reads while server writes
-- **`INSERT OR REPLACE`** — idempotent upserts throughout
-- **`import_log` hash check** — skip re-importing identical files
-- **DB path** from `HVAULT_DB_PATH` env or `~/.hae-vault/health.db`
-
----
-
-## Payload Format (HAE REST API)
-
-Top-level:
-```json
-{ "data": { "metrics": [], "workouts": [], "stateOfMind": [], ... } }
-```
-
-### Date format — 5 variants (all handled by `src/parse/time.ts`)
-```
-"2026-01-15 14:30:00 +0000"          ← 24-hour
-"2026-01-15 2:30:00 PM +0000"        ← 12-hour uppercase
-"2026-01-15 2:30:00 pm +0000"        ← 12-hour lowercase
-"2026-01-15 2:30:00\u202fPM +0000"   ← narrow non-breaking space before PM
-"2026-01-15 2:30:00\u202fpm +0000"   ← narrow non-breaking space before pm
-```
-
-### Sleep — 3 schema variants (detected by `src/parse/sleep.ts`)
-- `detailed` — has `startDate`/`endDate` (non-aggregated phases)
-- `aggregated_v2` — has `core`/`deep`/`rem` + `source` (HAE >= 6.6.2)
-- `aggregated_v1` — has `sleepSource`/`inBedSource` (HAE < 6.6.2)
-
-Detection: `'startDate' in dp` → detailed | `'core' in dp` → v2 | else → v1
-
----
-
-## Development
-
-```bash
-npm install
-npm run dev -- serve             # run server without building
-npm run build                    # compile TypeScript → dist/
-npm test                         # run all tests (59 passing)
-npm install -g .                 # install globally as hvault
-```
-
----
-
-## Reference Projects
-
-Located at `/Volumes/storage/01_Projects/whoop/healthy/`:
-
-- `health-auto-export-server/` — TypeScript/MongoDB reference. Useful: `MetricName.ts`, `Metric.ts`
-- `apple-health-ingester/` — Go reference. Useful: `types.go` (canonical type defs + time parser)
-- `restapi.md` — Official HAE REST API documentation

package/SKILL.md

@@ -1,60 +0,0 @@
----
-name: hae-vault
-description: >
-  Apple Health archive database. Use for: historical Apple Health data (steps,
-  heart rate, HRV, sleep, workouts, mindfulness, respiratory rate, blood oxygen
-  from iPhone/Apple Watch), multi-day trends, long-term patterns. Data comes
-  from Health Auto Export iOS app synced to local SQLite. NOT for WHOOP data —
-  use whoop-up skill for that. NOT for live/real-time data.
-metadata:
-  openclaw:
-    emoji: "🍎"
-    requires:
-      bins:
-        - hvault
-    install:
-      - id: node
-        kind: node
-        package: hae-vault
-        bins:
-          - hvault
-        label: "Install hae-vault (node)"
----
-
-# hae-vault
-
-Query Apple Health data stored locally by `hvault serve` from the Health Auto Export iOS app.
-
-## Commands
-
-```bash
-# Query last 30 days of steps
-hvault metrics --metric step_count --days 30
-
-# Query HRV
-hvault metrics --metric heart_rate_variability --days 30
-
-# Query sleep (last 14 nights)
-hvault sleep --days 14
-
-# Query workouts (last 30 days)
-hvault workouts --days 30
-
-# Summary averages across all metrics (90 days)
-hvault summary --days 90
-
-# Raw SQL for custom queries
-hvault query "SELECT date, qty FROM metrics WHERE metric='step_count' ORDER BY date DESC LIMIT 7"
-
-# What's in the DB?
-hvault sources
-hvault last-sync
-hvault stats
-```
-
-## Available Metrics (common)
-
-step_count, heart_rate, heart_rate_variability, resting_heart_rate,
-active_energy, basal_energy_burned, respiratory_rate, blood_oxygen_saturation,
-weight_body_mass, body_fat_percentage, sleep_analysis (via hvault sleep),
-mindful_minutes, vo2max, walking_running_distance, flights_climbed