Fast Command:
- -t, --time - Specify start/end time
- Examples: "18:00", "2023-12-01 18:00", "10:30"

Meal/Drink Commands:
- -c, --calories - Override automatic calorie estimation with manual value
- -s, --size - Specify portion size for more accurate calorie estimation (supports both imperial and metric)
- Imperial examples: "32oz", "16oz", "2 cups", "6oz", "1lb", "2 slices"
- Metric examples: "500ml", "250g", "1kg", "150g", "1l"
- General: "large", "small", "medium", "1 bowl"

Exercise Command:
- -c, --calories - Override automatic calorie burn estimation with manual value
- - Duration with flexible formats (required)
- Examples: "30", "30 minutes", "45min", "1.5 hours", "2h", "90 min"

Recommend Command:
- --meal - Get meal recommendations (default)
- --drink - Get drink/beverage recommendations
- --exercise - Get exercise/workout recommendations
- -t, --type - Meal type (breakfast, lunch, dinner, snack) or drink type (smoothie, tea, coffee, etc.) or exercise type (cardio, strength, yoga, etc.)
- -c, --calories - Target calories for the meal/drink or duration in minutes for exercise
- -d, --dietary - Dietary restrictions (vegetarian, vegan, gluten-free, etc.)
- --intensity - Exercise intensity (low, moderate, high) - for exercise recommendations
- --equipment - Available equipment (e.g., "dumbbells, yoga mat") - for exercise recommendations
- --location - Exercise location (home, gym, outdoor) - for exercise recommendations
- --purpose - Drink purpose (hydration, energy, post-workout, relaxation) - for drink recommendations
- [preference] - Food/exercise/drink preference or category (optional)
- Examples: "sandwiches", "salads", "pasta", "healthy breakfast", "cardio", "smoothies"

Activity Command:
- - Activity level: sedentary, moderate, or active

Condition Command:
- add - Add a medical condition (e.g., "high blood pressure", "diabetes")
- remove - Remove a medical condition
- list - Show current user profile (activity level and medical conditions)
- clear - Remove all medical conditions

Weight Command:
- Supports multiple units with automatic conversion
- Examples: "200lbs", "90kg", "200", "12oz", "2000g"
- Uses your configured unit system as default when no unit specified

Summary Command:
- --weight-chart - Show only weight trend chart
- --fast-chart - Show only fast duration chart
- --calorie-chart - Show only daily calorie intake chart
- --exercise-chart - Show only daily exercise calories burned chart

Setup Command:
- --units - Configure unit system preference (imperial/metric)
- --weight-unit - Configure weight unit preference (lbs/kg)
- --timezone - Configure timezone preference for accurate date calculations
- --supabase - Configure Supabase cloud storage
- --local - Switch to local file storage

Clean Command:
- --config - Also delete API key configuration

File Structure

$3

1. The description (and optional size) is sent to OpenAI's API with unit system and user profile context
2. The AI estimates calories based on your activity level, medical conditions, and specified portion size
3. Size parsing handles both imperial and metric measurements automatically
4. Personalized estimates consider your health profile for appropriate portion sizing
5. You can specify portion sizes with --size for more accurate estimates
6. You can still manually override with the -c flag if needed

$3

1. Log exercise - Provide exercise description and duration in minutes
2. Personalized AI estimation - Uses your activity level, medical conditions, weight, and exercise details for accurate calorie burn calculation
3. Health-aware recommendations - Exercise suggestions consider your medical conditions for safe, appropriate workouts
4. Activity-matched intensity - Recommendations match your current activity level for progressive fitness
5. Manual override - Use -c flag to specify exact calories burned if needed
6. Daily tracking - View total calories burned per day with trend analysis

$3

1. Setup - Run fasting setup --supabase to configure cloud storage
2. Automatic sync - All data (meals, exercises, weight, fasts) stored in Supabase
3. Cross-device access - Access your data from multiple devices with the same configuration
4. Local fallback - Switch back to local storage anytime with fasting setup --local

Required Supabase Configuration:
- Supabase URL
- Service Role Key

Environment Variables (optional):
`bash
SUPABASE_URL=your_supabase_url
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
FASTING_STORAGE_MODE=supabase # or 'local'
`

$3

