Skip to main content
← back to extensions

Babybuddy

@kneel/babybuddyv2026.10.16.1· 16d agoBEHAVIORSREPORTS
01README

Read and write Baby Buddy baby-tracking data (feedings, diapers, sleep, pumping, weight, and more) with paginated sync, and generate a suite of analysis reports — a consolidated daily summary plus sleep (totals, longest stretch, feeding correlation, regression watch), feeding, diaper, pumping, temperature, tummy-time, medication, and weight-trend reports.

02Behaviors1
@kneel/babybuddyv2026.10.16.1babybuddy.ts

Global Arguments

ArgumentTypeDescription
baseUrlurlBaby Buddy base URL, e.g. https://baby.example.com
tokenstringBaby Buddy API token
childId?numberChild ID to operate on; if omitted, the first child is used
fn sync(sinceHours?: number, includeAge?: boolean)
Pull recent entries across all tracked types into `entries`
ArgumentTypeDescription
sinceHours?numberHow many hours of history to pull (default 168 = 7 days)
includeAge?booleanOpt in to an anonymized age band (e.g. "8-10mo"). When true, sync reads
fn log-feeding(method: string, type?: string, durationMinutes?: number, amount?: number, amountUnit?: string, start?: string, end?: string, notes?: string)
Log a feeding
ArgumentTypeDescription
methodstringleft breast | right breast | both breasts | bottle | parent fed | self fed
type?stringbreast milk | formula | fortified breast milk | solid food
durationMinutes?number
amount?number
amountUnit?string
start?string
end?string
notes?string
fn log-diaper(wet?: boolean, solid?: boolean, color?: string, amount?: number, time?: string, notes?: string)
Log a diaper change
ArgumentTypeDescription
wet?boolean
solid?boolean
color?stringblack | brown | green | yellow
amount?number
time?string
notes?string
fn log-pumping(amount: number, amountUnit?: string, durationMinutes?: number, start?: string, end?: string, notes?: string)
Log a pumping session
ArgumentTypeDescription
amountnumber
amountUnit?string
durationMinutes?number
start?string
end?string
notes?string
fn log-sleep(durationMinutes?: number, start?: string, end?: string, nap?: boolean, notes?: string)
Log a sleep session
ArgumentTypeDescription
durationMinutes?number
start?string
end?string
nap?boolean
notes?string
fn log-tummy-time(durationMinutes?: number, start?: string, end?: string, milestone?: string)
Log tummy time
ArgumentTypeDescription
durationMinutes?number
start?string
end?string
milestone?string
fn log-note(note: string, time?: string)
Add a note about the child
ArgumentTypeDescription
notestring
time?string
fn log-temperature(temperature: number, temperatureUnit?: string, time?: string, notes?: string)
Log a temperature reading
ArgumentTypeDescription
temperaturenumber
temperatureUnit?string
time?string
notes?string
fn log-medication(name: string, dosage: number, dosageUnit?: string, time?: string, nextDoseInterval?: string, notes?: string)
Log a medication dose
ArgumentTypeDescription
namestring
dosagenumber
dosageUnit?stringmg | ml | tablets | drops
time?string
nextDoseInterval?stringISO 8601 duration, e.g. PT8H
notes?string
fn update-entry(id: number)
Update fields on an existing Baby Buddy entry
ArgumentTypeDescription
idnumberBaby Buddy id of the entry to update
fn delete-entry(id: number)
Delete a Baby Buddy entry by type and id (idempotent)
ArgumentTypeDescription
idnumberBaby Buddy id of the entry to delete
fn start-timer(name?: string)
Start a Baby Buddy timer (name it to enable auto-convert)
ArgumentTypeDescription
name?stringTimer name; a name like 'feeding'/'sleep'/'pumping'/'tummy' lets stop-timer auto-convert
fn stop-timer(timerId?: number, name?: string, createEntry?: enum, method?: string, type?: string, amount?: number, amountUnit?: string, nap?: boolean, milestone?: string, start?: string, end?: string, notes?: string)
Stop a timer and convert it into its activity (or discard it)
ArgumentTypeDescription
timerId?numberTimer to stop; if omitted, resolved by name or the most recent timer
name?string
createEntry?enumWhat to convert the timer into. Omit to infer from the timer name; use 'discard' to delete without an entry
method?stringfeeding: left/right/both breasts, bottle, ...
type?stringfeeding: breast milk | formula | fortified breast milk | solid food
amount?number
amountUnit?string
nap?booleansleep: mark as nap
milestone?stringtummy-time: milestone note
start?stringISO-8601 start to backdate the converted entry to; PATCHed onto the entry after conversion (Baby Buddy otherwise keeps the timer's own start)
end?stringISO-8601 end for the converted entry; PATCHed on after conversion so a forgotten timer isn't closed at 'now'. The entry briefly has end='now' between the convert POST and this PATCH; the timer link (provenance) is preserved either way
notes?string
fn rename-timer(timerId?: number, name?: string, newName: string)
Rename an active timer (e.g. to enable auto-convert)
ArgumentTypeDescription
timerId?number
name?stringCurrent name (used if timerId omitted)
newNamestringNew timer name
fn list-timers()
Snapshot the active timers into `timers` (read-only)

Resources

entries(30d)— Snapshot of recent entries across all tracked types
logged(infinite)— A single entry created by a log-* or update-entry method
deleted(infinite)— Record of an entry removed by delete-entry
timer(infinite)— A timer started or renamed by a timer method
timers(30d)— Snapshot of active timers from list-timers
03Reports16
@kneel/babybuddy-daily-summarymodel
daily_summary.ts

Consolidated per-day digest (sleep, feedings, diapers, pumping, weight) from the latest sync

babybuddysummary
@kneel/babybuddy-diaper-intervalsmodel
diaper_intervals.ts

Time between consecutive diaper changes with stats, from the latest sync

babybuddydiaper
@kneel/babybuddy-diaper-typesmodel
diaper_types.ts

Daily wet/solid diaper breakdown with color counts, from the latest sync

babybuddydiaper
@kneel/babybuddy-feeding-amountsmodel
feeding_amounts.ts

Daily feeding counts and volume split by breast vs bottle, from the latest sync

babybuddyfeeding
@kneel/babybuddy-feeding-durationmodel
feeding_duration.ts

Average and total feeding duration per day, from the latest sync

babybuddyfeeding
@kneel/babybuddy-feeding-intervalsmodel
feeding_intervals.ts

Time between consecutive feedings with stats and recent gaps, from the latest sync

babybuddyfeeding
@kneel/babybuddy-medicationmodel
medication.ts

Per-medication dose counts, latest dosage, and average interval, from the latest sync

babybuddymedication
@kneel/babybuddy-pumping-amountsmodel
pumping_amounts.ts

Daily pumping totals, session counts, and averages, from the latest sync

babybuddypumping
@kneel/babybuddy-sleep-feeding-correlationmodel
sleep_feeding_correlation.ts

Daily sleep totals alongside feeding count and volume, from the latest sync

babybuddysleepfeeding
@kneel/babybuddy-sleep-longest-stretchmodel
sleep_longest_stretch.ts

Longest and average consecutive sleep block per day, from the latest sync

babybuddysleep
@kneel/babybuddy-sleep-regression-watchmodel
sleep_regression_watch.ts

Sustained sleep-regression detector vs. nap fragmentation; needs sync with sinceHours >= 720 (30d)

babybuddysleep
@kneel/babybuddy-sleep-totalsmodel
sleep_totals.ts

Total sleep hours per day with nap vs night breakdown, from the latest sync

babybuddysleep
@kneel/babybuddy-temperaturemodel
temperature.ts

All temperature readings over the window in Celsius and Fahrenheit, from the latest sync

babybuddytemperature
@kneel/babybuddy-tummy-timemodel
tummy_time.ts

Daily tummy-time totals and session counts, from the latest sync

babybuddytummy-time
@kneel/babybuddy-weight-feeding-correlationmodel
weight_feeding_correlation.ts

Weight trajectory overlaid with daily feeding volume, from the latest sync

babybuddyweightfeeding
@kneel/babybuddy-weight-trendmodel
weight_trend.ts

Weight measurements with per-reading and net change, from the latest sync

babybuddyweight
04Previous Versions7
2026.10.03.2

Docs & metadata. Adds CHANGELOG.md (full version history) and backfills the model's upgrades lineage with a per-version description. No functional change since 2026.10.03.1, which added the sleep-regression-watch report (sustained-regression detector vs. nap fragmentation, with a watch tier + non-diagnostic safety layer), paginated sync (drains the 500-record/type cap with dedup + retry), and a tolerant truncated default. See CHANGELOG.md for the full history.

2026.10.03.1

Added 1 reports

2026.07.18.1
2026.07.10.4

v2026.07.10.4: timer methods (start/stop/rename/list). stop-timer converts a timer into its feeding/pumping/sleep/tummy-time activity (auto-inferred from the timer name), never silently discarding.

Modified 1 behaviors

2026.07.10.3

v2026.07.10.3: delete-entry/update-entry methods (full CRUD, idempotent delete) + medication and weight-trend reports (15 total).

Modified 1 behaviors. Added 2 reports

2026.07.10.2

v2026.07.10.2: method entry/completion logging + 'babybuddy-reachable' live pre-flight check on all log-* methods (resolves both adversarial-review follow-ups).

2026.07.10.1

Initial release: consolidated Baby Buddy tracker model (sync + 8 log-* methods) and 13 reports.

05Stats
A
93 / 100
Downloads
27
Archive size
64.1 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License1/2partial

    no SPDX license declared

  • Verified public repository2/2earned
Repository
https://github.com/NeilHanlon/swamp-babybuddy
06Platforms