@eeymoo/hum 0.1.0

package/bin/index.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander'
+import auth from '../src/commands/auth.js'
+import config from '../src/commands/config.js'
+import record from '../src/commands/record.js'
+import timeline from '../src/commands/timeline.js'
+import weight from '../src/commands/weight.js'
+import exercise from '../src/commands/exercise.js'
+import diet from '../src/commands/diet.js'
+import sleep from '../src/commands/sleep.js'
+import { checkVersion, getCliVersion } from '../src/lib/version-check.js'
+
+const program = new Command()
+
+program
+  .name('hum')
+  .description('Health tracking CLI')
+  .version(getCliVersion())
+
+program.hook('preAction', async (thisCommand) => {
+  const commandName = thisCommand.name()
+  if (commandName !== 'auth') {
+    await checkVersion()
+  }
+})
+
+program.addCommand(auth)
+program.addCommand(config)
+program.addCommand(record)
+program.addCommand(timeline)
+program.addCommand(weight)
+program.addCommand(exercise)
+program.addCommand(diet)
+program.addCommand(sleep)
+
+program.parse()

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@eeymoo/hum",
+  "version": "0.1.0",
+  "description": "Hum CLI - A command line tool for Hum API",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Eeymoo/hum.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/Eeymoo/hum/issues"
+  },
+  "homepage": "https://github.com/Eeymoo/hum#readme",
+  "bin": {
+    "hum": "./bin/index.js"
+  },
+  "type": "module",
+  "dependencies": {
+    "commander": "^12.1.0",
+    "conf": "^13.0.1",
+    "node-fetch": "^3.3.2"
+  },
+  "scripts": {
+    "build": "node bin/index.js --version",
+    "test:e2e": "bash test/e2e.sh"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  }
+}

package/src/commands/auth.js

@@ -0,0 +1,143 @@
+import { Command } from 'commander'
+import config from '../lib/config.js'
+import { request } from '../lib/api.js'
+import { getCliVersion } from '../lib/version-check.js'
+
+const auth = new Command('auth')
+
+auth
+  .command('login')
+  .option('--api-key <key>', 'API key to authenticate with')
+  .option('--device', 'Use device code flow')
+  .action(async (options) => {
+    try {
+      if (options.device) {
+        const deviceData = await request('/auth/device', { method: 'POST' })
+        console.log('Please visit:', deviceData.verificationUriComplete)
+        console.log('Code:', deviceData.userCode)
+        console.log('Waiting for authorization...')
+        
+        const maxAttempts = 60
+        for (let i = 0; i < maxAttempts; i++) {
+          await new Promise(resolve => setTimeout(resolve, deviceData.interval * 1000))
+          try {
+            const tokenData = await request('/auth/device/token', {
+              method: 'POST',
+              body: JSON.stringify({
+                deviceCode: deviceData.deviceCode,
+                grantType: 'urn:ietf:params:oauth:grant-type:device_code'
+              })
+            })
+            
+            if (tokenData.accessToken) {
+              config.set('accessToken', tokenData.accessToken)
+              config.set('refreshToken', tokenData.refreshToken)
+              console.log('Successfully logged in!')
+              return
+            }
+          } catch {
+            continue
+          }
+        }
+        console.error('Authorization timeout')
+      } else if (options.apiKey) {
+        const result = await request('/auth/verify', {
+          method: 'POST',
+          body: JSON.stringify({ apiKey: options.apiKey })
+        })
+
+        if (result.valid) {
+          config.set('apiKey', options.apiKey)
+          const parts = []
+          if (result.user) parts.push(result.user)
+          if (result.keyName) parts.push(`key: ${result.keyName}`)
+          console.log('Successfully logged in' + (parts.length ? ` as ${parts.join(' / ')}` : '') + '!')
+        } else {
+          console.error('Invalid API key')
+        }
+      } else {
+        console.error('Please provide --api-key or --device option')
+      }
+    } catch (error) {
+      console.error('Login failed:', error.message)
+    }
+  })
+
+auth
+  .command('status')
+  .action(async () => {
+    const apiKey = config.get('apiKey')
+    const accessToken = config.get('accessToken')
+    const apiUrl = config.get('apiUrl') || 'http://localhost:3000'
+    const cliVersion = getCliVersion()
+
+    if (apiKey || accessToken) {
+      console.log('Logged in')
+      console.log('API URL:', apiUrl)
+    } else {
+      console.log('Not logged in')
+    }
+
+    try {
+      const response = await fetch(`${apiUrl}/api/v1/health`)
+      if (response.ok) {
+        const data = await response.json()
+        console.log(`CLI: v${cliVersion} | API: v${data.version}`)
+      } else {
+        console.log(`CLI: v${cliVersion} | API: unreachable`)
+      }
+    } catch {
+      console.log(`CLI: v${cliVersion} | API: unreachable`)
+    }
+  })
+
+auth
+  .command('logout')
+  .action(() => {
+    config.delete('apiKey')
+    config.delete('accessToken')
+    config.delete('refreshToken')
+    console.log('Logged out')
+  })
+
+auth
+  .command('keys')
+  .description('Manage API keys')
+  .addCommand(new Command('list')
+    .action(async () => {
+      try {
+        const result = await request('/auth/keys')
+        console.log(JSON.stringify(result, null, 2))
+      } catch (error) {
+        console.error('Failed to list keys:', error.message)
+      }
+    })
+  )
+  .addCommand(new Command('create')
+    .requiredOption('--name <name>', 'Key name')
+    .action(async (options) => {
+      try {
+        const result = await request('/auth/keys', {
+          method: 'POST',
+          body: JSON.stringify({ name: options.name })
+        })
+        console.log('API key created:', result.key)
+        console.log('Save this key, it will not be shown again.')
+      } catch (error) {
+        console.error('Failed to create key:', error.message)
+      }
+    })
+  )
+  .addCommand(new Command('revoke')
+    .requiredOption('--id <id>', 'Key ID')
+    .action(async (options) => {
+      try {
+        await request(`/auth/keys/${options.id}`, { method: 'DELETE' })
+        console.log('API key revoked')
+      } catch (error) {
+        console.error('Failed to revoke key:', error.message)
+      }
+    })
+  )
+
+export default auth