Imperial System:
- Drinks: "32oz", "16oz", "8oz", "2 cups", "1 pint", "1 quart"
- Meals: "6oz", "8oz", "1lb", "2 slices", "large portion", "small bowl", "1 cup"

Metric System:
- Drinks: "500ml", "250ml", "1l", "1.5l"
- Meals: "150g", "250g", "500g", "1kg", "large portion", "small bowl"

Duration Examples:
- Minutes: "30", "45", "30 minutes", "45min"
- Hours: "1.5 hours", "2h", "1 hour 30 minutes"

Weight Examples:
- Imperial: "200lbs", "12oz", "2lbs"
- Metric: "90kg", "500g", "1.5kg"

$3

The app stores all data in ~/.config/fasting/ for secure, persistent access:

- Configuration: Run fasting setup to configure or update your API key
- Data Storage: All meals, drinks, and weight data are stored locally
- Data Export: Use fasting export to create a backup zip file at ~/fasting.zip
- Data Restore: Extract the zip file with unzip ~/fasting.zip -d ~ to restore data
- Environment Variable: You can use OPENAI_API_KEY as an alternative (takes precedence)
- Clean Data: Use fasting clean to delete meals/weight data
- Full Reset: Use fasting clean --config to delete everything including API key

$3

`bash


Delete meals, weight, and fast data (keeps API key)

`javascript
import {
logMeal, logDrink, getTodaysEntries, getCalorieHistory,
logWeight, getWeightHistory,
startFast, endFast, getCurrentFast, getFastHistory, getFastStats,
logExercise, getTodaysExercises, getExerciseHistory
} from '@profullstack/fasting';

// NEW: Import recommendation and unit functions
import { generateMealRecommendations, formatRecommendations } from '@profullstack/fasting/lib/meal-recommender.js';
import { generateExerciseRecommendations, formatExerciseRecommendations } from '@profullstack/fasting/lib/exercise-recommender.js';
import { generateDrinkRecommendations, formatDrinkRecommendations } from '@profullstack/fasting/lib/drink-recommender.js';
import { parseSize, convertVolume, getSizeExamples } from '@profullstack/fasting/lib/units.js';
import { getUnitSystem, setUnitSystem, getActivityLevel, setActivityLevel, getMedicalConditions, addMedicalCondition, getUserProfile } from '@profullstack/fasting/lib/config.js';

// Fast tracking
startFast(); // Start fast now
startFast('2023-12-01 18:00'); // Start fast at specific time
const currentFast = getCurrentFast(); // Get active fast
const completedFast = endFast(); // End current fast

// Log meals and drinks programmatically
logMeal('Grilled chicken breast', 350);
logDrink('Orange juice', 120);

// Get today's entries
const todaysEntries = getTodaysEntries();
console.log(todaysEntries);

// Weight tracking
logWeight(175.5);
const weightHistory = getWeightHistory();

// Fast history and statistics
const fastHistory = getFastHistory(); // Completed fasts only
const fastStats = getFastStats(); // Statistics summary

// Calorie history
const calorieHistory = getCalorieHistory(); // Daily calorie totals

// Exercise tracking
logExercise('Running', 30, 300); // description, duration (min), calories burned
const todaysExercises = getTodaysExercises(); // Today's exercises
const exerciseHistory = getExerciseHistory(); // Daily exercise calorie totals

// NEW: User profile management
setActivityLevel('active'); // or 'sedentary', 'moderate'
const activityLevel = getActivityLevel();
addMedicalCondition('high blood pressure');
addMedicalCondition('diabetes');
const conditions = getMedicalConditions(); // ['high blood pressure', 'diabetes']
const profile = getUserProfile(); // Complete user profile

// NEW: AI-powered personalized recommendations
const mealRecommendations = await generateMealRecommendations('sandwiches', {
mealType: 'lunch',
calorieTarget: 400,
dietaryRestrictions: 'vegetarian'
});
const formattedMeals = formatRecommendations(mealRecommendations);

const exerciseRecommendations = await generateExerciseRecommendations('cardio', {
duration: 30,
intensity: 'moderate',
location: 'home'
});
const formattedExercises = formatExerciseRecommendations(exerciseRecommendations);

