Docs

    1003 - Xyppy Launch Readiness

    Xyppy Print ThisUpdated Aug 16, 2026MD
    Markdown file

    DOCS/PROJECTS/active/1003_xyppy_launch_readiness.md

    1003 - Xyppy Launch Readiness

    Goals

    • Move the validated ChatGPT configurator toward a launch-ready product path without creating real orders before approval.
    • Clarify the commerce backend decision: Shopify, Stripe, or a hybrid.
    • Add a safe purchase-workflow scaffold that can become a real checkout handoff later.

    Scope

    In Scope

    • Backward-compatible MCP tool additions that preserve the already validated configure_print contract.
    • Production hosting and commerce architecture notes.
    • Safe checkout preview and handoff UI that cannot charge, create orders, or transmit image assets to live vendors.
    • Context Layer docs, validation evidence, and regular commits.

    Out of Scope

    • Live Shopify product creation, Shopify Admin mutations, Stripe account setup, payments, fulfillment, print-ready file generation, and public plugin submission.
    • Real customer data collection, shipping address collection, or storing uploaded images outside the current local/ChatGPT prototype flow.

    Success Criteria

    • A documented backend recommendation exists with Shopify, Stripe, and hybrid tradeoffs.
    • The app exposes a safe checkout-preview path and clear next-step handoff semantics.
    • The UI makes the difference between prototype pricing, review, and live checkout explicit.
    • Typecheck, tests, build, MCP validation, and docs checks pass.
    • No live commerce mutation occurs without Maggie's later approval.

    Supporting Docs And Evidence

    • Durable evidence path: DOCS/evidence/active/1003/
    • Parent project: DOCS/PROJECTS/active/1001_xyppy_chatgpt_app.md
    • Completed prototype stream: DOCS/PROJECTS/completed/1002_xyppy_print_this_prototype.md
    • Infrastructure decision packet: DOCS/evidence/active/1003/commerce-infrastructure-options.md
    • Durable hosting options: DOCS/deployment/launch-hosting-options.md
    • Launch checklist: DOCS/deployment/launch-checklist.md
    • Asset retention policy: DOCS/deployment/asset-retention-policy.md
    • ChatGPT metadata refresh strategy: DOCS/deployment/chatgpt-metadata-refresh.md
    • First tranche validation: DOCS/evidence/active/1003/validation-2026-08-14-1144.md
    • Runtime readiness validation: DOCS/evidence/active/1003/runtime-readiness-2026-08-14-1152.md
    • Deployment readiness evidence: DOCS/evidence/active/1003/deployment-readiness-2026-08-14-1155.md
    • Launch check evidence: DOCS/evidence/active/1003/launch-check-2026-08-14-1157.md

    Visual/UX Quality Gate

    • Critique verdict: pass for first checkout-preview tranche
    • Evidence paths: DOCS/evidence/active/1003/configure-mobile.png, DOCS/evidence/active/1003/checkout-preview-mobile.png, DOCS/evidence/active/1003/quote-copy-mobile.png, DOCS/evidence/active/1003/visual-qa-2026-08-14-1149.md
    • Must-fix issues: none found for this tranche
    • Approved deviations: prototype pricing and disabled live checkout are intentional until backend selection
    • Follow-up verification: retest inside ChatGPT Developer Mode after metadata refresh/reconnect

    Milestones

    • Infrastructure decision packet. Completed 2026-08-14 11:44 ET.
    • Safe checkout-preview MCP tool and UI. Completed 2026-08-14 11:44 ET.
    • Launch-readiness docs and validation. Completed for first tranche 2026-08-14 11:44 ET.
    • In-ChatGPT retest after metadata changes.

    Checkpoint Log

    Checkpoint 01 - 2026-08-14 11:38 ET (America/New_York)

    Completed Since Prior Checkpoint

    • Opened launch-readiness stream after 1002 passed Developer Mode validation.
    • Confirmed the next work must remain backward-compatible with published-plugin contract expectations.

    Next Checkpoint Targets

    • Draft Shopify vs Stripe vs hybrid infrastructure options.
    • Add safe checkout-preview implementation and tests.
    • Validate and push the first launch-readiness tranche.

    Notes

    • OpenAI app metadata should be treated as a versioned contract. Avoid renaming configure_print; add compatible fields or new tools instead.

    Checkpoint 02 - 2026-08-14 11:44 ET (America/New_York)

    Completed Since Prior Checkpoint

    • Added a backward-compatible preview_checkout MCP tool with read-only/destructive-safe annotations.
    • Added shared checkout preview logic that produces deterministic quote ids, line items, subtotal, estimated shipping, and a disabled next-step handoff.
    • Updated the ChatGPT widget summary screen with a checkout handoff preview panel and explicit no-cart/no-session/no-order/no-payment boundaries.
    • Documented Shopify-first, Stripe-first, and hybrid commerce infrastructure options, using the existing shopify-headless Storefront checkout precedent as read-only implementation context.
    • Validated typecheck, tests, production build, and MCP contract.

    Next Checkpoint Targets

    • Run visual QA on the updated checkout handoff panel in the browser/ChatGPT iframe context.
    • Decide whether to refresh the connected ChatGPT Developer Mode plugin metadata now or wait until the next stable tool set.
    • Start the gated live-checkout adapter design without enabling live checkout.

    Notes

    • Shopify-first remains the recommended first production commerce path, but live cart creation stays blocked pending Maggie's backend and asset-storage decision.

    Checkpoint 03 - 2026-08-14 11:49 ET (America/New_York)

    Completed Since Prior Checkpoint

    • Captured mobile configure and checkout-preview screenshots with Playwright MCP.
    • Accepted the checkout-preview visual state as non-blocking for the first launch-readiness tranche.
    • Recorded one polish follow-up: long quote ids should eventually get copy/truncation treatment on mobile.

    Next Checkpoint Targets

    • Commit and push the validated checkout-preview tranche.
    • Decide whether to refresh the installed Developer Mode plugin metadata immediately or after the next backend-adapter tranche.

    Notes

    • The UI keeps the live checkout CTA disabled and states that no cart, session, order, payment, production file, or fulfillment task was created.

    Checkpoint 04 - 2026-08-14 11:52 ET (America/New_York)

    Completed Since Prior Checkpoint

    • Added checkout handoff metadata for future Shopify/Stripe line-item/order mapping.
    • Added runtime checkout readiness reporting that defaults to Shopify preview mode and keeps live checkout disabled.
    • Added /health checkout readiness output listing missing environment blockers.
    • Extended automated tests and MCP verification to assert that live checkout cannot be created in this build.

    Next Checkpoint Targets

    • Commit and push the runtime-readiness tranche.
    • Continue toward launch hosting checklist and durable MCP endpoint options.

    Notes

    • This tranche intentionally adds no Shopify/Stripe network calls and no create_checkout tool. It prepares the adapter shape while preserving the no-live-commerce boundary.

    Checkpoint 05 - 2026-08-14 11:55 ET (America/New_York)

    Completed Since Prior Checkpoint

    • Added Docker packaging for a long-running Node deployment.
    • Added .dockerignore to keep local build/runtime artifacts and evidence screenshots out of the deployment context.
    • Documented durable hosting options and recommended a long-running Node web service for the first launch candidate.
    • Checked primary deployment docs for OpenAI MCP requirements, Render Node/Express/Docker support, and Fly Dockerfile support.
    • Confirmed Docker CLI is installed locally, but the Docker daemon is not running, so container build/run validation remains pending.

    Next Checkpoint Targets

    • Validate Docker build/run after Docker Desktop/daemon is available.
    • Commit and push the deployment-readiness tranche.
    • Continue with launch checklist and ChatGPT metadata refresh strategy.

    Notes

    • No external host was created. This tranche only packages and documents the deployment path.

    Checkpoint 06 - 2026-08-14 11:56 ET (America/New_York)

    Completed Since Prior Checkpoint

    • Added pnpm launch:check as a repeatable pre-launch verification command.
    • Added deployment launch checklist covering durable endpoint, ChatGPT Developer Mode refresh, commerce gates, environment variables, and evidence capture.
    • Documented target-host invocation with XYPPY_MCP_URL and XYPPY_HEALTH_URL.

    Next Checkpoint Targets

    • Run pnpm launch:check against the current local MCP server.
    • Commit and push the launch-check tranche.
    • Continue with final launch-readiness gaps.

    Notes

    • The launch check explicitly asserts canCreateLiveCheckout: false.

    Checkpoint 07 - 2026-08-14 11:57 ET (America/New_York)

    Completed Since Prior Checkpoint

    • Ran pnpm launch:check against the current local MCP server.
    • Verified typecheck, tests, build, docs links, MCP contract, and health checkout safety in one command.

    Next Checkpoint Targets

    • Commit and push the launch-check tranche.
    • Continue with final launch-readiness gaps and handoff notes.

    Notes

    • Local launch check passed with checkoutProvider=shopify, checkoutMode=preview, and canCreateLiveCheckout=false.

    Checkpoint 08 - 2026-08-14 12:00 ET (America/New_York)

    Completed Since Prior Checkpoint

    • Added a Copy affordance for the deterministic quote id in the checkout preview.
    • Improved quote id wrapping on mobile.
    • Captured updated mobile checkout-preview evidence at DOCS/evidence/active/1003/quote-copy-mobile.png.
    • Re-ran pnpm launch:check successfully after the UI change.

    Next Checkpoint Targets

    • Commit and push the visual polish tranche.
    • Continue with metadata refresh strategy and final go-live gaps.

    Notes

    • This closes the quote-id mobile polish item found in the first visual QA pass.

    Checkpoint 09 - 2026-08-14 12:00 ET (America/New_York)

    Completed Since Prior Checkpoint

    • Drafted image asset retention policy for temporary quote storage.
    • Drafted ChatGPT Developer Mode metadata refresh strategy.
    • Clarified that public submission remains gated on durable hosting, hosted launch checks, Developer Mode evidence, commerce approval, and asset-storage approval.

    Next Checkpoint Targets

    • Validate docs and commit/push final documentation tranche.

    Notes

    • The recommended first asset path is temporary quote storage with explicit expiration, not permanent user libraries.

    Risks

    • A temporary Cloudflare tunnel is not durable hosting and should not be used for launch.
    • Real image-to-print checkout likely needs an asset upload/storage policy before live payment.
    • Shopify-hosted checkout is strong for store operations, but custom image/order metadata must be modeled deliberately.

    Open Questions

    • Should the first real checkout use Shopify-hosted checkout, Stripe Checkout, or a hybrid Shopify catalog plus Stripe payment flow? Current recommendation: Shopify-hosted checkout first.
    • Should custom uploaded images be stored by Xyppy before checkout, after checkout, or temporarily as quote assets? Current recommendation: temporary quote storage with retention.
    • What print vendor or fulfillment system will receive production files?

    MAGGIE TODO

    • MAGGIE TODO: Choose the production commerce backend path after reviewing the infrastructure options.
    • MAGGIE TODO: Confirm whether Xyppy should own uploaded image storage before checkout.