mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-11-19 07:42:38 +01:00
docs(connections): record the staging tester's move to the separate Google app (#22187)
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work > - The built-in Google Workspace connector is going through Google approval > - `doc/memory/google-connector-memory.md` holds the decisions and environment state for that work > - The staging tester now uses the separate Google app, but the doc still says it does not > - This pull request records the switch, what was verified after it, and what is still to confirm > - The benefit is that the next session starts from the true state and does not break staging deploys ## Linked Issues or Issue Description Docs are out of date after the tester moved to the separate Google app. Refs #22179. ## What Changed - `doc/memory/google-connector-memory.md`: the tester is on the separate Google app; what was verified; the consent-screen check that remains; the deploy-order warning. - `doc/plans/2026-11-17-google-workspace-production-checklist.md`: ticked "wired to the new Google app". ## Verification - Docs only. No code or tests changed. - Checked that the diff has no client ids, project ids, stack ids, passwords, or keys. ## Risks - Low. Docs only. The doc is temporary and is deleted when the connector is released. ## Model Used - Anthropic Claude Fable 5.2 (`claude-fable-5-2`), in Claude Code with tool use and browser control. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [ ] All Paperclip CI gates are green - [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
1 parent
b26c0edf23
commit
0acac00a49
2 files changed
+18
-14
No files matched your search
@@ -98,15 +98,13 @@ From the folder README (`server/src/google-workspace-rest-tools/README.md`).
|
||||
to REST.
|
||||
- **What we send to the reviewers.** Not decided: the new staging tester or
|
||||
something else. Whatever it is must use the separate Google app (below).
|
||||
- **Staging tester on the separate Google app.** The broker now has a
|
||||
per-workspace client override; it is not switched on for the tester yet.
|
||||
The remaining steps and their order are in "Environments".
|
||||
- **Reviewer login on staging.** The broker now allows the scoped reviewer
|
||||
password login on the staging tester host. Its secret is not set yet; no
|
||||
broker change is needed.
|
||||
- **AI-agent client and REST.** Whether an OAuth client marked for AI agents
|
||||
may call the REST APIs rather than MCP. To check before the staging tester is
|
||||
wired.
|
||||
may call the REST APIs rather than MCP. The tester's client is marked for
|
||||
AI agents and is wired, but it has only been used through MCP. Check on the
|
||||
tester before any service is switched to REST.
|
||||
- **Three Gmail tools are inferred.** Google's MCP reference does not list
|
||||
`get_draft`, `list_threads` and `search_messages`; their schemas copy the
|
||||
sibling tools (#22014).
|
||||
@@ -129,7 +127,8 @@ From the folder README (`server/src/google-workspace-rest-tools/README.md`).
|
||||
1. Deploy the Cloud broker changes to production. They are merged and live
|
||||
on staging (see "Cloud broker"); the production deploy is manual and
|
||||
waits for Dotta.
|
||||
2. Point the staging tester at the separate Google app (see "Environments").
|
||||
2. Confirm the consent screen on the staging tester with a fresh Google
|
||||
account, and set the reviewer login secret.
|
||||
3. Finish live acceptance on the staging tester.
|
||||
4. Switch services to REST one at a time, each after its live test.
|
||||
5. Revoke at Google when the last connection is removed.
|
||||
@@ -159,13 +158,18 @@ Staging tester state (November 18):
|
||||
(list labels, search, read the synthetic email in full, create a draft),
|
||||
"Delete data", and a real agent task that found the synthetic email by its
|
||||
marker, returned the full body and left an unsent draft (about 2 minutes).
|
||||
- **Not yet on the separate Google app.** That app is External, In
|
||||
Production, 0 of 100 users, with the six REST APIs enabled and the staging
|
||||
broker callback registered on its one web client. The staging environment
|
||||
has the alternate client ID. Still needed, in this order: Dotta adds a
|
||||
client secret and stores it as the one-time bootstrap secret, then the
|
||||
stack list variable is set, then a staging deploy, then reconnect. Setting
|
||||
the stack list before the secret exists fails every staging deploy.
|
||||
- **On the separate Google app since November 18.** That app is External, In
|
||||
Production, with the six REST APIs enabled and the staging broker callback
|
||||
registered on its one web client. The staging environment lists the
|
||||
tester's stack for the alternate client, for the Workspace group only, so
|
||||
the per-service Gmail and Search profiles are unavailable on the tester.
|
||||
After the switch the old grant asked for a reconnect, as designed; after
|
||||
reconnecting, an agent task read the synthetic email again. Google did not
|
||||
show a consent screen on reconnect (the account had approved this app
|
||||
before), so the app name on the consent screen is still to be confirmed
|
||||
with a fresh Google account.
|
||||
- Never set the alternate stack list before its client secret exists: the
|
||||
Google bootstrap step then fails and blocks every staging deploy.
|
||||
- Reviewer password login for this host is supported by the broker but its
|
||||
secret is not set yet.
|
||||
|
||||
|
||||
@@ -94,7 +94,7 @@ Decisions and the details behind them are kept in the
|
||||
- [ ] Scopes identical in the picker, the server, the Cloud broker and the
|
||||
Google Console.
|
||||
- [x] `googletester.staging.paperclip.app` created (Nov 18).
|
||||
- [ ] Staging tester wired to the new Google app.
|
||||
- [x] Staging tester wired to the new Google app (Nov 18).
|
||||
|
||||
## 3. Policy and privacy
|
||||
|
||||
|
||||
Reference in new issue
Block a user