OnboardingManager

packages/desktop/src/main/onboarding-manager.ts manages all local onboarding and memory data for the desktop app. It handles reads/writes and delegates cloud pushes to SyncManager.

Storage Layout

userData/
└── cosmo-data/
    ├── users/
    │   └── {userId}.json            ← UserProfile
    ├── onboarding/
    │   └── {orgId}.json             ← OrgOnboarding
    ├── memory/
    │   ├── user-{userId}.md         ← Plain-text user memory
    │   └── org-{orgId}.md           ← Plain-text org memory
    └── brand-assets/
        └── {orgId}/
            └── {fileName}           ← Logo, icon, etc.

Types

`UserProfile`

Field	Type	Description
`completed`	boolean	Whether onboarding is complete
`completedAt`	string \| null	ISO timestamp of completion
`userId`	string	User ID
`preferredName`	string \| null	Preferred display name
`role`	string \| null	Job title or role
`painPoint`	string \| null	Primary pain point extracted from onboarding
`preferences`	string \| null	Free-text preferences

`OrgOnboarding`

Field	Type	Description
`completed`	boolean	Whether org onboarding is complete
`completedAt`	string \| null	ISO timestamp of completion
`orgId`	string	Org ID
`companyName`	string \| null	Company name
`industry`	string \| null	Industry
`teamSize`	string \| null	Team size bucket
`useCase`	string \| null	Primary use case
`brandKit`	`{ logos: StorageRef[], primaryColor, secondaryColor, accentColor } \| null`	Brand assets

`StorageRef`

Field	Type	Description
`provider`	`'local' \| 'r2'`	Storage backend
`bucket`	string	Storage bucket name
`key`	string	Object key/path in storage
`contentType`	string	MIME type
`sizeBytes`	number	File size in bytes

Methods

User Profile

Method	Description
`getUserProfile(userId)`	Read `users/{userId}.json`, return `UserProfile \| null`
`saveUserProfile(userId, data)`	Write profile JSON, then push to cloud via `SyncManager`

Org Onboarding

Method	Description
`getOrgOnboarding(orgId)`	Read `onboarding/{orgId}.json`, return `OrgOnboarding \| null`
`saveOrgOnboarding(orgId, data)`	Write onboarding JSON, then push to cloud via `SyncManager`

Memory

Method	Description
`getUserMemory(userId)`	Read `memory/user-{userId}.md`, return string or empty string
`saveUserMemory(userId, content)`	Write memory file, push to cloud
`getOrgMemory(orgId)`	Read `memory/org-{orgId}.md`
`saveOrgMemory(orgId, content)`	Write org memory, push to cloud

Memory files are plain Markdown — the AI reads and writes them directly during interactions.

Brand Assets

Method	Description
`saveAsset(orgId, fileName, buffer, contentType)`	Write binary file to `brand-assets/{orgId}/{fileName}`
`resolveAssetUrl(ref)`	Convert a `StorageRef` to a `file://` URL the renderer can use

Reset

resetAll(orgId, userId) deletes all data for the given user+org combination: profile, onboarding, memory files, and brand assets. Called on onboarding:reset IPC.

Cloud Push

Every save* method calls the corresponding SyncManager.push*() method in the background. Pushes are fire-and-forget — local writes succeed regardless of network state.

On this page