package/src/commands/config.js

@@ -0,0 +1,40 @@
+import { Command } from 'commander'
+import config from '../lib/config.js'
+
+const configCmd = new Command('config')
+
+configCmd
+  .command('set')
+  .argument('<key>', 'Config key (api-url)')
+  .argument('<value>', 'Config value')
+  .action((key, value) => {
+    const configKey = key === 'api-url' ? 'apiUrl' : key
+    config.set(configKey, value)
+    console.log(`Set ${key} to ${value}`)
+  })
+
+configCmd
+  .command('get')
+  .argument('<key>', 'Config key (api-url)')
+  .action((key) => {
+    const configKey = key === 'api-url' ? 'apiUrl' : key
+    const value = config.get(configKey)
+    if (value !== undefined) {
+      console.log(value)
+    } else {
+      console.log('Not set')
+    }
+  })
+
+configCmd
+  .command('list')
+  .action(() => {
+    const allConfig = config.store
+    console.log('Configuration:')
+    for (const [key, value] of Object.entries(allConfig)) {
+      const displayKey = key === 'apiUrl' ? 'api-url' : key
+      console.log(`  ${displayKey}: ${value}`)
+    }
+  })
+
+export default configCmd

package/src/commands/diet.js

@@ -0,0 +1,162 @@
+import { Command } from 'commander'
+import { request, createFormData } from '../lib/api.js'
+
+const diet = new Command('diet')
+
+diet
+  .command('add')
+  .requiredOption('--meal <type>', 'Meal type (breakfast/lunch/dinner/snack)')
+  .option('--calories <value>', 'Calories')
+  .option('--protein <value>', 'Protein (g)')
+  .option('--carbs <value>', 'Carbs (g)')
+  .option('--fat <value>', 'Fat (g)')
+  .option('--fiber <value>', 'Fiber (g)')
+  .option('--sodium <value>', 'Sodium (mg)')
+  .option('--foods <string>', 'Foods in format: "name:amount,name2:amount2"')
+  .option('--water <value>', 'Water (ml)')
+  .option('--note <note>', 'Note')
+  .option('--date <date>', 'Date (YYYY-MM-DD)')
+  .option('--file <paths...>', 'File paths to attach')
+  .action(async (options) => {
+    try {
+      const formData = createFormData({
+        mealType: options.meal,
+        calories: options.calories,
+        protein: options.protein,
+        carbs: options.carbs,
+        fat: options.fat,
+        fiber: options.fiber,
+        sodium: options.sodium,
+        foods: options.foods,
+        water: options.water,
+        note: options.note,
+        date: options.date
+      }, options.file || [])
+
+      const result = await request('/diets', {
+        method: 'POST',
+        body: formData,
+        isFormData: true
+      })
+
+      console.log('Diet record added:', result.id)
+    } catch (error) {
+      console.error('Failed to add diet record:', error.message)
+    }
+  })
+
+diet
+  .command('list')
+  .option('--meal <type>', 'Filter by meal type')
+  .option('--last <period>', 'Last N days/weeks/months/years')
+  .option('--start <date>', 'Start date (YYYY-MM-DD)')
+  .option('--end <date>', 'End date (YYYY-MM-DD)')
+  .option('--include-deleted', 'Include deleted records')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      Object.entries(options).forEach(([key, value]) => {
+        if (value) {
+          const paramKey = key === 'meal' ? 'mealType' : key === 'includeDeleted' ? 'includeDeleted' : key
+          params.append(paramKey, value === true ? 'true' : value)
+        }
+      })
+
+      const result = await request(`/diets?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to list diet records:', error.message)
+    }
+  })
+
+diet
+  .command('stats')
+  .option('--last <period>', 'Last N days/weeks/months/years')
+  .option('--start <date>', 'Start date (YYYY-MM-DD)')
+  .option('--end <date>', 'End date (YYYY-MM-DD)')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      Object.entries(options).forEach(([key, value]) => {
+        if (value) {
+          params.append(key, value)
+        }
+      })
+
+      const result = await request(`/diets/stats?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to get diet stats:', error.message)
+    }
+  })
+
+diet
+  .command('get')
+  .requiredOption('--id <id>', 'Diet record ID')
+  .action(async (options) => {
+    try {
+      const result = await request(`/diets/${options.id}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to get diet record:', error.message)
+    }
+  })
+
+diet
+  .command('update')
+  .requiredOption('--id <id>', 'Diet record ID')
+  .option('--meal <type>', 'Updated meal type')
+  .option('--calories <value>', 'Updated calories')
+  .option('--protein <value>', 'Updated protein')
+  .option('--carbs <value>', 'Updated carbs')
+  .option('--fat <value>', 'Updated fat')
+  .option('--fiber <value>', 'Updated fiber')
+  .option('--sodium <value>', 'Updated sodium')
+  .option('--foods <string>', 'Updated foods')
+  .option('--water <value>', 'Updated water')
+  .option('--note <note>', 'Updated note')
+  .option('--date <date>', 'Updated date (YYYY-MM-DD)')
+  .option('--file <paths...>', 'File paths to attach')
+  .option('--replace-attachments', 'Replace existing attachments instead of adding')
+  .action(async (options) => {
+    try {
+      const formData = createFormData({
+        mealType: options.meal,
+        calories: options.calories,
+        protein: options.protein,
+        carbs: options.carbs,
+        fat: options.fat,
+        fiber: options.fiber,
+        sodium: options.sodium,
+        foods: options.foods,
+        water: options.water,
+        note: options.note,
+        date: options.date,
+        replaceAttachments: options.replaceAttachments ? 'true' : undefined
+      }, options.file || [])
+
+      const result = await request(`/diets/${options.id}`, {
+        method: 'PATCH',
+        body: formData,
+        isFormData: true
+      })
+
+      console.log('Diet record updated:', result.id)
+    } catch (error) {
+      console.error('Failed to update diet record:', error.message)
+    }
+  })
+
+diet
+  .command('delete')
+  .requiredOption('--id <id>', 'Diet record ID')
+  .action(async (options) => {
+    try {
+      await request(`/diets/${options.id}`, { method: 'DELETE' })
+      console.log('Diet record deleted')
+    } catch (error) {
+      console.error('Failed to delete diet record:', error.message)
+    }
+  })
+
+export default diet

package/src/commands/exercise.js

@@ -0,0 +1,158 @@
+import { Command } from 'commander'
+import { request, createFormData } from '../lib/api.js'
+
+const exercise = new Command('exercise')
+
+exercise
+  .command('add')
+  .requiredOption('--type <type>', 'Exercise type (running/strength/cycling/swimming/other)')
+  .requiredOption('--duration <value>', 'Duration in minutes')
+  .option('--calories <value>', 'Calories burned')
+  .option('--activities <string>', 'Activities in format: "name:prop1=val1,prop2=val2;name2:prop1=val1"')
+  .option('--heart-rate-avg <value>', 'Average heart rate')
+  .option('--heart-rate-max <value>', 'Max heart rate')
+  .option('--feeling <value>', 'Feeling 1-10')
+  .option('--location <location>', 'Location')
+  .option('--note <note>', 'Note')
+  .option('--date <date>', 'Date (YYYY-MM-DD)')
+  .option('--file <paths...>', 'File paths to attach')
+  .action(async (options) => {
+    try {
+      const formData = createFormData({
+        type: options.type,
+        duration: options.duration,
+        caloriesBurned: options.calories,
+        activities: options.activities,
+        heartRateAvg: options.heartRateAvg,
+        heartRateMax: options.heartRateMax,
+        feeling: options.feeling,
+        location: options.location,
+        note: options.note,
+        date: options.date
+      }, options.file || [])
+
+      const result = await request('/exercises', {
+        method: 'POST',
+        body: formData,
+        isFormData: true
+      })
+
+      console.log('Exercise record added:', result.id)
+    } catch (error) {
+      console.error('Failed to add exercise record:', error.message)
+    }
+  })
+
+exercise
+  .command('list')
+  .option('--type <type>', 'Filter by type')
+  .option('--last <period>', 'Last N days/weeks/months/years')
+  .option('--start <date>', 'Start date (YYYY-MM-DD)')
+  .option('--end <date>', 'End date (YYYY-MM-DD)')
+  .option('--include-deleted', 'Include deleted records')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      Object.entries(options).forEach(([key, value]) => {
+        if (value) {
+          const paramKey = key === 'includeDeleted' ? 'includeDeleted' : key
+          params.append(paramKey, value === true ? 'true' : value)
+        }
+      })
+
+      const result = await request(`/exercises?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to list exercise records:', error.message)
+    }
+  })
+
+exercise
+  .command('stats')
+  .option('--last <period>', 'Last N days/weeks/months/years')
+  .option('--start <date>', 'Start date (YYYY-MM-DD)')
+  .option('--end <date>', 'End date (YYYY-MM-DD)')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      Object.entries(options).forEach(([key, value]) => {
+        if (value) {
+          params.append(key, value)
+        }
+      })
+
+      const result = await request(`/exercises/stats?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to get exercise stats:', error.message)
+    }
+  })
+
+exercise
+  .command('get')
+  .requiredOption('--id <id>', 'Exercise record ID')
+  .action(async (options) => {
+    try {
+      const result = await request(`/exercises/${options.id}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to get exercise record:', error.message)
+    }
+  })
+
+exercise
+  .command('update')
+  .requiredOption('--id <id>', 'Exercise record ID')
+  .option('--type <type>', 'Updated type')
+  .option('--duration <value>', 'Updated duration')
+  .option('--calories <value>', 'Updated calories burned')
+  .option('--activities <string>', 'Updated activities')
+  .option('--heart-rate-avg <value>', 'Updated average heart rate')
+  .option('--heart-rate-max <value>', 'Updated max heart rate')
+  .option('--feeling <value>', 'Updated feeling')
+  .option('--location <location>', 'Updated location')
+  .option('--note <note>', 'Updated note')
+  .option('--date <date>', 'Updated date (YYYY-MM-DD)')
+  .option('--file <paths...>', 'File paths to attach')
+  .option('--replace-attachments', 'Replace existing attachments instead of adding')
+  .action(async (options) => {
+    try {
+      const formData = createFormData({
+        type: options.type,
+        duration: options.duration,
+        caloriesBurned: options.calories,
+        activities: options.activities,
+        heartRateAvg: options.heartRateAvg,
+        heartRateMax: options.heartRateMax,
+        feeling: options.feeling,
+        location: options.location,
+        note: options.note,
+        date: options.date,
+        replaceAttachments: options.replaceAttachments ? 'true' : undefined
+      }, options.file || [])
+
+      const result = await request(`/exercises/${options.id}`, {
+        method: 'PATCH',
+        body: formData,
+        isFormData: true
+      })
+
+      console.log('Exercise record updated:', result.id)
+    } catch (error) {
+      console.error('Failed to update exercise record:', error.message)
+    }
+  })
+
+exercise
+  .command('delete')
+  .requiredOption('--id <id>', 'Exercise record ID')
+  .action(async (options) => {
+    try {
+      await request(`/exercises/${options.id}`, { method: 'DELETE' })
+      console.log('Exercise record deleted')
+    } catch (error) {
+      console.error('Failed to delete exercise record:', error.message)
+    }
+  })
+
+export default exercise

