Read, update, and explore the user's health profile questionnaire (sections, questions, answers).
PREREQUISITE: Read
../betterness-shared/SKILL.mdfor auth, global flags, and security rules.
betterness health-profile <command> [flags]
health-profile schemaList all sections and question IDs. Always call this first to discover available fields before reading or writing.
# List all sections
betterness health-profile schema --json
# List questions in a specific section
betterness health-profile schema --section HWP --json
| Option | Description |
|---|
--section <acronym> | Show questions for a specific section only |
Sections: HWP (Health & Wellness Profile), WEALH (Wellness Goals & Assessments), DMH (Medical History), DA (Diets & Allergies), FHSS (Family Health), FHIS (Family History), WHT (Wearables & Health Tracking), BS (Body Snapshot), PRSUP (Prescriptions & Supplements)
health-profile getRetrieve the full health profile as a flat map of question ID → answer value.
betterness health-profile get --json
health-profile get-sectionRetrieve answers for a single section.
betterness health-profile get-section --section DA --json
| Option | Description |
|---|---|
--section <acronym> | Required. Section acronym (e.g. HWP, DMH, DA) |
health-profile updatePatch health profile answers. Only provided question IDs are changed. Accepts a free-form JSON object where keys are question IDs and values are the answer data.
# Preview changes
betterness health-profile update --dry-run --json \
--data '{"HWP_HAB_do_you_smoke_cigarettes_or_use_tobacco_products": false}'
# Apply changes
betterness health-profile update --json \
--data '{"HWP_HAB_do_you_smoke_cigarettes_or_use_tobacco_products": false}'
| Option | Description |
|---|---|
--data <json> | Required. JSON object with question IDs as keys |
--dry-run | Preview changes without applying |
Answer value formats (use schema to see the exact type and example for each question):
"text value"true or false7"Option A"["Option A", "Option B"]{"Area 1": "3", "Area 2": "5"}{"boolean": true, "string": "additional details"}{"boolean": true, "arrayString": ["opt1", "opt2"]}{"boolean": true, "keyValueList": [{"name": "Metformin", "value": "500", "dosageUnit": "mg"}]}{"boolean": true, "supplementsData": {"Vitamin D": {"isActive": true, "dosifications": [{"name": "Vitamin D3", "dosage": 1000, "dosageUnit": "IU"}]}}}{"boolean": true, "dosifications": [{"name": "Medication", "dosage": 100, "dosageUnit": "mg"}]}[{"id": "1", "relationship": "Brother", "name": "John", "sex": "Male", "livingStatus": "Living", "healthConditionsStatus": "Known", "healthConditions": ["Diabetes"]}]health-profile reset-sectionClear all answers in a section.
# Preview
betterness health-profile reset-section --section DA --dry-run --json
# Apply
betterness health-profile reset-section --section DA --json
| Option | Description |
|---|---|
--section <acronym> | Required. Section acronym |
--dry-run | Preview without applying |
health-profile summaryHuman-readable summary of all answered questions, organized by section.
# All sections
betterness health-profile summary --json
# Single section
betterness health-profile summary --section HWP --json
| Option | Description |
|---|---|
--section <acronym> | Summarize a specific section only |
Returns rows with section, question (label), and answer (formatted value).
health-profile schema --json → learn available sections and question IDshealth-profile get --json or get-section --section X --json → see current values and their data shapeshealth-profile update --dry-run --data '{...}' --json → preview, then confirm with user, then apply without --dry-runAgent rules:
schema before writing to validate question IDs exist--dry-run first on update and reset-section, then confirm with the userget or get-section to inspect the current answer format before constructing update data