docs: showcase Pine 2.0 release (#1332)

* docs: showcase Pine 2.0 release

* fix: stabilize agent inbox screenshot test

Author: batonogov

Pine/Agent/AgentTaskRegistry.swift

@@ -172,6 +172,157 @@ final class AgentTaskRegistry {
         self.flushTail = flushTail
     }
 
+    #if DEBUG
+    /// Seeds stable, human-readable rows for the opt-in marketing screenshot.
+    /// The fixture is presentation-only: it is never persisted or indexed as
+    /// live terminal ownership, and production builds contain no entry point.
+    func seedMarketingInboxForUITesting(at referenceDate: Date = Date()) {
+        guard tasks.isEmpty else { return }
+        tasks = [
+            marketingTask(.init(
+                seed: 1,
+                projectName: "Pine Demo",
+                worktreeName: nil,
+                title: "Approve the release announcement",
+                agentType: .codex,
+                state: .waitingInput,
+                liveness: .live,
+                lifecycle: .active,
+                attention: .waitingInput,
+                isUnread: true,
+                startedSecondsAgo: 7 * 60,
+                verifiedSecondsAgo: 18
+            ), referenceDate: referenceDate),
+            marketingTask(.init(
+                seed: 2,
+                projectName: "Launch Site",
+                worktreeName: nil,
+                title: "Verify signed DMG and Homebrew install",
+                agentType: .claudeCode,
+                state: .done,
+                liveness: .terminated,
+                lifecycle: .completed,
+                attention: .completed,
+                isUnread: true,
+                startedSecondsAgo: 18 * 60,
+                verifiedSecondsAgo: 2 * 60
+            ), referenceDate: referenceDate),
+            marketingTask(.init(
+                seed: 3,
+                projectName: "Pine Demo",
+                worktreeName: "release-2.0",
+                title: "Capture Agent Inbox screenshots",
+                agentType: .gemini,
+                state: .executing,
+                liveness: .live,
+                lifecycle: .active,
+                attention: .none,
+                isUnread: false,
+                startedSecondsAgo: 4 * 60,
+                verifiedSecondsAgo: 8
+            ), referenceDate: referenceDate),
+            marketingTask(.init(
+                seed: 4,
+                projectName: "Documentation",
+                worktreeName: nil,
+                title: "Translate the Pine 2.0 highlights",
+                agentType: .openCode,
+                state: .thinking,
+                liveness: .live,
+                lifecycle: .active,
+                attention: .none,
+                isUnread: false,
+                startedSecondsAgo: 2 * 60,
+                verifiedSecondsAgo: 5
+            ), referenceDate: referenceDate),
+        ]
+    }
+
+    private struct MarketingTaskFixture {
+        let seed: Int
+        let projectName: String
+        let worktreeName: String?
+        let title: String
+        let agentType: AgentType
+        let state: AgentRunState
+        let liveness: AgentRunLiveness
+        let lifecycle: AgentTaskLifecycle
+        let attention: AgentTaskAttention
+        let isUnread: Bool
+        let startedSecondsAgo: TimeInterval
+        let verifiedSecondsAgo: TimeInterval
+    }
+
+    private func marketingTask(
+        _ fixture: MarketingTaskFixture,
+        referenceDate: Date
+    ) -> AgentTask {
+        let projectPath = "/Pine Marketing/\(fixture.projectName)"
+        let worktreePath = fixture.worktreeName.map {
+            "\(projectPath)/.pine-worktrees/\($0)"
+        } ?? projectPath
+        let terminalID = marketingUUID(fixture.seed + 1_000)
+        let observedAt = referenceDate.addingTimeInterval(
+            -fixture.verifiedSecondsAgo
+        )
+        let startedAt = referenceDate.addingTimeInterval(
+            -fixture.startedSecondsAgo
+        )
+        let context = AgentTaskBridgeContext(
+            project: AgentTaskProjectIdentity(
+                canonicalProjectPath: projectPath,
+                canonicalWorktreePath: worktreePath
+            ),
+            route: AgentTaskRoute(
+                paneID: marketingUUID(fixture.seed),
+                tabID: terminalID,
+                terminalID: terminalID,
+                availability: fixture.liveness == .live
+                    ? .available
+                    : .missing
+            ),
+            origin: .pineLaunched,
+            observedAt: startedAt
+        )
+        var task = AgentTask(
+            descriptor: AgentDescriptor(agentType: fixture.agentType),
+            context: context,
+            title: fixture.title,
+            objective: fixture.title,
+            createdAt: startedAt
+        )
+        task.runs = [AgentTaskRun(AgentTaskRunInput(
+            id: marketingUUID(fixture.seed + 2_000),
+            terminalID: terminalID,
+            process: AgentProcessEvidence(
+                processIdentifier: Int32(20_000 + fixture.seed),
+                processGeneration: UInt64(fixture.seed),
+                startIdentifier: "marketing-fixture-\(fixture.seed)",
+                observedStartedAt: startedAt,
+                startIsAuthoritative: true
+            ),
+            status: AgentTaskRunStatus(
+                state: fixture.state,
+                liveness: fixture.liveness,
+                observedAt: observedAt
+            )
+        ))]
+        task.lifecycle = fixture.lifecycle
+        task.attention = fixture.attention
+        task.isUnread = fixture.isUnread
+        task.updatedAt = observedAt
+        task.lastActivityAt = observedAt
+        task.completedAt = fixture.lifecycle == .completed ? observedAt : nil
+        return task
+    }
+
+    private func marketingUUID(_ seed: Int) -> UUID {
+        let suffix = String(format: "%012llX", UInt64(seed))
+        return UUID(uuidString: "00000000-0000-0000-0000-\(suffix)")
+            ?? UUID()
+    }
+    #endif
+
     func task(for id: UUID) -> AgentTask? {
         tasks.first { $0.id == id }
     }

Pine/ProjectRegistry.swift

@@ -81,6 +81,13 @@ final class ProjectRegistry: LSPSettingsObserver {
             defaults.removeObject(forKey: Self.recentProjectsKey)
         }
         loadRecentProjects()
+        #if DEBUG
+        if ProcessInfo.processInfo.arguments.contains(
+            "--ui-test-agent-inbox-marketing"
+        ) {
+            agentTasks.seedMarketingInboxForUITesting()
+        }
+        #endif
         lspSettings.addObserver(self)
     }
 