package/src/commands/record.js

@@ -0,0 +1,144 @@
+import { Command } from 'commander'
+import { request } from '../lib/api.js'
+
+const record = new Command('record')
+
+record
+  .command('add')
+  .requiredOption('--type <type>', 'Record type (custom|medical|supplement|symptom|other)')
+  .requiredOption('--data <json>', 'JSON data for the record')
+  .option('--tags <tags>', 'Comma-separated tags')
+  .option('--note <note>', 'Note for the record')
+  .option('--attachments <urls>', 'Comma-separated attachment URLs')
+  .option('--date <date>', 'Date for the record (YYYY-MM-DD)')
+  .action(async (options) => {
+    try {
+      const recordData = {
+        type: options.type,
+        data: JSON.parse(options.data),
+        tags: options.tags ? options.tags.split(',') : undefined,
+        note: options.note,
+        attachments: options.attachments ? options.attachments.split(',') : undefined,
+        date: options.date
+      }
+
+      const result = await request('/records', {
+        method: 'POST',
+        body: JSON.stringify(recordData)
+      })
+
+      console.log('Record added:', result.id)
+    } catch (error) {
+      console.error('Failed to add record:', error.message)
+    }
+  })
+
+record
+  .command('list')
+  .option('--type <type>', 'Filter by type')
+  .option('--tag <tag>', 'Filter by tag')
+  .option('--last <period>', 'Last N days/weeks/months/years (e.g., 10, 7d, 2w, 6m, 1y)')
+  .option('--start <date>', 'Start date (YYYY-MM-DD)')
+  .option('--end <date>', 'End date (YYYY-MM-DD)')
+  .option('--date <date>', 'Specific date (YYYY-MM-DD)')
+  .option('--include-deleted', 'Include deleted records')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      Object.entries(options).forEach(([key, value]) => {
+        if (value) {
+          const paramKey = key === 'includeDeleted' ? 'includeDeleted' : key
+          params.append(paramKey, value === true ? 'true' : value)
+        }
+      })
+
+      const result = await request(`/records?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to list records:', error.message)
+    }
+  })
+
+record
+  .command('get')
+  .requiredOption('--id <id>', 'Record ID')
+  .option('--include-deleted', 'Include deleted records')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      if (options.includeDeleted) {
+        params.append('includeDeleted', 'true')
+      }
+      const queryString = params.toString()
+      const result = await request(`/records/${options.id}${queryString ? '?' + queryString : ''}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to get record:', error.message)
+    }
+  })
+
+record
+  .command('update')
+  .requiredOption('--id <id>', 'Record ID')
+  .option('--data <json>', 'Updated JSON data')
+  .option('--tags <tags>', 'Updated comma-separated tags')
+  .option('--note <note>', 'Updated note')
+  .option('--attachments <urls>', 'Updated comma-separated attachment URLs')
+  .option('--date <date>', 'Updated date (YYYY-MM-DD)')
+  .action(async (options) => {
+    try {
+      const updateData = {}
+      if (options.data) updateData.data = JSON.parse(options.data)
+      if (options.tags) updateData.tags = options.tags.split(',')
+      if (options.note) updateData.note = options.note
+      if (options.attachments) updateData.attachments = options.attachments.split(',')
+      if (options.date) updateData.date = options.date
+
+      const result = await request(`/records/${options.id}`, {
+        method: 'PATCH',
+        body: JSON.stringify(updateData)
+      })
+
+      console.log('Record updated:', result.id)
+    } catch (error) {
+      console.error('Failed to update record:', error.message)
+    }
+  })
+
+record
+  .command('delete')
+  .requiredOption('--id <id>', 'Record ID')
+  .action(async (options) => {
+    try {
+      await request(`/records/${options.id}`, {
+        method: 'DELETE'
+      })
+
+      console.log('Record deleted')
+    } catch (error) {
+      console.error('Failed to delete record:', error.message)
+    }
+  })
+
+record
+  .command('search')
+  .requiredOption('--query <text>', 'Search query')
+  .option('--type <type>', 'Filter by type')
+  .option('--last <period>', 'Last N days/weeks/months/years')
+  .option('--include-deleted', 'Include deleted records')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      params.append('q', options.query)
+      if (options.type) params.append('type', options.type)
+      if (options.last) params.append('last', options.last)
+      if (options.includeDeleted) params.append('includeDeleted', 'true')
+
+      const result = await request(`/records/search?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to search records:', error.message)
+    }
+  })
+
+export default record

package/src/commands/sleep.js

@@ -0,0 +1,157 @@
+import { Command } from 'commander'
+import { request, createFormData } from '../lib/api.js'
+
+const sleep = new Command('sleep')
+
+sleep
+  .command('add')
+  .requiredOption('--duration <value>', 'Sleep duration in hours')
+  .requiredOption('--bedtime <time>', 'Bedtime (HH:mm)')
+  .requiredOption('--waketime <time>', 'Wake time (HH:mm)')
+  .requiredOption('--quality <value>', 'Sleep quality 1-10')
+  .option('--deep-sleep <value>', 'Deep sleep duration in hours')
+  .option('--rem-sleep <value>', 'REM sleep duration in hours')
+  .option('--awakenings <value>', 'Number of awakenings')
+  .option('--feeling <value>', 'Feeling 1-10')
+  .option('--note <note>', 'Note')
+  .option('--date <date>', 'Date (YYYY-MM-DD)')
+  .option('--file <paths...>', 'File paths to attach')
+  .action(async (options) => {
+    try {
+      const formData = createFormData({
+        duration: options.duration,
+        bedTime: options.bedtime,
+        wakeTime: options.waketime,
+        quality: options.quality,
+        deepSleep: options.deepSleep,
+        remSleep: options.remSleep,
+        awakenings: options.awakenings,
+        feeling: options.feeling,
+        note: options.note,
+        date: options.date
+      }, options.file || [])
+
+      const result = await request('/sleeps', {
+        method: 'POST',
+        body: formData,
+        isFormData: true
+      })
+
+      console.log('Sleep record added:', result.id)
+    } catch (error) {
+      console.error('Failed to add sleep record:', error.message)
+    }
+  })
+
+sleep
+  .command('list')
+  .option('--last <period>', 'Last N days/weeks/months/years')
+  .option('--start <date>', 'Start date (YYYY-MM-DD)')
+  .option('--end <date>', 'End date (YYYY-MM-DD)')
+  .option('--include-deleted', 'Include deleted records')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      Object.entries(options).forEach(([key, value]) => {
+        if (value) {
+          const paramKey = key === 'includeDeleted' ? 'includeDeleted' : key
+          params.append(paramKey, value === true ? 'true' : value)
+        }
+      })
+
+      const result = await request(`/sleeps?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to list sleep records:', error.message)
+    }
+  })
+
+sleep
+  .command('stats')
+  .option('--last <period>', 'Last N days/weeks/months/years')
+  .option('--start <date>', 'Start date (YYYY-MM-DD)')
+  .option('--end <date>', 'End date (YYYY-MM-DD)')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      Object.entries(options).forEach(([key, value]) => {
+        if (value) {
+          params.append(key, value)
+        }
+      })
+
+      const result = await request(`/sleeps/stats?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to get sleep stats:', error.message)
+    }
+  })
+
+sleep
+  .command('get')
+  .requiredOption('--id <id>', 'Sleep record ID')
+  .action(async (options) => {
+    try {
+      const result = await request(`/sleeps/${options.id}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to get sleep record:', error.message)
+    }
+  })
+
+sleep
+  .command('update')
+  .requiredOption('--id <id>', 'Sleep record ID')
+  .option('--duration <value>', 'Updated duration')
+  .option('--bedtime <time>', 'Updated bedtime')
+  .option('--waketime <time>', 'Updated wake time')
+  .option('--quality <value>', 'Updated quality')
+  .option('--deep-sleep <value>', 'Updated deep sleep')
+  .option('--rem-sleep <value>', 'Updated REM sleep')
+  .option('--awakenings <value>', 'Updated number of awakenings')
+  .option('--feeling <value>', 'Updated feeling')
+  .option('--note <note>', 'Updated note')
+  .option('--date <date>', 'Updated date (YYYY-MM-DD)')
+  .option('--file <paths...>', 'File paths to attach')
+  .option('--replace-attachments', 'Replace existing attachments instead of adding')
+  .action(async (options) => {
+    try {
+      const formData = createFormData({
+        duration: options.duration,
+        bedTime: options.bedtime,
+        wakeTime: options.waketime,
+        quality: options.quality,
+        deepSleep: options.deepSleep,
+        remSleep: options.remSleep,
+        awakenings: options.awakenings,
+        feeling: options.feeling,
+        note: options.note,
+        date: options.date,
+        replaceAttachments: options.replaceAttachments ? 'true' : undefined
+      }, options.file || [])
+
+      const result = await request(`/sleeps/${options.id}`, {
+        method: 'PATCH',
+        body: formData,
+        isFormData: true
+      })
+
+      console.log('Sleep record updated:', result.id)
+    } catch (error) {
+      console.error('Failed to update sleep record:', error.message)
+    }
+  })
+
+sleep
+  .command('delete')
+  .requiredOption('--id <id>', 'Sleep record ID')
+  .action(async (options) => {
+    try {
+      await request(`/sleeps/${options.id}`, { method: 'DELETE' })
+      console.log('Sleep record deleted')
+    } catch (error) {
+      console.error('Failed to delete sleep record:', error.message)
+    }
+  })
+
+export default sleep

