feat: rename, duplicate, and search recordings in the library

Project management was open/reveal/delete only. Added:

- Rename… (context menu → alert): moves the folder and rewrites the
  descriptor, preserving the original creation date. A project open in a
  Studio window keeps pointing at the old path until reopened.
- Duplicate: copies the whole folder as "Name copy" (collision-safe).
- A search field in the header filtering tiles by name.

Both library operations are unit-tested against a temp directory.

Author: jasonzh0

CineScreen/MainWindow/ProjectsView.swift

@@ -9,6 +9,10 @@ struct ProjectsView: View {
     @State private var hoveredProject: Project.ID?
     /// Set when the user picks Delete — the confirmation dialog acts on it.
     @State private var projectPendingDeletion: Project?
+    /// Set when the user picks Rename… — the rename alert acts on it.
+    @State private var projectPendingRename: Project?
+    @State private var renameText = ""
+    @State private var searchText = ""
 
     var body: some View {
         ZStack(alignment: .top) {
@@ -62,6 +66,32 @@ struct ProjectsView: View {
         } message: {
             Text("The recording and its edits can be restored from the Trash.")
         }
+        .alert(
+            "Rename Recording",
+            isPresented: Binding(
+                get: { projectPendingRename != nil },
+                set: { if !$0 { projectPendingRename = nil } }
+            )
+        ) {
+            TextField("Name", text: $renameText)
+            Button("Rename") {
+                if let project = projectPendingRename {
+                    do {
+                        _ = try ProjectsLibrary.rename(project, to: renameText)
+                        state.refreshProjects()
+                    } catch {
+                        state.statusMessage = "Rename failed: \(error.localizedDescription)"
+                    }
+                }
+                projectPendingRename = nil
+            }
+            Button("Cancel", role: .cancel) { projectPendingRename = nil }
+        }
+    }
+
+    private var filteredProjects: [Project] {
+        guard !searchText.isEmpty else { return state.projects }
+        return state.projects.filter { $0.name.localizedCaseInsensitiveContains(searchText) }
     }
 
     // MARK: - Backdrop
@@ -86,6 +116,10 @@ struct ProjectsView: View {
                     .truncationMode(.head)
             }
             Spacer(minLength: 8)
+            TextField("Search", text: $searchText)
+                .textFieldStyle(.roundedBorder)
+                .controlSize(.small)
+                .frame(width: 180)
             newRecordingButton
         }
         .padding(.horizontal, 28)
@@ -124,7 +158,7 @@ struct ProjectsView: View {
                 columns: [GridItem(.adaptive(minimum: 260), spacing: 20)],
                 spacing: 20
             ) {
-                ForEach(state.projects) { project in
+                ForEach(filteredProjects) { project in
                     ProjectTile(
                         project: project,
                         isHovered: hoveredProject == project.id
@@ -136,6 +170,16 @@ struct ProjectsView: View {
                         ProjectsLibrary.reveal(project)
                     } onDelete: {
                         projectPendingDeletion = project
+                    } onRename: {
+                        renameText = project.name
+                        projectPendingRename = project
+                    } onDuplicate: {
+                        do {
+                            _ = try ProjectsLibrary.duplicate(project)
+                            state.refreshProjects()
+                        } catch {
+                            state.statusMessage = "Duplicate failed: \(error.localizedDescription)"
+                        }
                     }
                     .onHover { hovering in
                         hoveredProject = hovering ? project.id : nil
@@ -244,6 +288,8 @@ private struct ProjectTile: View {
     var onOpen: () -> Void
     var onReveal: () -> Void
     var onDelete: () -> Void
+    var onRename: () -> Void
+    var onDuplicate: () -> Void
 
     @State private var thumbnail: NSImage?
 
@@ -269,6 +315,8 @@ private struct ProjectTile: View {
         .contextMenu {
             Button("Open") { onOpen() }
                 .disabled(!project.isComplete)
+            Button("Rename…") { onRename() }
+            Button("Duplicate") { onDuplicate() }
             Button("Reveal in Finder") { onReveal() }
             Divider()
             Button("Delete", role: .destructive) { onDelete() }

CineScreen/Projects/ProjectsLibrary.swift

@@ -122,6 +122,43 @@ final class ProjectsLibrary {
         try encoder.encode(descriptor).write(to: url, options: .atomic)
     }
 
+    /// Renames the project folder and updates its descriptor, preserving the
+    /// original creation date. Throws if a folder with the new name already
+    /// exists. Note: renaming a project that's open in a Studio window leaves
+    /// that window pointing at the old path until it's reopened.
+    static func rename(_ project: Project, to newName: String) throws -> Project {
+        let trimmed = newName.trimmingCharacters(in: .whitespacesAndNewlines)
+        guard !trimmed.isEmpty, trimmed != project.name else { return project }
+        let dest = project.folderURL.deletingLastPathComponent()
+            .appendingPathComponent(trimmed, isDirectory: true)
+        try FileManager.default.moveItem(at: project.folderURL, to: dest)
+        try writeDescriptor(
+            ProjectDescriptor(name: trimmed, createdAtMs: project.createdAt.timeIntervalSince1970 * 1000),
+            to: dest
+        )
+        return load(from: dest)
+    }
+
+    /// Copies the whole project folder as "Name copy" (then "copy 2", …).
+    static func duplicate(_ project: Project) throws -> Project {
+        let fm = FileManager.default
+        let parent = project.folderURL.deletingLastPathComponent()
+        var name = "\(project.name) copy"
+        var dest = parent.appendingPathComponent(name, isDirectory: true)
+        var counter = 2
+        while fm.fileExists(atPath: dest.path) {
+            name = "\(project.name) copy \(counter)"
+            dest = parent.appendingPathComponent(name, isDirectory: true)
+            counter += 1
+        }
+        try fm.copyItem(at: project.folderURL, to: dest)
+        try writeDescriptor(
+            ProjectDescriptor(name: name, createdAtMs: Date().timeIntervalSince1970 * 1000),
+            to: dest
+        )
+        return load(from: dest)
+    }
+
     /// Moves the project folder to the Trash — recoverable, unlike a hard
     /// delete. Deliberately no `removeItem` fallback: on volumes without a
     /// Trash this throws, and the caller surfaces the error, rather than

Tests/CineScreenTests/ProjectsLibraryTests.swift

@@ -38,6 +38,34 @@ final class ProjectsLibraryTests: XCTestCase {
         XCTAssertEqual(listed.first?.name, "Real")
     }
 
+    @MainActor
+    func testRenameMovesFolderAndPreservesCreationDate() throws {
+        let original = try ProjectsLibrary.createNew(in: root, name: "Before")
+        let renamed = try ProjectsLibrary.rename(original, to: "After")
+        XCTAssertEqual(renamed.name, "After")
+        XCTAssertFalse(FileManager.default.fileExists(atPath: original.folderURL.path))
+        XCTAssertEqual(
+            renamed.createdAt.timeIntervalSince1970,
+            original.createdAt.timeIntervalSince1970,
+            accuracy: 0.01
+        )
+    }
+
+    @MainActor
+    func testDuplicateCopiesArtifactsAndAvoidsCollisions() throws {
+        let original = try ProjectsLibrary.createNew(in: root, name: "Take")
+        FileManager.default.createFile(
+            atPath: original.fallbackVideoURL.path,
+            contents: Data([1, 2, 3])
+        )
+        let copy = try ProjectsLibrary.duplicate(original)
+        let copy2 = try ProjectsLibrary.duplicate(original)
+        XCTAssertNotEqual(copy.folderURL, original.folderURL)
+        XCTAssertNotEqual(copy2.folderURL, copy.folderURL)
+        XCTAssertTrue(FileManager.default.fileExists(atPath: copy.fallbackVideoURL.path))
+        XCTAssertEqual(ProjectsLibrary.projects(in: root).count, 3)
+    }
+
     /// Pre-descriptor recordings (video only, no project.json) stay visible.
     @MainActor
     func testListingKeepsFoldersWithVideoButNoDescriptor() throws {