Method createVersion

src/durable-objects/user-notes.ts:264–319

(noteId: string, title: string, content: string, createdBy = "system", kind = "manual", summary: string | null = null)

        const existing = this.saveTimers.get(noteId);
        if (existing) clearTimeout(existing);
        this.saveTimers.set(noteId, setTimeout(() => {
            this.saveTimers.delete(noteId);
            try {
                this.persistDocNow(noteId, doc);
            } catch (e) {
                console.error(`Failed to persist Yjs state for note ${noteId} (attempt ${attempt + 1}):`, e);
                // Don't drop the only copy of the user's edits on a transient
                // failure — re-arm with backoff. The in-memory doc is the sole
                // holder of this content until a persist succeeds.
                if (attempt < 5) this.scheduleDocPersist(noteId, doc, Math.min(2000 * 2 ** attempt, 30000), attempt + 1);
            }
        }, delayMs));
    }

    // Consecutive autosave-session versions inside this window are amended in
    // place instead of appended, so tab-switch/idle churn doesn't flood history.
    private readonly SESSION_AMEND_WINDOW_S = 15 * 60;
    private readonly MAX_VERSIONS_PER_NOTE = 1000;

    private versionKey(noteId: string, versionId: string): string {
        return `versions/${this.ctx.id.toString()}/${noteId}/${versionId}.json`;
    }

    // --- Branch helpers ---

    private ensureDefaultBranch(noteId: string): { id: string; name: string; head_version_id: string | null } {
        const existing = this.sql.exec(
            "SELECT id, name, head_version_id FROM note_branches WHERE note_id = ? AND is_default = 1", noteId
        ).toArray()[0] as any;
        if (existing) return existing;

        const id = crypto.randomUUID();
        this.sql.exec(
            "INSERT INTO note_branches (id, note_id, name, is_default) VALUES (?, ?, 'main', 1)", id, noteId
        );
        this.sql.exec(
            "UPDATE notes SET current_branch_id = ? WHERE id = ? AND current_branch_id IS NULL", id, noteId
        );
        return { id, name: "main", head_version_id: null };
    }

    private getCurrentBranch(noteId: string): { id: string; name: string; head_version_id: string | null } {
        const note = this.getNote(noteId);
        if (note?.current_branch_id) {
            const branch = this.sql.exec(
                "SELECT id, name, head_version_id FROM note_branches WHERE id = ?", note.current_branch_id
            ).toArray()[0] as any;
            if (branch) return branch;
        }
        return this.ensureDefaultBranch(noteId);
    }

    // --- Version creation (branch-aware) ---

    private async createVersion(noteId: string, title: string, content: string, createdBy = "system", kind = "manual", summary: string | null = null): Promise<string | null> {
        const branch = this.getCurrentBranch(noteId);
        const parentId = branch.head_version_id;
        const hash = this.contentHash(content);