docs: complete Phase 9 backlog triage (issues map, briefs, ADRs)

Map design IDs to Gitea #1-#37, add tasks 80-88, stub ADRs 0004-0006, and point STATUS at the P1 batch order.
2026-07-04 01:23:30 -05:00
parent 5dfc8b8034
commit 76f68548b2
17 changed files with 815 additions and 3 deletions
@@ -0,0 +1,36 @@
+# 80 — Quick-add opens create UI
+
+## Goal
+
+Make every quick-add action open the entity's creation dialog/sheet instead of only navigating to a module page.
+
+## Why
+
+Task 21 shipped URL navigation as a placeholder. Users expect "New event" to start creating an event immediately.
+
+## Depends on
+
+- 21 (quick-add registry)
+
+## Scope
+
+- Extend `QuickAddAction` / client handling so actions can open create UI (dialog/sheet) in-place.
+- Wire calendar, lists, notes, garden, bangs (and any other registered) quick-adds to their create UIs.
+- Keep FAB sheet and cmd-k behavior identical per action.
+- Playwright: extend `tests/e2e/dashboard.spec.ts` and/or add `tests/e2e/quick-add.spec.ts`.
+
+## Out of scope
+
+- Fuzzy search across entities.
+- New entity types.
+
+## Acceptance criteria
+
+- [ ] Each registered quick-add opens create UI with create controls visible.
+- [ ] No quick-add is navigation-only unless explicitly documented as view-only (none in v1 set).
+- [ ] E2E: FAB → action opens dialog/sheet (not only route change).
+
+## Notes
+
+- Gitea: [ginnoir/famapp#1](https://gitea.ginnoir.com/ginnoir/famapp/issues/1)
+- Prefer reusing existing create dialogs/sheets over new ones.
@@ -0,0 +1,34 @@
+# 81 — Dashboard edit mode live widgets
+
+## Goal
+
+In dashboard edit mode, render each widget's real data at its true final size so layout matches the saved view.
+
+## Why
+
+Edit mode currently shows empty placeholders; on save, content-heavy widgets (e.g. Recent activity) expand and the grid reflows.
+
+## Depends on
+
+- 26 (customizable layout + widget configuration)
+
+## Scope
+
+- `DashboardEditor` / edit mode loads real widget components and data (not empty shells).
+- Widgets size to content consistently between edit and view modes.
+- Playwright: extend `tests/e2e/dashboard.spec.ts` — enter `?edit=1`, assert real content visible. Prefer height-stability assertion only if non-flaky.
+
+## Out of scope
+
+- Redesigning the widget picker or config schemas.
+- New widget types.
+
+## Acceptance criteria
+
+- [ ] Edit mode shows real widget content for registered widgets.
+- [ ] Saving layout does not cause a large content-driven reflow for content-heavy widgets.
+- [ ] E2E covers real content visible in edit mode.
+
+## Notes
+
+- Gitea: [ginnoir/famapp#2](https://gitea.ginnoir.com/ginnoir/famapp/issues/2)
@@ -0,0 +1,33 @@
+# 82 — Garden container plant count
+
+## Goal
+
+Fix container plant counts so a container with N plants displays N, and audit sibling counts for the same bug.
+
+## Why
+
+Containers (e.g. "plantie cabinet") show "0 plants" despite containing plants — likely a query/join or association bug.
+
+## Depends on
+
+- 71 (garden containers), 72 (garden plants)
+
+## Scope
+
+- Find and fix the count query in `src/modules/garden/server/queries.ts` (and related UI).
+- Audit other garden counts (lists, widgets) for the same pattern; fix or file follow-ups.
+- Playwright: extend `tests/e2e/garden.spec.ts` — plant in container → count ≥ 1.
+
+## Out of scope
+
+- New garden features.
+
+## Acceptance criteria
+
+- [ ] Container with N plants displays N (not 0).
+- [ ] Sibling counts audited; fixed or follow-ups filed.
+- [ ] E2E covers plant-in-container count.
+
+## Notes
+
+- Gitea: [ginnoir/famapp#3](https://gitea.ginnoir.com/ginnoir/famapp/issues/3)
@@ -0,0 +1,35 @@
+# 83 — Bang edit and delete
+
+## Goal
+
+Allow editing and deleting bang entries after creation (e.g. wrong date).
+
+## Why
+
+Bangs can be recorded but not corrected. Only create exists today.
+
+## Depends on
+
+- Bangs module (in tree; no prior task number)
+
+## Scope
+
+- Server actions for update and delete.
+- UI on the bang widget (and any list surface) for edit/delete.
+- Activity log for update/delete if other modules log similarly.
+- Playwright: new `tests/e2e/bangs.spec.ts` — record → edit date → assert → delete → assert gone.
+
+## Out of scope
+
+- Bang stats widget (design #11 / Gitea #31) — separate P2 issue.
+
+## Acceptance criteria
+
+- [ ] Edit a bang (e.g. change date) and see the update.
+- [ ] Delete a bang and it no longer appears.
+- [ ] E2E covers edit and delete.
+
+## Notes
+
+- Gitea: [ginnoir/famapp#4](https://gitea.ginnoir.com/ginnoir/famapp/issues/4)
+- Related (not blocking): #31 bang stats widget.
@@ -0,0 +1,34 @@
+# 84 — Back navigation on detail pages
+
+## Goal
+
+Audit detail routes lacking back affordances and add a shared header/back pattern consistently.
+
+## Why
+
+Individual plant pages (and other detail routes) have no in-page "back" except global nav.
+
+## Depends on
+
+- Existing app routes under `src/app/`
+
+## Scope
+
+- Audit all routes in `src/app/` for detail pages missing back; list them in the PR description.
+- Shared back affordance (header/back component).
+- Apply consistently to plant, note, list, and other detail pages.
+- Playwright: `tests/e2e/navigation.spec.ts` or per-module — Back visible and returns to parent.
+
+## Out of scope
+
+- Redesigning global nav or dashboard tabs.
+
+## Acceptance criteria
+
+- [ ] Audit list included in PR.
+- [ ] Shared back control on detail pages.
+- [ ] E2E covers representative detail routes.
+
+## Notes
+
+- Gitea: [ginnoir/famapp#6](https://gitea.ginnoir.com/ginnoir/famapp/issues/6)
@@ -0,0 +1,42 @@
+# 85 — Rich-text notes overhaul
+
+## Goal
+
+Land a shared rich-text editor (ADR 0004), wire it through notes create/edit and all display surfaces, and fix mobile horizontal overflow.
+
+## Why
+
+Journal (86) and notes need modern formatting and emoji. Notes currently overflow sideways on mobile. P1 pulls the full notes overhaul into this batch.
+
+## Depends on
+
+- 12 (notes module)
+- ADR `0004-rich-text-editor.md` (research child: Gitea #8)
+- Batch order: after bugs 80–84 and API foundation 87 is preferred for notes API extension, but editor work can proceed once ADR is accepted
+
+## Scope
+
+- Research and accept ADR 0004 (library e.g. TipTap, storage format, shared component contract).
+- Shared editor component used by notes (and later journal).
+- Notes create/edit use the shared editor.
+- Render formatting on index, widgets, and share view.
+- Fix mobile overflow (closes Gitea #5 / design #5).
+- Playwright: extend `tests/e2e/notes.spec.ts` — formatted note visible; 375px no horizontal overflow.
+
+## Out of scope
+
+- Journal module (86) — consumes the shared editor after this lands.
+- Appearance/theming epic.
+
+## Acceptance criteria
+
+- [ ] ADR 0004 accepted with library and storage format chosen.
+- [ ] Shared editor component in tree.
+- [ ] Notes create/edit use it.
+- [ ] Formatting renders on all notes surfaces.
+- [ ] Mobile overflow fixed; E2E green.
+
+## Notes
+
+- Gitea epic: [#7](https://gitea.ginnoir.com/ginnoir/famapp/issues/7); children #8–#12; overflow bug [#5](https://gitea.ginnoir.com/ginnoir/famapp/issues/5)
+- Design: `docs/superpowers/specs/2026-07-03-backlog-triage-design.md`
@@ -0,0 +1,45 @@
+# 86 — Journal module
+
+## Goal
+
+Ship a per-user journal module with entries, mood tracking, insights, and journal API endpoints on the existing API foundation.
+
+## Why
+
+P1 personal journaling with mood/stress/pills tracking and stats, without blocking on P2 work.
+
+## Depends on
+
+- 85 (shared rich-text editor)
+- 87 (API surface for existing modules — journal adds endpoints the same way)
+- ADR `0005-journal-research.md` (Gitea #20)
+
+## Scope
+
+- Research ADR 0005 (mood/journal libs; build-vs-adopt).
+- Schema + CRUD (per-user entries).
+- Index: last 5–10 entries compact, browse all, small calendar of days with entries.
+- Entry detail and create: **date (default today) and time (default now) required**; everything else optional.
+- Fields: rich note text (shared editor); numerical stress; mood with color/emoji options and **multi-select**; took-my-pills-today boolean.
+- Module-level mood-tracker view over time.
+- Per-user insights/stats (trends, streaks, correlations — propose specifics in ADR/implementation).
+- Journal API endpoints (additive on 87).
+- Playwright: new `tests/e2e/journal.spec.ts` — minimal entry → recent list → detail → mood tracker loads.
+
+## Out of scope
+
+- Household-shared journals (per-user only).
+- LLM agent tools for journal (88 can add later).
+
+## Acceptance criteria
+
+- [ ] ADR 0005 accepted.
+- [ ] Create entry with only date/time.
+- [ ] Index, detail, mood tracker, and insights views work.
+- [ ] Journal API endpoints documented and callable with token auth.
+- [ ] E2E happy path green.
+
+## Notes
+
+- Gitea epic: [#19](https://gitea.ginnoir.com/ginnoir/famapp/issues/19); children #20–#27
+- Depends on #7 (rich-text) and #15 (API surface)
@@ -0,0 +1,39 @@
+# 87 — API surface + token auth
+
+## Goal
+
+Documented HTTP API for existing modules (calendar, lists, notes, garden, bangs) with token auth suitable for non-browser clients, coexisting with OIDC session auth.
+
+## Why
+
+API-early batch order: foundation lands after bugs so journal and notes can extend it; LLM agent (88) maps tools onto it.
+
+## Depends on
+
+- ADR `0006-api-llm-agent.md` research half (Gitea #14) — auth model and API shape decided before implementation
+
+## Scope
+
+- Architecture ADR 0006: token auth vs OIDC session coexistence; API shape; additive versioning (no freeze that blocks journal).
+- Token auth for non-browser clients.
+- Endpoints for existing entities: events, lists/items, notes, garden, bangs (dashboards as needed).
+- API docs (OpenAPI or equivalent living doc).
+- Vitest for auth + route handlers; optional Playwright smoke only if useful.
+
+## Out of scope
+
+- LLM agent chat UI and tool-calling (88).
+- Journal endpoints (86 adds them).
+
+## Acceptance criteria
+
+- [ ] ADR 0006 documents auth coexistence and API shape.
+- [ ] Token-authenticated client can read/write covered entities.
+- [ ] Session (OIDC) auth still works for the web app.
+- [ ] Docs list endpoints and auth.
+- [ ] Unit/integration tests for auth and handlers.
+
+## Notes
+
+- Gitea: epic [#13](https://gitea.ginnoir.com/ginnoir/famapp/issues/13); research [#14](https://gitea.ginnoir.com/ginnoir/famapp/issues/14); implementation [#15](https://gitea.ginnoir.com/ginnoir/famapp/issues/15)
+- Batch step 6 (after bugs 80–84)
@@ -0,0 +1,39 @@
+# 88 — LLM agent chat
+
+## Goal
+
+Natural-language chat that acts on the app via tool-calling against the API, using a provider-agnostic OpenAI-compatible endpoint (self-hosted on the homelab).
+
+## Why
+
+Users should say "add milk to the shopping list" or "what's on the calendar Friday?" and have the agent use the API.
+
+## Depends on
+
+- 87 (API surface)
+- ADR `0006-api-llm-agent.md` agent half (MCP yes/no, tool mapping)
+
+## Scope
+
+- Agent chat UI in the app.
+- OpenAI-compatible client (provider-agnostic).
+- Tool-calling mapped to API endpoints from 87 (and journal if present).
+- Decide MCP vs direct tools in ADR 0006.
+- Smoke tests with **mock/stub** provider in CI — no live LLM in CI.
+
+## Out of scope
+
+- Training or fine-tuning models.
+- Forward-auth for other homelab apps.
+
+## Acceptance criteria
+
+- [ ] Chat UI sends prompts and shows responses.
+- [ ] Tools call the API successfully in dev against the homelab endpoint.
+- [ ] CI uses mock provider only.
+- [ ] ADR 0006 records provider and MCP decisions.
+
+## Notes
+
+- Gitea: [#16](https://gitea.ginnoir.com/ginnoir/famapp/issues/16), [#17](https://gitea.ginnoir.com/ginnoir/famapp/issues/17), [#18](https://gitea.ginnoir.com/ginnoir/famapp/issues/18)
+- Depends on [#15](https://gitea.ginnoir.com/ginnoir/famapp/issues/15)
@@ -79,3 +79,17 @@ Every task file has these sections:
 - [73 — Garden care tracking](73-garden-care-tracking.md)
 - [74 — Garden integrations](74-garden-integrations.md)
 - [75 — Garden dashboard](75-garden-dashboard.md)
+
+### Phase 9 — Post-v0.1
+
+Batch order (bugs → API → editor/notes → journal → agent). Design: [`docs/superpowers/specs/2026-07-03-backlog-triage-design.md`](../superpowers/specs/2026-07-03-backlog-triage-design.md). Issue map: [`docs/issues-map.md`](../issues-map.md).
+
+- [80 — Quick-add create UI](80-quick-add-create-ui.md)
+- [81 — Dashboard edit live widgets](81-dashboard-edit-live-widgets.md)
+- [82 — Garden plant count](82-garden-plant-count.md)
+- [83 — Bang edit/delete](83-bang-edit-delete.md)
+- [84 — Back navigation](84-back-navigation.md)
+- [85 — Rich-text notes overhaul](85-rich-text-notes.md)
+- [86 — Journal module](86-journal-module.md)
+- [87 — API surface](87-api-surface.md)
+- [88 — LLM agent chat](88-llm-agent-chat.md)