Method restoreSessionArchiveMetadata

hub/src/sync/sessionCache.ts:588–641

* Restore archive-related metadata fields that were captured before a reopen attempt. * Used when `resumeSession` fails after `clearSessionArchiveMetadata` already ran so the * session does not drift into a "not archived, not active" zombie state. * * Restores the four archive fi

(
        sessionId: string,
        snapshot: {
            lifecycleState?: string
            archivedBy?: string
            archiveReason?: string
            lifecycleStateSince?: number
        }
    )

     * on version mismatch so the caller can decide whether to retry.
     */
    async restoreSessionArchiveMetadata(
        sessionId: string,
        snapshot: {
            lifecycleState?: string
            archivedBy?: string
            archiveReason?: string
            lifecycleStateSince?: number
        }
    ): Promise<void> {
        const session = this.sessions.get(sessionId)
        if (!session) return
        const current = session.metadata
        if (!current) return

        const next: Record<string, unknown> = { ...current }
        if (snapshot.lifecycleState !== undefined) {
            next.lifecycleState = snapshot.lifecycleState
        } else {
            delete next.lifecycleState
        }
        if (snapshot.archivedBy !== undefined) {
            next.archivedBy = snapshot.archivedBy
        } else {
            delete next.archivedBy
        }
        if (snapshot.archiveReason !== undefined) {
            next.archiveReason = snapshot.archiveReason
        } else {
            delete next.archiveReason
        }
        if (snapshot.lifecycleStateSince !== undefined) {
            next.lifecycleStateSince = snapshot.lifecycleStateSince
        } else {
            delete next.lifecycleStateSince
        }

        const result = this.store.sessions.updateSessionMetadata(
            sessionId,
            next,
            session.metadataVersion,
            session.namespace,
            { touchUpdatedAt: false }
        )

        if (result.result === 'error') {
            throw new Error('Failed to restore archive metadata')
        }

        if (result.result === 'version-mismatch') {
            throw new Error('Session was modified concurrently during reopen rollback')
        }

        this.refreshSession(sessionId)
    }

    async deleteSession(sessionId: string): Promise<void> {
        const session = this.sessions.get(sessionId)