Skip to content

docs: plan collaborative MIME email and MDY editing - #756

Draft
horner wants to merge 4 commits into
mainfrom
docs/collaborative-artifact-editing-plan
Draft

horner wants to merge 4 commits into
mainfrom
docs/collaborative-artifact-editing-plan

Conversation

@horner

@horner horner commented Nov 12, 2026 •

Copy link
Copy Markdown
Member

What & why

Plan a collaborative component that handles almost all email display and composition work for mail clients: an IMAP client passes fetched raw message bytes to the component and receives complete-message output for host-owned draft-save/send adapters. MIME email is a first-class use case; MDY is the preferred format for hosts that do not need MIME.

The implementation plan includes message headers and MIME conventions, inline media/attachments, new messages, draft editing, reply/reply-all, and forwarding. It distinguishes source export, draft save, and delivery serialization, including the separate transport recipient envelope. A minimal mail-client integration with no caller MIME parsing or rewriting is an acceptance gate.

Eight phased milestones coordinate UI, Kerebron, Artipod, eSheet, and yorm. Shared Artipod storage, existing yorm DocumentSession, eSheet default Artifact scopes/question overrides, parallel implementation, and owner-approved migration/deprecation remain part of the plan.

Refs #755. That issue tracks implementation and stays open after this planning PR merges.

Checklist

  • Plan formatting, structure, terminology, and required eSheet diagram checked.
  • git diff --check passes.
  • pnpm lint and pnpm format pass.
  • pnpm typecheck && pnpm lint && pnpm format && pnpm test all pass.

Initial local typecheck is blocked by the missing @kerebron/extension-menu package in the existing dependency installation. The same unresolved import blocks five test suites; 185 suites and 2,657 tests pass. These failures are recorded for transparency; this PR changes only the planning document and leaves source, dependencies, and submodule revisions out of the commit.

Visual tests and RTL rendering checks are not applicable to this documentation-only change. Implementation examples, browser validation, and the multi-user acceptance scenarios are future milestone requirements in the plan.

The MIME/email clarification also passes document formatting, structure, terminology, and scope-diagram checks. The earlier source quality-gate results above remain applicable to the unchanged source tree.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

Deploying ui with  Cloudflare Pages  Cloudflare Pages

Latest commit: 58fa5fb
Status: ✅  Deploy successful!
Preview URL: https://34fae492.ui-6d0.pages.dev
Branch Preview URL: https://docs-collaborative-artifact.ui-6d0.pages.dev

View logs

@horner horner changed the title docs: plan collaborative Artifact editing and MIME support docs: plan collaborative MIME email and MDY editing Nov 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant