• AI = content or structured intent
• Document = structure + projection
• Folio = rendering + pagination
• Actions = persistence + orchestration
• Entities = canonical domain truth

• UI emits intent
• local state updates immediately
• server action persists
• revalidate rebuilds
• Folio re-renders from persisted truth

• no Prisma in pages or components
• no mutation in pages
• no bypassing queueSave
• no duplicate persistence authorities
• no speculative schema redesign during this phase

Canonical truth lives in entities and DB:

• Project
• Trip
• Experience
• Product
• Offer
• Order
• LineItem
• related entities

Document is:

• projection container
• orchestration surface
• editable working surface
• export surface

Document is not:

• domain truth for all entities

Folio is:

• deterministic renderer
• flow normalizer
• pagination distributor
• page composer

Folio is not:

• business logic
• persistence layer
• domain truth

Actions are:

• sole mutation authority
• Prisma boundary
• orchestration layer for internal and external tools

Use only:

• topSurfaceSection
• contentSections

Never use as canonical:

• conentSection
• contentSection

• engine owns page-1 surface state
• wagon pages persist overflow page surfaces
• repagination rebuilds from engine + persisted wagon surfaces
• wagon pages remain editable
• wagon edits persist first, then repaginate safely

User intent → queueSave → commitUpdate → local UI update → onSave → server action → Prisma write → revalidate → server rebuild → PaperStack refresh

Reduce user-facing AI modes to the canonical safe set.

export type AIMode = "general" | "coaching";

Keep internal pipelines hidden if they still exist, but not user-selectable.

Keep only:

• general
• coaching

• only 2 modes visible
• no local duplicated mode unions
• no TS mode drift

AI writes content, not document structure.

• AI never overwrites title
• AI writes into topSurfaceSection
• contentSections stays empty unless an explicit structured pipeline needs it
• AI does not decide final document layout

• AI output visible in document
• title preserved
• no pagination regression

Eliminate naming drift and silent corruption.

• replace all conentSection
• replace remaining contentSection usages where they still act as canonical data names
• enforce shape before persist

• topSurfaceSection must be array
• contentSections must be array
• visibility flags must be boolean or undefined

• no field drift
• no undefined surface crashes
• no old field names in active document flow

Make coaching a structured router instead of a parallel loose mode.

• general = plain content generation
• coaching = route-aware structured generation / action preparation

• trip context → trip planning/generation
• document context → document generation/structure
• fallback → general

• coaching routes correctly
• general unchanged
• no document regression

Turn toolbar into the canonical execution surface.

• open sidebar tool
• direct document action
• external export/action
• navigation

• New Doc
• Open Docs
• Browse
• Export PDF
• Commit & Reflow
• Paginate
• Add Page

No mixed ad hoc button behavior.

Standardize external Google Workspace execution.

• Apps Script endpoints = atomic capability layer
• Next server actions = orchestration layer
• toolbar = execution surface
• sidebar = composition surface
• entities/sections = payload/context sources

• docs.create
• docs.exportPdf
• gmail.send
• calendar.createEvent
• sheets.appendRows
• drive.share
• drive.list

Apps Script performs side effects only. Next actions handle business logic, persistence, and revalidation.

Make sidebar the canonical composition surface.

• entity controllers
• AI composition zone
• payload/context preparation
• scoped tool registries

Sidebar tools prepare and route work. They do not become uncontrolled side-effect surfaces.

Re-enable and stabilize project page builder sections already present in the codebase.

• sections load correctly
• sections save correctly
• sections can be edited repeatedly
• sections persist and reload correctly
• section naming and field alignment matches current canonical patterns

This is a repair/reactivation task, not a redesign.

• Assignment / WeekAssignment if still required
• ActivitySelector
• ForecastPreview
• WeekGrid
• ActiveWeek

No broader schema redesign beyond the required assignment unit.

Separate public interface from Folio/document internals.

• internal planning
• drafting
• orchestration
• export
• offer building support

• trip browsing
• date/session selection
• pricing display
• booking path
• FareHarbor links/widgets
• custom inquiry path

Documents support trip operations but are not the public trip UI.

Document → transformed output only.

No duplication of truth. No secondary editable truth.

• magazine transformation
• export refinements
• structured publishing outputs

• page
• section
• card
• label
• CTA
• document shell consistency
• sidebar/layout consistency
• page builder consistency where applicable

• Toolbar = execute
• Sidebar = compose
• AI general = generate content
• AI coaching = generate structured intent / fill drafts / route work
• Actions = persist and orchestrate
• Apps Script = execute Google side effects

Prompt → structured intent → prefilled form / payload / draft entity → user tweaks if needed → action executes → result persists

Possible results:

• prefilled Trip draft
• prefilled Product draft
• prefilled Experience draft
• generated Offer doc
• created meeting/event schedule
• exported Google Doc
• logged activity

Unify the interface, not necessarily every internal script implementation.

• request envelope
• response envelope
• action naming
• auth
• error format
• request id / logging

Apps Script remains generic and atomic. Next server actions remain domain-aware and orchestration-aware.

• AI general/coaching modes stable
• document generation stable
• document editing stable
• pagination stable enough for production continuation
• toolbar works as execution router
• sidebar works as composition router
• first Google/App Script generic tools wired
• page builder sections active and stable again

• sponsor system can proceed safely
• public trips UI can proceed as a separate surface