const drinkRecommendations = await generateDrinkRecommendations('smoothies', {
purpose: 'post-workout',
calorieTarget: 200
});
const formattedDrinks = formatDrinkRecommendations(drinkRecommendations);

// NEW: Unit system management
setUnitSystem('metric'); // or 'imperial'
const currentSystem = getUnitSystem();

// NEW: Unit parsing and conversion
const parsed = parseSize('500ml', 'volume');
const converted = convertVolume(16, 'fl oz', 'ml'); // 473.18
const examples = getSizeExamples('volume'); // ['250ml', '500ml', '1l', '1.5l']
`

$3

Fast Tracking:
- startFast(startTime?) - Start a new fast (optional custom start time)
- endFast(endTime?) - End current fast (optional custom end time)
- getCurrentFast() - Get active fast or null
- getFastHistory() - Get all completed fasts
- getFastStats() - Get fast statistics (average, longest, etc.)

Meal & Weight Tracking:
- logMeal(description, calories) - Log a meal with description and calorie count
- logDrink(description, calories) - Log a drink with description and calorie count
- getTodaysEntries() - Get all meals and drinks logged today
- getCalorieHistory() - Get daily calorie totals grouped by date
- logWeight(weight) - Log weight in pounds
- getWeightHistory() - Get complete weight history with timestamps

Exercise Tracking:
- logExercise(description, duration, caloriesBurned) - Log exercise with description, duration (minutes), and calories burned
- getTodaysExercises() - Get all exercises logged today
- getExerciseHistory() - Get daily exercise calorie totals grouped by date

NEW: AI-Powered Personalized Recommendations:
- generateMealRecommendations(preference, options) - Generate personalized meal recommendations
- formatRecommendations(recommendations) - Format meal recommendations for display
- generateExerciseRecommendations(preference, options) - Generate personalized exercise recommendations
- formatExerciseRecommendations(recommendations) - Format exercise recommendations for display
- generateDrinkRecommendations(preference, options) - Generate personalized drink recommendations
- formatDrinkRecommendations(recommendations) - Format drink recommendations for display

NEW: User Profile Management:
- getActivityLevel() - Get current activity level ('sedentary', 'moderate', 'active')
- setActivityLevel(level) - Set activity level preference
- getMedicalConditions() - Get array of medical conditions
- addMedicalCondition(condition) - Add a medical condition
- removeMedicalCondition(condition) - Remove a medical condition
- setMedicalConditions(conditions) - Set medical conditions array
- getUserProfile() - Get complete user profile object

NEW: Unit System Management:
- getUnitSystem() - Get current unit system ('imperial' or 'metric')
- setUnitSystem(system) - Set unit system preference
- parseSize(input, type) - Parse size input with unit detection
- convertVolume(value, fromUnit, toUnit) - Convert between volume units
- getSizeExamples(type) - Get size examples for current unit system

Note: When using the module API, you need to provide calorie counts manually for basic functions. Automatic calorie estimation and AI recommendations via OpenAI are available through both CLI commands and the new recommendation API functions.

Development & Testing

$3

The project includes comprehensive unit tests for all functionality:

`bash


Run all tests (core tests only, faster)

Test Organization:
- Core tests run by default with pnpm test (11 test files, ~66 tests)
- AI tests only run with pnpm test:ai flag (14 test files, ~69 tests)
- Separation rationale: AI tests require OpenAI API key and take longer to run
- CI/CD friendly: Core tests can run in environments without API keys

Test Statistics:
- 14 total test files with 69+ total tests
- 100% pass rate with comprehensive error handling validation
- Isolated testing environment - Uses temporary directories to avoid interfering with real user data
- Integration testing - Validates system consistency and cross-module functionality

All tests use isolated temporary directories to avoid interfering with real user data.

$3

The project includes a git pre-commit hook that runs syntax checks before allowing commits:

`bash


The hook runs automatically on git commit

To bypass the pre-commit hook (not recommended):
`bash
git commit --no-verify -m "Your commit message"
`

$3

The project includes example scripts demonstrating usage:

`bash


Run CLI usage example

Example Files:
- examples/basic-usage.js - Demonstrates CLI commands and workflow
- examples/api-usage.js - Shows programmatic Node.js module usage

Publishing

$3

`bash


Patch version (bug fixes): 1.0.2 -> 1.0.3

`bash


Complete workflow