diff --git a/changelog.d/added-meetings-delete.md b/changelog.d/added-meetings-delete.md new file mode 100644 index 0000000000..075ec6b901 --- /dev/null +++ b/changelog.d/added-meetings-delete.md @@ -0,0 +1 @@ +- Meetings: finished meetings (ended, failed, blocked, declined, left) and stale join requests get a 🗑 Delete action with an in-page confirm, plus **Clear finished** to delete all finished meetings at once. Delete removes the meeting record, its transcript and live state on the hive, erases it in Vexa with Quorum `meeting.delete` (best effort; a failure is reported and the record is still removed), and drops the Calendar entry that existed only for that meeting. Past Calendar entries get the same 🗑 Delete; scheduled ones keep Skip and Cancel. A meeting hive is still in answers 409 (leave it first). Knowledge facts and drafts made from a meeting are not touched. Owner only, audited as `meeting_delete` (`DELETE /api/meetings/{id}`, `POST /api/meetings/clear-finished`, `DELETE /api/meetings/schedule/{eid}`). diff --git a/dashboard/openapi.json b/dashboard/openapi.json index ed80a0500b..a84b7e7096 100644 --- a/dashboard/openapi.json +++ b/dashboard/openapi.json @@ -149,6 +149,152 @@ } } }, + "/api/meetings/clear-finished": { + "post": { + "tags": [ + "Meetings" + ], + "summary": "Clear finished meetings", + "description": "Owner only. Deletes every meeting in a final state that finished before `before` (RFC 3339; empty or later than now means now), each exactly like DELETE /api/meetings/{id}. Live meetings and pending join requests stay. Each deleted meeting is audited as meeting_delete.", + "requestBody": { + "required": false, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "before": { + "type": "string", + "format": "date-time" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Deleted meetings", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "deleted": { + "type": "array", + "items": { + "type": "object", + "properties": { + "id": { + "type": "string" + }, + "state": { + "type": "string", + "description": "The state the meeting was in" + }, + "upstream_error": { + "type": "string", + "description": "Set when Vexa (Quorum meeting.delete) could not confirm the erase; the record on this hive is removed anyway" + }, + "calendar_removed": { + "type": "integer", + "description": "Calendar entries removed because they existed only for this meeting" + } + } + } + }, + "count": { + "type": "integer" + } + } + } + } + } + }, + "400": { + "description": "before is not an RFC 3339 time" + }, + "403": { + "description": "Owner access required" + }, + "503": { + "description": "Meetings are not enabled on this hive" + } + } + } + }, + "/api/meetings/schedule/{eid}": { + "delete": { + "tags": [ + "Meetings" + ], + "summary": "Delete a past Calendar entry", + "description": "Owner only. Deletes a finished Calendar entry (ended, cancelled, declined, failed, blocked, skipped) and the meetings it created, each like DELETE /api/meetings/{id}. Entries still scheduled, awaiting approval or live keep Skip and Cancel and answer 409, as does an entry whose meeting hive is still in. Audited as meeting_schedule_delete, plus meeting_delete for each meeting.", + "parameters": [ + { + "name": "eid", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "Schedule event id" + } + ], + "responses": { + "200": { + "description": "Deleted", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "id": { + "type": "string" + }, + "meetings": { + "type": "array", + "items": { + "type": "object", + "properties": { + "id": { + "type": "string" + }, + "state": { + "type": "string", + "description": "The state the meeting was in" + }, + "upstream_error": { + "type": "string", + "description": "Set when Vexa (Quorum meeting.delete) could not confirm the erase; the record on this hive is removed anyway" + }, + "calendar_removed": { + "type": "integer", + "description": "Calendar entries removed because they existed only for this meeting" + } + } + } + } + } + } + } + } + }, + "403": { + "description": "Owner access required" + }, + "404": { + "description": "Unknown event" + }, + "409": { + "description": "The entry is still to come or live, or hive is still in its meeting" + }, + "503": { + "description": "Meetings are not enabled on this hive" + } + } + } + }, "/api/meetings/{id}/decline": { "post": { "tags": [ @@ -438,6 +584,64 @@ } }, "/api/meetings/{id}": { + "delete": { + "tags": [ + "Meetings" + ], + "summary": "Delete a finished meeting or a pending join request", + "description": "Owner only. Allowed for a meeting in a final state (ended, failed, blocked, declined, left, handed_off, purged) and for a pending platform join request (declined with meeting.leave, then removed). Removes the meeting record, its transcript and live state on this hive, erases it in Vexa with Quorum meeting.delete (best effort: not_found is fine, any other error is returned as upstream_error while the record is still removed) and removes the Calendar entry that existed only for this meeting. Knowledge facts and drafts already made from the meeting are not touched. Audited as meeting_delete.", + "parameters": [ + { + "name": "id", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Deleted", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "id": { + "type": "string" + }, + "state": { + "type": "string", + "description": "The state the meeting was in" + }, + "upstream_error": { + "type": "string", + "description": "Set when Vexa (Quorum meeting.delete) could not confirm the erase; the record on this hive is removed anyway" + }, + "calendar_removed": { + "type": "integer", + "description": "Calendar entries removed because they existed only for this meeting" + } + } + } + } + } + }, + "403": { + "description": "Owner access required" + }, + "404": { + "description": "Unknown meeting" + }, + "409": { + "description": "Hive is still joining, in the lobby of or live in the meeting: leave the meeting first" + }, + "503": { + "description": "Meetings are not enabled on this hive" + } + } + }, "get": { "tags": [ "Meetings" diff --git a/dashboard/test/meetings-calendar-role-race.test.js b/dashboard/test/meetings-calendar-role-race.test.js index b2caab7f22..eb7c174fc4 100644 --- a/dashboard/test/meetings-calendar-role-race.test.js +++ b/dashboard/test/meetings-calendar-role-race.test.js @@ -36,11 +36,12 @@ function extractConst(name) { const GH_AUTH = ['hiveRoleSettled']; const MEETINGS = ['meetingsIsOwner', 'meetingsRoleKnown', 'meetingsOnRoleReady', 'fetchMeetings', 'renderMeetings', 'meetingsJoinFormHtml', - 'meetingsRowHtml', 'meetingsFormatTime', 'meetingsFriendlyReason', 'meetingsReasonHtml', 'meetingsLabel']; + 'meetingsRowHtml', 'meetingsFormatTime', 'meetingsFriendlyReason', 'meetingsReasonHtml', 'meetingsLabel', + 'meetingsFinished', 'meetingsCanDelete', 'meetingsDeleteButtonHtml']; const CALENDAR = ['calendarRoleKnown', 'calendarOnRoleReady', 'calendarCanView', 'calendarIsOwner', 'fetchCalendar', 'calendarRefreshMeetings', 'fetchMeetingDrafts', 'renderCalendar', 'renderMeetingDrafts', 'meetingDraftsSplit', 'calendarFormHtml', 'calendarViewerTimeZone', 'calendarRowHtml', 'calendarFormatTime', 'calendarPlatformLabel', 'calendarMeetingLink', 'calendarActionButtons', 'renderCalendarIndicator', - 'calendarIndicatorState', 'calendarBadgeCount', 'calendarMeetingList']; + 'calendarIndicatorState', 'calendarBadgeCount', 'calendarMeetingList', 'calendarCanDelete']; function makeSandbox(opts) { const els = {}; @@ -73,7 +74,7 @@ function makeSandbox(opts) { vm.createContext(sb); const consts = ['MEETINGS_ERROR_INLINE_CHARS', 'MEETINGS_PLATFORM_LABELS', 'MEETINGS_PILL_STATUS', 'MEETINGS_LIVE_STATES', 'CALENDAR_ACTIVE_STATES', 'CALENDAR_DEFAULT_NAME', 'CALENDAR_PLATFORM_LABELS', 'CALENDAR_PLATFORM_ICONS', 'CALENDAR_SOURCE_LABELS', - 'CALENDAR_STATUS_LABELS', 'CALENDAR_PILL_STATUS'].map(extractConst); + 'CALENDAR_STATUS_LABELS', 'CALENDAR_PILL_STATUS', 'MEETINGS_FINAL_STATES', 'CALENDAR_FINISHED_STATUSES'].map(extractConst); // const declarations stay script-scoped in a vm context; re-declare the // mutable module state with var so the extracted functions share it. vm.runInContext(consts.join('\n') + '\n' + GH_AUTH.concat(MEETINGS, CALENDAR).map(extractFunction).join('\n'), sb); diff --git a/src/cmd/hive/main.go b/src/cmd/hive/main.go index c630962fde..883b6958a1 100644 --- a/src/cmd/hive/main.go +++ b/src/cmd/hive/main.go @@ -3598,12 +3598,15 @@ func (b *boot) bootDashboardAPIWith(deps bootDashboardAPIDeps) { // Drafts people ask Betty for, approved in the dashboard (#18406). b.wireMeetingsActions(store) // Owner API, live panel and /api/events frames (#18292). - b.dashSrv.SetMeetingsService(&meetingsDashboard{mgr: mgr, live: b.meetingsLive}) - // Scheduled meetings and the Calendar section (#18394). + md := &meetingsDashboard{mgr: mgr, live: b.meetingsLive} + // Scheduled meetings and the Calendar section (#18394). Wired + // first so a deleted meeting's Calendar entry goes with it. if svc, stop := wireMeetingsSchedule(b.cfg, mgr, b.logger); svc != nil { b.cleanup.push(stop) b.dashSrv.SetMeetingsScheduleService(svc) + md.sched = svc.sched } + b.dashSrv.SetMeetingsService(md) // Ended meetings become inbox items; transcripts are purged // after meetings.retention_days (#18293). b.wireMeetingsInbox(mgr, store) diff --git a/src/cmd/hive/meetings_dashboard.go b/src/cmd/hive/meetings_dashboard.go index 8bc8aeb0d6..299ffb0cf2 100644 --- a/src/cmd/hive/meetings_dashboard.go +++ b/src/cmd/hive/meetings_dashboard.go @@ -4,10 +4,12 @@ import ( "context" "errors" "fmt" + "time" "github.com/hivecommons/hive/pkg/dashboard" "github.com/hivecommons/hive/pkg/meetings" "github.com/hivecommons/hive/pkg/meetings/live" + "github.com/hivecommons/hive/pkg/meetings/schedule" ) // meetingsDashboard implements dashboard.MeetingsService over the meeting @@ -16,6 +18,8 @@ import ( type meetingsDashboard struct { mgr *meetings.Manager live *live.Runner + // sched, when the Calendar runs, forgets a deleted meeting's entry. + sched *schedule.Scheduler } // meetingsDashboardError maps meetings errors onto the dashboard's @@ -28,7 +32,8 @@ func meetingsDashboardError(err error) error { return fmt.Errorf("%w: %v", dashboard.ErrMeetingNotFound, err) case errors.Is(err, meetings.ErrInvalidRequest), meetings.IsCode(err, meetings.CodeInvalidArgument): return fmt.Errorf("%w: %v", dashboard.ErrMeetingInvalid, err) - case errors.Is(err, live.ErrNotPending), errors.Is(err, live.ErrSessionEnded), errors.Is(err, meetings.ErrNotLive), errors.Is(err, meetings.ErrNotRequested): + case errors.Is(err, live.ErrNotPending), errors.Is(err, live.ErrSessionEnded), errors.Is(err, meetings.ErrNotLive), errors.Is(err, meetings.ErrNotRequested), + errors.Is(err, meetings.ErrStillRunning): return fmt.Errorf("%w: %v", dashboard.ErrMeetingConflict, err) default: return err @@ -101,6 +106,33 @@ func (d *meetingsDashboard) DeclineRequest(ctx context.Context, id string) (any, return m, nil } +// meetingDeleted is the dashboard's view of a deleted meeting; with the +// Calendar running, the entry that existed only for it goes too. +func meetingDeleted(res meetings.DeleteResult, sched *schedule.Scheduler) dashboard.MeetingDeleted { + out := dashboard.MeetingDeleted{ID: res.Meeting.ID, State: string(res.Meeting.State), UpstreamError: res.UpstreamError} + if sched != nil { + out.CalendarRemoved = sched.ForgetMeeting(res.Meeting.ID) + } + return out +} + +func (d *meetingsDashboard) Delete(ctx context.Context, id string) (dashboard.MeetingDeleted, error) { + res, err := d.mgr.Delete(ctx, id) + if err != nil { + return dashboard.MeetingDeleted{}, meetingsDashboardError(err) + } + return meetingDeleted(res, d.sched), nil +} + +func (d *meetingsDashboard) ClearFinished(ctx context.Context, before time.Time) ([]dashboard.MeetingDeleted, error) { + list, err := d.mgr.ClearFinished(ctx, before) + out := make([]dashboard.MeetingDeleted, 0, len(list)) + for _, res := range list { + out = append(out, meetingDeleted(res, d.sched)) + } + return out, meetingsDashboardError(err) +} + // meetingLive is the panel snapshot. type meetingLive struct { Meeting meetings.Meeting `json:"meeting"` diff --git a/src/cmd/hive/meetings_delete_test.go b/src/cmd/hive/meetings_delete_test.go new file mode 100644 index 0000000000..76d7ef7edb --- /dev/null +++ b/src/cmd/hive/meetings_delete_test.go @@ -0,0 +1,102 @@ +package main + +import ( + "context" + "encoding/json" + "errors" + "os" + "path/filepath" + "testing" + "time" + + "github.com/hivecommons/hive/pkg/config" + "github.com/hivecommons/hive/pkg/dashboard" + "github.com/hivecommons/hive/pkg/meetings" + "github.com/hivecommons/hive/pkg/meetings/schedule" +) + +// TestMeetingsDeleteAdapters: deleting a meeting drops the Calendar entry +// that existed only for it; deleting a past Calendar entry deletes its +// meeting; live meetings and entries still to come answer 409. +func TestMeetingsDeleteAdapters(t *testing.T) { + dir := t.TempDir() + store, err := meetings.NewStore(dir) + if err != nil { + t.Fatal(err) + } + now := time.Now().UTC().Truncate(time.Second) + past := now.Add(-2 * time.Hour) + for _, m := range []meetings.Meeting{ + {ID: "mtg-ended", NativeID: "q-e", State: meetings.StateEnded, EndedAt: &past, CreatedAt: past}, + {ID: "mtg-cal", NativeID: "q-c", State: meetings.StateFailed, EndedAt: &past, CreatedAt: past}, + {ID: "mtg-live", NativeID: "q-l", State: meetings.StateLive, CreatedAt: past}, + } { + if err := store.Save(m); err != nil { + t.Fatal(err) + } + } + ev := func(uid string, st schedule.Status, start time.Time, mid string) schedule.Event { + e := schedule.Event{UID: uid, Start: start, Status: st, Platform: schedule.PlatformGoogleMeet, + JoinURL: "https://meet.google.com/abc", Source: schedule.SourceManual, MeetingID: mid, CreatedAt: past, UpdatedAt: now} + if mid != "" { + e.History = []schedule.Occurrence{{Start: start, MeetingID: mid, Status: st}} + } + e.ID = schedule.EventID(uid, nil) + return e + } + ended := ev("u-ended", schedule.StatusEnded, past, "mtg-ended") + failed := ev("u-cal", schedule.StatusFailed, past, "mtg-cal") + future := ev("u-future", schedule.StatusScheduled, now.Add(24*time.Hour), "") + data, err := json.Marshal(map[string]any{"version": 1, "events": []schedule.Event{ended, failed, future}}) + if err != nil { + t.Fatal(err) + } + if err := os.WriteFile(filepath.Join(dir, schedule.FileName), data, 0o600); err != nil { + t.Fatal(err) + } + mgr, err := meetings.NewManager(meetings.Options{Store: store, Quorum: &stubQuorum{events: make(chan meetings.Event, 1)}}) + if err != nil { + t.Fatal(err) + } + defer mgr.Close() + cfg := &config.Config{} + cfg.Meetings.DataDir = dir + svc, stop := wireMeetingsSchedule(cfg, mgr, nil) + if svc == nil { + t.Fatal("schedule not wired") + } + defer stop() + md := &meetingsDashboard{mgr: mgr, sched: svc.sched} + ctx := context.Background() + + if _, err := md.Delete(ctx, "mtg-live"); !errors.Is(err, dashboard.ErrMeetingConflict) { + t.Fatalf("delete live = %v, want conflict", err) + } + if _, err := md.Delete(ctx, "mtg-none"); !errors.Is(err, dashboard.ErrMeetingNotFound) { + t.Fatalf("delete unknown = %v, want not found", err) + } + d, err := md.Delete(ctx, "mtg-ended") + if err != nil || d.ID != "mtg-ended" || d.State != "ended" || d.CalendarRemoved != 1 { + t.Fatalf("delete ended = %+v, %v", d, err) + } + if _, err := svc.sched.Get(ended.ID); !errors.Is(err, schedule.ErrNotFound) { + t.Fatalf("calendar entry kept: %v", err) + } + + if _, err := svc.Delete(ctx, future.ID); !errors.Is(err, dashboard.ErrMeetingConflict) { + t.Fatalf("delete future entry = %v, want conflict", err) + } + cd, err := svc.Delete(ctx, failed.ID) + if err != nil || len(cd.Meetings) != 1 || cd.Meetings[0].ID != "mtg-cal" { + t.Fatalf("delete past entry = %+v, %v", cd, err) + } + if _, err := mgr.Get("mtg-cal"); !errors.Is(err, meetings.ErrNotFound) { + t.Fatalf("entry's meeting kept: %v", err) + } + if _, err := svc.sched.Get(future.ID); err != nil { + t.Fatalf("future entry touched: %v", err) + } + if _, err := mgr.Get("mtg-live"); err != nil { + t.Fatalf("live meeting touched: %v", err) + } +} diff --git a/src/cmd/hive/meetings_schedule.go b/src/cmd/hive/meetings_schedule.go index 06d2143aef..a7da1ae4c8 100644 --- a/src/cmd/hive/meetings_schedule.go +++ b/src/cmd/hive/meetings_schedule.go @@ -31,6 +31,8 @@ const ( // meeting scheduler (hivecommons/hive#18394). type meetingsSchedule struct { sched *schedule.Scheduler + // mgr deletes the meetings a deleted Calendar entry created. + mgr *meetings.Manager // attendee is the name the dashboard's "in a meeting" indicator uses. attendee string now func() time.Time @@ -129,6 +131,53 @@ func (d *meetingsSchedule) Act(_ context.Context, eid, action, by string) (any, return ev.Redacted(), nil } +// Delete removes a finished Calendar entry and the meetings it created. +// An entry still to come or live answers 409 (skip or cancel it); so does +// one whose meeting hive is still in. Meetings already gone are skipped. +func (d *meetingsSchedule) Delete(ctx context.Context, eid string) (dashboard.MeetingScheduleDeleted, error) { + out := dashboard.MeetingScheduleDeleted{ID: eid, Meetings: []dashboard.MeetingDeleted{}} + e, err := d.sched.Get(eid) + if err != nil { + return out, meetingsScheduleError(err) + } + if !e.Status.Terminal() { + return out, fmt.Errorf("%w: this meeting is %s; skip or cancel it instead", dashboard.ErrMeetingConflict, e.Status) + } + ids := schedule.LinkedMeetings(e) + if d.mgr != nil { + for _, id := range ids { + m, err := d.mgr.Get(id) + if errors.Is(err, meetings.ErrNotFound) { + continue + } + if err != nil { + return out, err + } + if !meetings.Deletable(m) { + return out, fmt.Errorf("%w: hive is still in this meeting; leave the meeting first", dashboard.ErrMeetingConflict) + } + } + } + if _, err := d.sched.Delete(eid); err != nil { + return out, meetingsScheduleError(err) + } + if d.mgr == nil { + return out, nil + } + for _, id := range ids { + res, err := d.mgr.Delete(ctx, id) + if errors.Is(err, meetings.ErrNotFound) { + continue + } + if err != nil { + out.Meetings = append(out.Meetings, dashboard.MeetingDeleted{ID: id, UpstreamError: err.Error()}) + continue + } + out.Meetings = append(out.Meetings, meetingDeleted(res, nil)) + } + return out, nil +} + // wireMeetingsSchedule starts the meeting scheduler over the manager // (hivecommons/hive#18394): schedule.json in the meetings data directory, // joins HIVE_MEETINGS_SCHEDULE_LEAD_S before start, scans every @@ -186,5 +235,5 @@ func wireMeetingsSchedule(cfg *config.Config, mgr *meetings.Manager, logger *slo <-done sched.Close() } - return &meetingsSchedule{sched: sched, attendee: attendeeName(cfg.Meetings.BotNameOrDefault()), now: time.Now}, stop + return &meetingsSchedule{sched: sched, mgr: mgr, attendee: attendeeName(cfg.Meetings.BotNameOrDefault()), now: time.Now}, stop } diff --git a/src/docs/api-reference/knowledge.md b/src/docs/api-reference/knowledge.md index 2119c50317..8d7eab9006 100644 --- a/src/docs/api-reference/knowledge.md +++ b/src/docs/api-reference/knowledge.md @@ -89,23 +89,26 @@ Part of the [Dashboard REST API reference](../api-reference.md); see that page f | `DELETE` | `/api/inbox/recordings/{id}` | The recorder, or an owner | Abort an in-progress recording and delete its chunks; audited as `inbox_recording_abort` (403, 404, 409 already ended) | `pkg/dashboard/api_inbox_recordings.go:23` | | `GET` | `/api/inbox/recordings/{id}/audio` | Owner or read-write | Play a finished recording from this hive's disk on the dashboard origin: `http.ServeContent` (Range, 206), `Content-Type` audio/webm or audio/mp4, `Cache-Control: no-store`, `Cross-Origin-Resource-Policy: same-origin`. Opening a playback is audited as `inbox_recording_audio` (seeks are not). `GET /api/inbox/hive-recording/{id}/audio/stream` serves the same file (404 unknown or not finished, 410 audio expired after `inbox.recording.retention_days`) | `pkg/dashboard/api_inbox_recordings.go:24` | | `DELETE` | `/api/inbox/hive-recording/{id}` | An owner, or the read-write member who recorded it | Delete a finished recording for good: its stored audio and chunks, the Inbox item and its state, and its Knowledge fact with the machine transcript. What was already shared from it (RFC, issues, DIBS ideas, spek seeds) is not touched. 200 `{id, deleted, fact_removed, shares_kept}`; audited as `inbox_recording_delete` (403 read role or someone else's recording, 404 unknown, 409 still in progress or being transcribed) | `pkg/dashboard/api_inbox_recordings.go:25` | -| `GET` | `/api/meetings/settings` | Owner only | Meetings settings: `enabled`, `enabled_env_override`, `running`, `vexa_url`, `vexa_key_set`, `discord_token_set`, `transcribe_token_set`, `tts_token_set` (secrets are never returned) and `effective` values of the other `meetings.*` keys ([env vars](../env-vars.md#meetings-quorum)) | `pkg/dashboard/api_meetings.go:124` | -| `POST` | `/api/meetings/settings` | Owner only | Update `meetings.enabled` and `meetings.vexa.url`, and write the Vexa tenant key, Discord bot token, transcription service token and TTS service token to keystore-sealed secret files (`""` clears one): `{enabled?, vexa_url?, vexa_api_key?, discord_token?, transcribe_token?, tts_token?}`. Returns the settings with `restart_required`; 400 on an invalid value. Audited as `meetings_settings` | `pkg/dashboard/api_meetings.go:125` | -| `POST` | `/api/meetings` | Owner only | Send hive to a meeting: `{url}` for Google Meet, Teams or Zoom, or `{platform: "discord", guild_id, channel_id}`, plus `title?` and `voice?`. Returns the meeting record; 400 invalid request, 502 Quorum refused, 503 meetings off. Audited as `meeting_join` | `pkg/dashboard/api_meetings.go:126` | -| `GET` | `/api/meetings` | Owner only | `{meetings: [...]}`, newest first | `pkg/dashboard/api_meetings.go:127` | -| `GET` | `/api/meetings/{id}` | Owner only | `{meeting, transcript, live}`: the record, stored final segments and chat, and the live-loop state (notes, research, asks, budget); 404 unknown | `pkg/dashboard/api_meetings.go:128` | -| `POST` | `/api/meetings/{id}/leave` | Owner only | Make hive leave; returns the record. Audited as `meeting_leave` | `pkg/dashboard/api_meetings.go:129` | -| `POST` | `/api/meetings/{id}/voice` | Owner only | `{enabled}`: allow hive to answer aloud when addressed (with `meetings.voice_on_address`). Audited as `meeting_voice` | `pkg/dashboard/api_meetings.go:130` | -| `POST` | `/api/meetings/{id}/research/{rid}/approve` | Owner only | Dispatch a research item waiting past the per-meeting cap; 409 when it is not waiting or the live session ended. Audited as `meeting_research_approve` | `pkg/dashboard/api_meetings.go:131` | -| `POST` | `/api/meetings/{id}/approve` | Owner only | Approve a platform join request (Discord `/hive join`): joins that channel; optional `{voice}`. 409 when the meeting is not a pending request. Audited as `meeting_request_approve` | `pkg/dashboard/api_meetings.go:132` | -| `POST` | `/api/meetings/{id}/decline` | Owner only | Decline a platform join request with `meeting.leave`. Audited as `meeting_request_decline` | `pkg/dashboard/api_meetings.go:133` | -| `GET` | `/api/meetings/{id}/ws` | Owner only | WebSocket live panel: a `snapshot` frame, then `meeting`, `line`, `intent`, `research`, `notes` and `dropped` frames for the meeting | `pkg/dashboard/api_meetings.go:134` | -| `GET` | `/api/meetings/schedule` | Owner or read-write | The Calendar: `{upcoming, recent, attendee_name}`; upcoming events (scheduled, awaiting approval, live) by start and events finished in the last 14 days, newest first. Each event carries its platform, source, status, next occurrences and the meeting it created; a passcode is shown only as `set`. See [Calendar](../meetings.md#calendar) | `pkg/dashboard/api_meetings_schedule.go:83` | -| `POST` | `/api/meetings/schedule` | Owner or read-write | Schedule a meeting: `{url, start, end?, title?, rrule?, timezone?}` (RFC 3339 times, RFC 5545 `RRULE` expanded in an IANA `timezone`). The platform comes from the link (Google Meet, Teams, Zoom). The owner's add is scheduled; a read-write user's add awaits approval. 400 invalid or already ended. Audited as `meeting_schedule_add` | `pkg/dashboard/api_meetings_schedule.go:84` | -| `POST` | `/api/meetings/schedule/{eid}/approve` | Owner only | Schedule an event awaiting approval. 409 when it is not awaiting approval. Audited as `meeting_schedule_approve` | `pkg/dashboard/api_meetings_schedule.go:85` | -| `POST` | `/api/meetings/schedule/{eid}/decline` | Owner only | Decline an event awaiting approval; later updates of the same invite stay declined. Audited as `meeting_schedule_decline` | `pkg/dashboard/api_meetings_schedule.go:86` | -| `POST` | `/api/meetings/schedule/{eid}/cancel` | Owner only | Stop hive joining the event (every occurrence of a series); a meeting already live is not left. Audited as `meeting_schedule_cancel` | `pkg/dashboard/api_meetings_schedule.go:87` | -| `POST` | `/api/meetings/schedule/{eid}/skip` | Owner only | Skip the next occurrence hive has not joined: a single meeting becomes `skipped`, a series moves on. Audited as `meeting_schedule_skip` | `pkg/dashboard/api_meetings_schedule.go:88` | +| `GET` | `/api/meetings/settings` | Owner only | Meetings settings: `enabled`, `enabled_env_override`, `running`, `vexa_url`, `vexa_key_set`, `discord_token_set`, `transcribe_token_set`, `tts_token_set` (secrets are never returned) and `effective` values of the other `meetings.*` keys ([env vars](../env-vars.md#meetings-quorum)) | `pkg/dashboard/api_meetings.go:129` | +| `POST` | `/api/meetings/settings` | Owner only | Update `meetings.enabled` and `meetings.vexa.url`, and write the Vexa tenant key, Discord bot token, transcription service token and TTS service token to keystore-sealed secret files (`""` clears one): `{enabled?, vexa_url?, vexa_api_key?, discord_token?, transcribe_token?, tts_token?}`. Returns the settings with `restart_required`; 400 on an invalid value. Audited as `meetings_settings` | `pkg/dashboard/api_meetings.go:130` | +| `POST` | `/api/meetings` | Owner only | Send hive to a meeting: `{url}` for Google Meet, Teams or Zoom, or `{platform: "discord", guild_id, channel_id}`, plus `title?` and `voice?`. Returns the meeting record; 400 invalid request, 502 Quorum refused, 503 meetings off. Audited as `meeting_join` | `pkg/dashboard/api_meetings.go:131` | +| `GET` | `/api/meetings` | Owner only | `{meetings: [...]}`, newest first | `pkg/dashboard/api_meetings.go:132` | +| `GET` | `/api/meetings/{id}` | Owner only | `{meeting, transcript, live}`: the record, stored final segments and chat, and the live-loop state (notes, research, asks, budget); 404 unknown | `pkg/dashboard/api_meetings.go:133` | +| `POST` | `/api/meetings/{id}/leave` | Owner only | Make hive leave; returns the record. Audited as `meeting_leave` | `pkg/dashboard/api_meetings.go:134` | +| `POST` | `/api/meetings/{id}/voice` | Owner only | `{enabled}`: allow hive to answer aloud when addressed (with `meetings.voice_on_address`). Audited as `meeting_voice` | `pkg/dashboard/api_meetings.go:135` | +| `POST` | `/api/meetings/{id}/research/{rid}/approve` | Owner only | Dispatch a research item waiting past the per-meeting cap; 409 when it is not waiting or the live session ended. Audited as `meeting_research_approve` | `pkg/dashboard/api_meetings.go:136` | +| `POST` | `/api/meetings/{id}/approve` | Owner only | Approve a platform join request (Discord `/hive join`): joins that channel; optional `{voice}`. 409 when the meeting is not a pending request. Audited as `meeting_request_approve` | `pkg/dashboard/api_meetings.go:137` | +| `POST` | `/api/meetings/{id}/decline` | Owner only | Decline a platform join request with `meeting.leave`. Audited as `meeting_request_decline` | `pkg/dashboard/api_meetings.go:138` | +| `DELETE` | `/api/meetings/{id}` | Owner only | Delete a meeting in a final state (ended, failed, blocked, declined, left, handed off, purged) or a pending join request (declined with `meeting.leave`, then removed): the record, transcript and live state on this hive, the meeting in Vexa (Quorum `meeting.delete`, best effort: `not_found` is fine, any other error comes back as `upstream_error` while the record is still removed), and the Calendar entry that existed only for it. Knowledge facts and drafts made from it are not touched. 200 `{id, state, upstream_error?, calendar_removed?}`; 404 unknown; 409 while hive is joining, in the lobby or live (leave the meeting first). Audited as `meeting_delete` | `pkg/dashboard/api_meetings_delete.go:44` | +| `POST` | `/api/meetings/clear-finished` | Owner only | Delete every meeting in a final state that finished before `{before?}` (RFC 3339; empty or later than now means now), each as `DELETE /api/meetings/{id}`; live meetings and pending join requests stay. 200 `{deleted, count}`; 400 bad `before`. Each meeting audited as `meeting_delete` | `pkg/dashboard/api_meetings_delete.go:45` | +| `GET` | `/api/meetings/{id}/ws` | Owner only | WebSocket live panel: a `snapshot` frame, then `meeting`, `line`, `intent`, `research`, `notes` and `dropped` frames for the meeting | `pkg/dashboard/api_meetings.go:139` | +| `GET` | `/api/meetings/schedule` | Owner or read-write | The Calendar: `{upcoming, recent, attendee_name}`; upcoming events (scheduled, awaiting approval, live) by start and events finished in the last 14 days, newest first. Each event carries its platform, source, status, next occurrences and the meeting it created; a passcode is shown only as `set`. See [Calendar](../meetings.md#calendar) | `pkg/dashboard/api_meetings_schedule.go:86` | +| `POST` | `/api/meetings/schedule` | Owner or read-write | Schedule a meeting: `{url, start, end?, title?, rrule?, timezone?}` (RFC 3339 times, RFC 5545 `RRULE` expanded in an IANA `timezone`). The platform comes from the link (Google Meet, Teams, Zoom). The owner's add is scheduled; a read-write user's add awaits approval. 400 invalid or already ended. Audited as `meeting_schedule_add` | `pkg/dashboard/api_meetings_schedule.go:87` | +| `POST` | `/api/meetings/schedule/{eid}/approve` | Owner only | Schedule an event awaiting approval. 409 when it is not awaiting approval. Audited as `meeting_schedule_approve` | `pkg/dashboard/api_meetings_schedule.go:88` | +| `POST` | `/api/meetings/schedule/{eid}/decline` | Owner only | Decline an event awaiting approval; later updates of the same invite stay declined. Audited as `meeting_schedule_decline` | `pkg/dashboard/api_meetings_schedule.go:89` | +| `POST` | `/api/meetings/schedule/{eid}/cancel` | Owner only | Stop hive joining the event (every occurrence of a series); a meeting already live is not left. Audited as `meeting_schedule_cancel` | `pkg/dashboard/api_meetings_schedule.go:90` | +| `POST` | `/api/meetings/schedule/{eid}/skip` | Owner only | Skip the next occurrence hive has not joined: a single meeting becomes `skipped`, a series moves on. Audited as `meeting_schedule_skip` | `pkg/dashboard/api_meetings_schedule.go:91` | +| `DELETE` | `/api/meetings/schedule/{eid}` | Owner only | Delete a past Calendar entry (ended, cancelled, declined, failed, blocked, skipped) and the meetings it created, each as `DELETE /api/meetings/{id}`. 200 `{id, meetings}`; 404 unknown; 409 for an entry still scheduled, awaiting approval or live (skip or cancel it) or whose meeting hive is still in. Audited as `meeting_schedule_delete`, plus `meeting_delete` per meeting | `pkg/dashboard/api_meetings_delete.go:46` | | `GET` | `/api/meetings/actions` | Owner or read-write | Drafts from meetings: `{drafts, pending}`, newest first. Each draft carries `id`, `meeting_id`, `meeting_title`, `meeting_link`, `type` (`issue`, `rfc`, `spek`, `knowledge`), `title`, `body`, `repo`, `excerpt`, `requested_by` (a meeting display name), `request`, `spoken`, `status` (`pending`, `approving`, `done`, `failed`, `rejected`), `auto_approved`, `result_url`, `result_note`, `error`, `announced` (`chat` or `notes`), `edited_by`, `decided_by`, `decided_at`, `created_at`, `updated_at`. See [Asking Betty to do things](../meetings.md#asking-betty-to-do-things) | `pkg/dashboard/api_meetings_actions.go:69` | | `GET` | `/api/meetings/actions/settings` | Owner or read-write | `meetings.persona.actions` as set and in effect: `enabled`, `types`, `all_types`, `default_repo`, `effective_default_repo`, `repos` (the monitored repos a draft may target), `auto_approve` (per type), `auto_approvable` (`knowledge`) and `env_overrides` | `pkg/dashboard/api_meetings_actions.go:70` | | `PUT` | `/api/meetings/actions/settings` | Owner only | Save `{enabled?, types?, default_repo?, auto_approve?}` into `meetings.persona.actions`; applies at once. 400 for an unknown type, a repo that is not `owner/repo`, or auto-approve on anything but `knowledge`. Audited as `meetings_actions_settings` | `pkg/dashboard/api_meetings_actions.go:71` | @@ -119,7 +122,7 @@ Part of the [Dashboard REST API reference](../api-reference.md); see that page f | `POST` | `/api/meetings/persona/sample` | Owner or read-write | Speak a short line through the meetings TTS service (Kokoro `POST /v1/audio/speech`) and return the audio (`audio/mpeg`, at most 2 MiB, `Cache-Control: no-store`). Optional `{voice?, language?, display_name?, text?}` (unsaved form values; `text` at most 200 characters, default the persona's sample line in its language). 503 "TTS not configured" until `meetings.tts_url` is set, 400 invalid, 502 the TTS service failed | `pkg/dashboard/api_meetings_persona.go:166` | | `GET` | `/api/meetings/persona/sample` | Owner or read-write | The same sample with `voice`, `language`, `display_name` and `text` as query parameters, for the dashboard's `