OpenClaw Bot
96 lines
3.4 KiB
Markdown
96 lines
3.4 KiB
Markdown
# Native Meal Planning Signals Patch
|
|
|
|
Status: local patch series, not deployed and not pushed upstream.
|
|
|
|
This patch series turns the Oikos Assist meal-planning sidecar concepts into a first native Oikos shape. The intent is to make meal-planning data belong to Oikos core while Assist remains a suggestion/prepare-action layer.
|
|
|
|
## Patch series
|
|
|
|
- `7c11806` — `feat: add native meal planning signal api`
|
|
- `0b6603b` — `test: cover native meal planning schema`
|
|
- `5099155` — `feat: expose meal cook assignments on meals`
|
|
- `cf099bb` — `feat: add native meal cook selector`
|
|
|
|
## Schema
|
|
|
|
Migration v39 adds these tables:
|
|
|
|
- `meal_cooking_rules` — recurring cook rules by user, weekday, and meal type.
|
|
- `recipe_family_preferences` — per-user recipe preferences and capability signals.
|
|
- `recipe_variation_meta` — recipe protein/style/kid-suitability metadata.
|
|
- `planned_meal_cooks` — assigned cook for a planned/saved meal.
|
|
- `meal_plan_feedback` — accept/reject/edit/swap/confirm/cookbook feedback events.
|
|
- `kids_cookbooks` — saved kid-readable cookbook previews.
|
|
|
|
## API surface
|
|
|
|
New route namespace: `/api/v1/meal-planning`.
|
|
|
|
Endpoints added:
|
|
|
|
- `GET /cooking-rules`
|
|
- `PUT /cooking-rules`
|
|
- `GET /recipe-signals`
|
|
- `PUT /recipe-signals/:recipeId`
|
|
- `GET /variation-meta`
|
|
- `PUT /variation-meta/:recipeId`
|
|
- `GET /cook-assignments`
|
|
- `PUT /cook-assignments/:mealId`
|
|
- `GET /feedback`
|
|
- `POST /feedback`
|
|
- `GET /kids-cookbooks`
|
|
- `POST /kids-cookbooks`
|
|
|
|
OpenAPI path entries are included for the new namespace.
|
|
|
|
## Native meals integration
|
|
|
|
`/api/v1/meals` now exposes cook assignments directly:
|
|
|
|
- Weekly `GET /api/v1/meals` returns `cook_assignment` per meal.
|
|
- `POST /api/v1/meals` accepts `cook_user_id` / `cookUserId` and optional `source_plan_id` / `sourcePlanId`.
|
|
- `PUT /api/v1/meals/:id` accepts the same fields and can clear with `cook_user_id: null`.
|
|
- Moving a meal without explicitly changing cook syncs the assignment date/type to the new slot.
|
|
|
|
## Native UI integration
|
|
|
|
`public/pages/meals.js` now:
|
|
|
|
- loads `/family/members`,
|
|
- displays assigned cook on meal cards,
|
|
- adds a cook selector to the meal create/edit modal,
|
|
- sends `cook_user_id` through native meal create/edit calls.
|
|
|
|
Locale keys added in English and German:
|
|
|
|
- `meals.cookLabel`
|
|
- `meals.cookNone`
|
|
|
|
## Verification run
|
|
|
|
Passed locally:
|
|
|
|
```bash
|
|
node --check server/routes/meal-planning.js
|
|
node --check server/routes/meals.js
|
|
node --check server/index.js
|
|
node --check server/openapi.js
|
|
node --check public/pages/meals.js
|
|
node -e "JSON.parse(require('fs').readFileSync('public/locales/en.json','utf8')); JSON.parse(require('fs').readFileSync('public/locales/de.json','utf8'))"
|
|
npm run test:meal-planning
|
|
npm run test:meals
|
|
```
|
|
|
|
Focused test results:
|
|
|
|
- `test:meal-planning`: 15/15 passing
|
|
- `test:meals`: 22/22 passing
|
|
|
|
## Known caveats before upstream PR
|
|
|
|
- The route currently supports the needed native shape, but should be reviewed for upstream naming conventions.
|
|
- The OpenAPI entries are intentionally broad (`jsonBody(null)`) and should be expanded with formal schemas before a polished PR.
|
|
- Only English/German locale keys were added in this patch. Other locales fall back, but a full upstream PR should update all supported locales or accept fallback behavior.
|
|
- This patch does not include AI generation. That remains outside Oikos core; Assist should call these native endpoints once this lands.
|
|
- The local working tree has unrelated Danish translation edits that are intentionally not part of this patch series.
|