Pine/WelcomeView.swift

@@ -100,6 +100,13 @@ struct WelcomeView: View {
                 Button {
                     openWindow(id: "agent-inbox")
                     NSApp.activate()
+                    #if DEBUG
+                    if ProcessInfo.processInfo.arguments.contains(
+                        "--ui-test-agent-inbox-marketing"
+                    ) {
+                        appDelegate?.hideWelcome()
+                    }
+                    #endif
                 } label: {
                     Label(Strings.menuAgentInbox, systemImage: MenuIcons.agentInbox)
                 }

PineUITests/ScreenshotTests.swift

@@ -48,6 +48,57 @@ final class ScreenshotTests: PineUITestCase {
         attachScreenshot(screenshot, name: "screenshot-welcome")
     }
 
+    // MARK: - Agent Inbox
+
+    func testCaptureAgentInbox() throws {
+        app.launchArguments += [
+            "--clear-recent-projects",
+            "--ui-test-agent-inbox-marketing",
+        ]
+        launchClean()
+
+        let welcomeWindow = app.windows["welcome"]
+        XCTAssertTrue(
+            waitForExistence(welcomeWindow, timeout: 10),
+            "Welcome window should appear"
+        )
+
+        let inboxButton = app.buttons["welcomeAgentInboxButton"]
+        XCTAssertTrue(
+            waitForExistence(inboxButton, timeout: 5),
+            "Agent Inbox should be available from Welcome"
+        )
+        inboxButton.click()
+
+        let inboxWindow = app.windows["Agent Inbox"]
+        XCTAssertTrue(
+            waitForExistence(inboxWindow, timeout: 10),
+            "Agent Inbox window should appear"
+        )
+        // The marketing launch path hides every SwiftUI/AppKit Welcome owner.
+        // This avoids closing only one of the duplicate fallback windows that
+        // macOS 26 can expose to XCUITest.
+        XCTAssertTrue(
+            welcomeWindow.waitForNonExistence(timeout: 5),
+            "Welcome should hide before capturing Agent Inbox"
+        )
+        let releaseTask = inboxWindow.buttons.matching(
+            NSPredicate(
+                format: "label CONTAINS %@",
+                "Approve the release announcement"
+            )
+        ).firstMatch
+        XCTAssertTrue(
+            waitForExistence(releaseTask, timeout: 5),
+            "Marketing tasks should populate Agent Inbox"
+        )
+
+        Thread.sleep(forTimeInterval: 1.0)
+
+        let screenshot = inboxWindow.screenshot()
+        attachScreenshot(screenshot, name: "screenshot-agent-inbox")
+    }
+
     // MARK: - Editor with File
 
     func testCaptureEditorWithFile() throws {

README.md

@@ -1,4 +1,8 @@
-# Pine
+<p align="center">
+  <img src="assets/pine-app-icon.png" width="144" alt="Pine app icon">
+</p>
+
+<h1 align="center">Pine</h1>
 
 [![CI](https://github.com/batonogov/pine/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/batonogov/pine/actions/workflows/ci.yml)
 [![Release](https://img.shields.io/github/v/release/batonogov/pine)](https://github.com/batonogov/pine/releases/latest)
@@ -14,6 +18,19 @@
 
 Pine keeps CLI agents in the terminal and the code in view. It reflects agent activity, file changes, diagnostics, and Git context across a fast native workspace without turning into another AI dashboard. Built with SwiftUI and AppKit for macOS 26 Liquid Glass — no Electron runtime.
 
+## New in Pine 2.0
+
+<p align="center">
+  <img src="assets/screenshot-agent-inbox.png" width="760" alt="Pine Agent Inbox showing agent tasks across projects">
+</p>
+
+- **Cross-project Agent Inbox** keeps durable tasks together and routes back to the exact live session
+- **Safer agent workflows** add isolated worktrees, task recovery, and evidence-based completion briefs
+- **Useful signals without surveillance** provide actionable, privacy-bounded notifications and first-party CLI-agent adapters
+- **A polished release experience** brings a branded DMG installer and Pine's new app icon
+
+See the [Pine 2.0 release notes](https://github.com/batonogov/pine/releases/tag/v2.0.0) for the complete changelog.
+
 ## Features
 
 - **Native macOS** — SwiftUI + AppKit, Liquid Glass UI, system text handling. No browser engine, no runtime