Weight Tracking

Script path: python3 {baseDir}/scripts/weight-tracker.py

Save + Deviation Check — save-and-check.py (preferred)

Use this for all weight saves. Combines save + deviation-check in ONE call — no second tool call needed.

python3 {baseDir}/scripts/save-and-check.py \
  --data-dir {workspaceDir}/data \
  --value 79.5 --unit kg \
  --tz-offset 28800 \
  --plan-file {workspaceDir}/PLAN.md \
  --health-profile {workspaceDir}/health-profile.md \
  --user-file {workspaceDir}/USER.md \
  --wgs-script {weight-gain-strategy:baseDir}/scripts/analyze-weight-trend.py \
  [--correct]

Returns:

{
  "save": { "action": "created"|"updated", "key": "<datetime>", "value": 79.5, "unit": "kg" },
  "deviation": { "triggered": true|false, "severity": "none"|"light"|"cause-check", ... }
}

• deviation is null if PLAN.md missing, health flags active, or insufficient data — no extra handling needed.

Save only — weight-tracker.py save

Use only when deviation-check is not needed (e.g., onboarding initial weight).

python3 {baseDir}/scripts/weight-tracker.py save \
  --data-dir {workspaceDir}/data \
  --value 79.5 --unit kg \
  --tz-offset 28800 \
  [--correct]

• Auto-detects new vs correction: if last entry ≤ 30 min ago, overwrites. Otherwise creates new.
• --correct: force overwrite most recent entry (when user explicitly says "that was wrong")

Load — load

python3 {baseDir}/scripts/weight-tracker.py load \
  --data-dir {workspaceDir}/data \
  --display-unit kg \
  [--last 7] \
  [--from 2026-02-01 --to 2026-03-06]

Returns entries converted to --display-unit, rounded to 1 decimal.

Other Commands

See references/crud-operations.md for: delete, update, set-unit.

Workflow

User Reports Weight

1. Read timezone.json → tz_offset; read health-profile.md → Unit Preference (parallel, first session only)
2. Call save-and-check.py — one call does both save and deviation-check:

   python3 {baseDir}/scripts/save-and-check.py \
     --data-dir {workspaceDir}/data \
     --value <N> --unit <u> --tz-offset <tz> \
     --plan-file {workspaceDir}/PLAN.md \
     --health-profile {workspaceDir}/health-profile.md \
     --user-file {workspaceDir}/USER.md \
     --wgs-script {weight-gain-strategy:baseDir}/scripts/analyze-weight-trend.py
   

3. Read response — both results arrive together:
   • save.action: "created" → "Logged ✓"; "updated" → "Updated ✓". Show value in preferred unit.
   • deviation is null or triggered: false → just the log confirmation.
   • deviation.triggered: true → respond per severity. See references/deviation-workflow.md.

User Asks for Trend / History

1. Call load with appropriate filters and --display-unit
2. Present data (table, summary, or trend description)

User Wants to Correct / Delete / Change Unit

See references/crud-operations.md.

Interaction Guidelines

• Record weight whenever mentioned. Not limited to scheduled days. "今天早上74.5", "刚称了一下79" → call save. Exception: past/hypothetical ("我以前80公斤").
• Never comment on weight changes unprompted. Just log and confirm. Emotional reactions → emotional-support skill.
• Always display in preferred unit, rounded to 1 decimal.
• Accept any common unit: kg, lb, lbs, 斤 (=0.5 kg), 公斤.
• Fasting tag: if user mentions empty stomach / morning weigh-in → note fasting: true in context.

References