95 lines
4.5 KiB
Markdown
95 lines
4.5 KiB
Markdown
# HANDOFF.md
|
|
|
|
## Purpose
|
|
Immediate baton-pass for the next fresh implementation session.
|
|
|
|
## Current objective
|
|
The Gmail + Calendar n8n action-bus WIP is complete and live. Next fresh session should review `WIP.drive-docs-sheets.md` and decide whether Drive / Docs / Sheets need action-bus verbs at all, while preserving the approval/history contract that now exists for Gmail + Calendar.
|
|
|
|
## Use these state files first
|
|
1. `WIP.md` — completed Google Workspace + n8n implementation record
|
|
2. `WIP.drive-docs-sheets.md` — proposed next-phase decision WIP
|
|
3. `memory/2026-03-12.md` — detailed execution history and evidence
|
|
4. `memory/tasks.json` — task status tracking
|
|
|
|
## What is already true
|
|
- `openclaw-action` is live in n8n and active.
|
|
- Google auth via `gog` is working headlessly through local env auto-load.
|
|
- Local automation env lives in `/home/openclaw/.openclaw/credentials/gog.env` and stays out of git.
|
|
- Host bridge exists at `skills/n8n-webhook/scripts/resolve-approval-with-gog.py`.
|
|
- Real approval-routed Gmail draft and Calendar event flows have both been verified multiple times end-to-end with cleanup.
|
|
|
|
## Fresh-session proof completed (2026-03-12 19:44Z)
|
|
- Gmail draft flow (`send_email_draft`):
|
|
- approval id: `approval-mmnvn4t2-w2rjlwz2`
|
|
- draft id: `r-3319106208870238577`
|
|
- subject: `[zap n8n e2e] Gmail draft test 20260312T194450Z`
|
|
- verified via `gog gmail drafts get`
|
|
- cleaned via `gog gmail drafts delete --force`
|
|
- Calendar event flow (`create_calendar_event`):
|
|
- approval id: `approval-mmnvn6i8-e9eq8gdf`
|
|
- event id: `m7prri8vk2opuo6loq3qgtvsv4`
|
|
- title: `[zap n8n e2e] Calendar test 20260312T194450Z`
|
|
- verified via `gog calendar get primary <eventId>`
|
|
- cleaned via `gog calendar delete primary <eventId> --force`
|
|
|
|
## Gmail pass 1 completed in this handoff cycle
|
|
- Added workflow actions:
|
|
- `list_email_drafts`
|
|
- `delete_email_draft`
|
|
- `send_gmail_draft` (alias: `send_approved_email`)
|
|
- Added host bridge executors:
|
|
- `email_list_drafts` (`gog gmail drafts list`)
|
|
- `email_draft_delete` (`gog gmail drafts delete`)
|
|
- `email_draft_send` (`gog gmail drafts send`)
|
|
- Added explicit approval metadata in workflow responses (`approval.policy`, `approval.required`, `approval.mutation_level`).
|
|
- Updated docs/test payloads/validator to match the expanded Gmail contract.
|
|
|
|
## Calendar pass 2 completed in this handoff cycle
|
|
- Added workflow actions:
|
|
- `list_upcoming_events`
|
|
- `update_calendar_event`
|
|
- `delete_calendar_event`
|
|
- Added host bridge executors:
|
|
- `calendar_list_events` (`gog calendar events`)
|
|
- `calendar_event_update` (`gog calendar update`)
|
|
- `calendar_event_delete` (`gog calendar delete`)
|
|
- Preserved explicit approval policy:
|
|
- read-only calendar listing stays `low`
|
|
- mutating calendar update/delete stay `high`
|
|
- Added docs/test payloads/validator coverage for the expanded calendar contract.
|
|
|
|
## Highest-priority next actions
|
|
1. Review `WIP.drive-docs-sheets.md` and make a go / no-go call per surface: Drive, Docs, Sheets.
|
|
2. If any new Google actions are added, keep approval defaults explicit by family (`notification`, `gmail`, `calendar`, `manual`, and any new family names).
|
|
3. Preserve compact operator reporting (`pending_compact`, `history_compact`, `summary_line`, `result_refs`) for any new approval-backed actions.
|
|
4. Keep the live deployment habit: after implementation, sync the live workflow and run a safe smoke test instead of trusting static validation alone.
|
|
|
|
## Success criteria for the next session
|
|
- Clear go/no-go decision on expanding beyond Gmail + Calendar.
|
|
- Any new verbs inherit the same safe approval defaults and low-noise history contract.
|
|
- `WIP.md` and memory updated with concrete evidence.
|
|
- Meaningful commit(s) captured.
|
|
|
|
## Relevant files
|
|
- `WIP.md`
|
|
- `HANDOFF.md`
|
|
- `skills/n8n-webhook/assets/openclaw-action.workflow.json`
|
|
- `skills/n8n-webhook/scripts/call-action.sh`
|
|
- `skills/n8n-webhook/scripts/resolve-approval-with-gog.py`
|
|
- `skills/n8n-webhook/references/openclaw-action.md`
|
|
- `memory/2026-03-12.md`
|
|
- `memory/tasks.json`
|
|
- `/home/openclaw/.openclaw/credentials/gog.env` (local-only)
|
|
|
|
## Relevant branch / commits
|
|
- branch: `feat/n8n-action-bus-v2`
|
|
- latest checkpoints before this handoff include:
|
|
- `ffe7a6b` — add operator approval runbook
|
|
- `249e671` — add compact approval history views
|
|
- `afa48a3` — bridge approvals to gog executors
|
|
- `044e36f` — auto-load local gog automation env
|
|
- `06fa582` — track google workspace and n8n plan
|
|
|
|
## Operator note
|
|
Use the live n8n public API/webhook surface directly when it is the right path. Do not act blocked on n8n API access. |