docs(planning): Scribe for Documents integration spec (answers Matt's email) - #762
Merged
Conversation
… email) New docs/planning/scribe.md: a complete answer to Pneuma Solutions' (Matt Campbell) proposal to integrate Scribe for Documents. Confirms QUILL already runs an OAuth authorization-code flow (Mastodon: register/authorize/exchange, tokens in the OS credential store, browser hand-off) and proposes reusing it with PKCE + a loopback redirect for a no-paste, accessible sign-in. Maps the three proposed endpoints (upload->open streaming URL, list, download) to QUILL-native, consent-gated, focus-and-progress-correct flows; sketches the magical round-trips (inaccessible PDF rescue in place, convert->edit->export, watch-folder auto-convert, convert-and-read-aloud); lists concrete open questions for Pneuma (endpoints, redirect/PKCE/scopes/refresh, upload/list/download shapes, rate limits); and the QUILL integration points + phased plan. Draft for review. Co-Authored-By: Claude Opus 4.8 <[email protected]> EOF
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
New
docs/planning/scribe.md: a complete, build-ready answer to Pneuma Solutions' (Matt Campbell) proposal to integrate Scribe for Documents.Answers Matt's questions directly:
Also includes: accessible UX (consent-gated, Safe-Mode-off, focus + spoken cancelable progress — never leaves the user in la-la-land), QUILL integration points (reuse the Mastodon OAuth client + credential store, a new
quill/core/scribe/client, GATE-9 egress audit), a concrete open-questions list for Pneuma (endpoints, redirect/PKCE/scopes/refresh, upload/list/download shapes, rate limits), and a phased plan.Draft for review — and ready to forward the key points to Matt.
🤖 Generated with Claude Code