package/src/commands/timeline.js

@@ -0,0 +1,28 @@
+import { Command } from 'commander'
+import { request } from '../lib/api.js'
+
+const timeline = new Command('timeline')
+
+timeline
+  .option('--last <period>', 'Last N days/weeks/months/years (e.g., 7d, 2w, 1m)')
+  .option('--start <date>', 'Start date (YYYY-MM-DD)')
+  .option('--end <date>', 'End date (YYYY-MM-DD)')
+  .option('--include-deleted', 'Include deleted records')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      Object.entries(options).forEach(([key, value]) => {
+        if (value) {
+          const paramKey = key === 'includeDeleted' ? 'includeDeleted' : key
+          params.append(paramKey, value === true ? 'true' : value)
+        }
+      })
+
+      const result = await request(`/timeline?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to get timeline:', error.message)
+    }
+  })
+
+export default timeline

package/src/commands/weight.js

@@ -0,0 +1,153 @@
+import { Command } from 'commander'
+import { request, createFormData } from '../lib/api.js'
+
+const weight = new Command('weight')
+
+weight
+  .command('add')
+  .requiredOption('--value <value>', 'Weight value (kg)')
+  .option('--body-fat <value>', 'Body fat percentage')
+  .option('--muscle-mass <value>', 'Muscle mass (kg)')
+  .option('--bmi <value>', 'BMI')
+  .option('--water <value>', 'Water percentage')
+  .option('--bone-mass <value>', 'Bone mass (kg)')
+  .option('--visceral-fat <value>', 'Visceral fat level')
+  .option('--note <note>', 'Note for the record')
+  .option('--date <date>', 'Date for the record (YYYY-MM-DD)')
+  .option('--file <paths...>', 'File paths to attach')
+  .action(async (options) => {
+    try {
+      const formData = createFormData({
+        weight: options.value,
+        bodyFat: options.bodyFat,
+        muscleMass: options.muscleMass,
+        bmi: options.bmi,
+        water: options.water,
+        boneMass: options.boneMass,
+        visceralFat: options.visceralFat,
+        note: options.note,
+        date: options.date
+      }, options.file || [])
+
+      const result = await request('/weights', {
+        method: 'POST',
+        body: formData,
+        isFormData: true
+      })
+
+      console.log('Weight record added:', result.id)
+    } catch (error) {
+      console.error('Failed to add weight record:', error.message)
+    }
+  })
+
+weight
+  .command('list')
+  .option('--last <period>', 'Last N days/weeks/months/years (e.g., 10, 7d, 2w, 6m, 1y)')
+  .option('--start <date>', 'Start date (YYYY-MM-DD)')
+  .option('--end <date>', 'End date (YYYY-MM-DD)')
+  .option('--include-deleted', 'Include deleted records')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      Object.entries(options).forEach(([key, value]) => {
+        if (value) {
+          const paramKey = key === 'includeDeleted' ? 'includeDeleted' : key
+          params.append(paramKey, value === true ? 'true' : value)
+        }
+      })
+
+      const result = await request(`/weights?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to list weight records:', error.message)
+    }
+  })
+
+weight
+  .command('stats')
+  .option('--last <period>', 'Last N days/weeks/months/years (e.g., 10, 7d, 2w, 6m, 1y)')
+  .option('--start <date>', 'Start date (YYYY-MM-DD)')
+  .option('--end <date>', 'End date (YYYY-MM-DD)')
+  .action(async (options) => {
+    try {
+      const params = new URLSearchParams()
+      Object.entries(options).forEach(([key, value]) => {
+        if (value) {
+          params.append(key, value)
+        }
+      })
+
+      const result = await request(`/weights/stats?${params.toString()}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to get weight stats:', error.message)
+    }
+  })
+
+weight
+  .command('get')
+  .requiredOption('--id <id>', 'Weight record ID')
+  .action(async (options) => {
+    try {
+      const result = await request(`/weights/${options.id}`)
+      console.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      console.error('Failed to get weight record:', error.message)
+    }
+  })
+
+weight
+  .command('update')
+  .requiredOption('--id <id>', 'Weight record ID')
+  .option('--value <value>', 'Updated weight value (kg)')
+  .option('--body-fat <value>', 'Updated body fat percentage')
+  .option('--muscle-mass <value>', 'Updated muscle mass (kg)')
+  .option('--bmi <value>', 'Updated BMI')
+  .option('--water <value>', 'Updated water percentage')
+  .option('--bone-mass <value>', 'Updated bone mass (kg)')
+  .option('--visceral-fat <value>', 'Updated visceral fat level')
+  .option('--note <note>', 'Updated note')
+  .option('--date <date>', 'Updated date (YYYY-MM-DD)')
+  .option('--file <paths...>', 'File paths to attach')
+  .option('--replace-attachments', 'Replace existing attachments instead of adding')
+  .action(async (options) => {
+    try {
+      const formData = createFormData({
+        weight: options.value,
+        bodyFat: options.bodyFat,
+        muscleMass: options.muscleMass,
+        bmi: options.bmi,
+        water: options.water,
+        boneMass: options.boneMass,
+        visceralFat: options.visceralFat,
+        note: options.note,
+        date: options.date,
+        replaceAttachments: options.replaceAttachments ? 'true' : undefined
+      }, options.file || [])
+
+      const result = await request(`/weights/${options.id}`, {
+        method: 'PATCH',
+        body: formData,
+        isFormData: true
+      })
+
+      console.log('Weight record updated:', result.id)
+    } catch (error) {
+      console.error('Failed to update weight record:', error.message)
+    }
+  })
+
+weight
+  .command('delete')
+  .requiredOption('--id <id>', 'Weight record ID')
+  .action(async (options) => {
+    try {
+      await request(`/weights/${options.id}`, { method: 'DELETE' })
+      console.log('Weight record deleted')
+    } catch (error) {
+      console.error('Failed to delete weight record:', error.message)
+    }
+  })
+
+export default weight

package/src/lib/api.js

@@ -0,0 +1,53 @@
+import fetch from 'node-fetch'
+import { FormData, File } from 'node-fetch'
+import { readFileSync } from 'fs'
+import config from './config.js'
+
+export async function request(endpoint, options = {}) {
+  const apiUrl = config.get('apiUrl') || 'http://localhost:3000'
+  const apiKey = config.get('apiKey')
+
+  const url = `${apiUrl}/api/v1${endpoint}`
+  const headers = {
+    ...options.headers
+  }
+
+  if (!options.isFormData) {
+    headers['Content-Type'] = 'application/json'
+  }
+
+  if (apiKey) {
+    headers['Authorization'] = `Bearer ${apiKey}`
+  }
+
+  const response = await fetch(url, {
+    ...options,
+    headers
+  })
+
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({}))
+    throw new Error(error.message || `HTTP error! status: ${response.status}`)
+  }
+
+  return response.json()
+}
+
+export function createFormData(fields, files = []) {
+  const formData = new FormData()
+
+  Object.entries(fields).forEach(([key, value]) => {
+    if (value !== undefined && value !== null) {
+      formData.append(key, value.toString())
+    }
+  })
+
+  files.forEach(filePath => {
+    const buffer = readFileSync(filePath)
+    const fileName = filePath.split('/').pop()
+    const file = new File([buffer], fileName)
+    formData.append('file', file)
+  })
+
+  return formData
+}

package/src/lib/config.js

@@ -0,0 +1,5 @@
+import Conf from 'conf'
+
+const config = new Conf({ projectName: 'hum' })
+
+export default config

package/src/lib/version-check.js

@@ -0,0 +1,73 @@
+import { readFileSync } from 'fs'
+import { resolve, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import config from './config.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+export const EXIT_VERSION_MISMATCH = 3
+
+export function getCliVersion() {
+  try {
+    const packageJson = JSON.parse(
+      readFileSync(resolve(__dirname, '../../package.json'), 'utf-8')
+    )
+    return packageJson.version
+  } catch {
+    return '0.0.0'
+  }
+}
+
+export function parseVersion(version) {
+  const parts = version.split('.').map(Number)
+  return {
+    major: parts[0] || 0,
+    minor: parts[1] || 0,
+    patch: parts[2] || 0
+  }
+}
+
+export async function checkVersion() {
+  const cliVersion = getCliVersion()
+  const apiUrl = config.get('apiUrl') || 'http://localhost:3000'
+
+  try {
+    const response = await fetch(`${apiUrl}/api/v1/health`)
+    
+    if (!response.ok) {
+      console.error('[提示] 无法连接到 API，跳过版本检查。')
+      return true
+    }
+
+    const data = await response.json()
+    const apiVersion = data.version
+
+    if (!apiVersion) {
+      console.error('[提示] API 未返回版本信息，跳过版本检查。')
+      return true
+    }
+
+    const cli = parseVersion(cliVersion)
+    const api = parseVersion(apiVersion)
+
+    if (cli.major !== api.major) {
+      console.error(`[错误] CLI (v${cliVersion}) 与 API (v${apiVersion}) 主版本不兼容。`)
+      console.error('请执行以下命令升级：')
+      console.error('  npm install -g hum-cli@latest')
+      console.error('或访问：')
+      process.exit(EXIT_VERSION_MISMATCH)
+    }
+
+    if (cli.minor !== api.minor) {
+      console.warn(`[警告] CLI (v${cliVersion}) 与 API (v${apiVersion}) 次版本不一致。`)
+      console.warn('建议升级以获得完整功能：npm install -g hum-cli@latest')
+      return true
+    }
+
+    return true
+  } catch (error) {
+    console.error('[提示] 无法连接到 API，跳过版本检查。')
+    return true
+  }
+}

package/test/e2e.sh

@@ -0,0 +1,62 @@
+#!/bin/bash
+set -e
+
+CLI="node $(dirname "$0")/../bin/index.js"
+API_URL="http://localhost:3001"
+API_KEY="abc123"
+
+echo "=== Hum CLI E2E Test ==="
+echo ""
+
+# 1. Config
+echo "1. Testing config set..."
+$CLI config set apiUrl $API_URL
+echo "   ✓ apiUrl set"
+
+# 2. Auth
+echo "2. Testing auth login..."
+$CLI auth login --api-key $API_KEY
+echo "   ✓ logged in"
+
+echo "3. Testing auth status..."
+$CLI auth status
+echo "   ✓ status ok"
+
+# 3. Record CRUD
+echo "4. Testing record add..."
+RESULT=$($CLI record add --type custom --data '{"test":true}' --tags e2e --note "auto test" 2>&1)
+echo "   $RESULT"
+RECORD_ID=$(echo "$RESULT" | grep -o '[0-9a-f]\{8\}-[0-9a-f]\{4\}-[0-9a-f]\{4\}-[0-9a-f]\{4\}-[0-9a-f]\{12\}')
+if [ -z "$RECORD_ID" ]; then
+  echo "   ✗ failed to get record id"
+  exit 1
+fi
+echo "   ✓ record added: $RECORD_ID"
+
+echo "5. Testing record get..."
+$CLI record get --id $RECORD_ID > /dev/null
+echo "   ✓ record get ok"
+
+echo "6. Testing record list..."
+$CLI record list --tag e2e > /dev/null
+echo "   ✓ record list ok"
+
+echo "7. Testing record update..."
+$CLI record update --id $RECORD_ID --data '{"test":false}' > /dev/null
+echo "   ✓ record update ok"
+
+echo "8. Testing record search..."
+$CLI record search --query "auto test" > /dev/null
+echo "   ✓ record search ok"
+
+echo "9. Testing record delete..."
+$CLI record delete --id $RECORD_ID > /dev/null
+echo "   ✓ record delete ok"
+
+# 4. Timeline
+echo "10. Testing timeline..."
+$CLI timeline --last 7d > /dev/null
+echo "   ✓ timeline ok"
+
+echo ""
+echo "=== All tests passed! ==="