2 files changed, 101 insertions, 4 deletions

diff --git a/src/features/workspaces/adapter/http.test.ts b/src/features/workspaces/adapter/http.test.ts
index 18d8939..2e34822 100644
--- a/src/features/workspaces/adapter/http.test.ts
+++ b/src/features/workspaces/adapter/http.test.ts
@@ -186,4 +186,67 @@ describe("createWorkspaceHttp", () => {
     const result = await http.unstar("a");
     expect(result).toEqual({ ok: false, error: "Failed to unstar workspace" });
   });
+
+  it("list passes the archived filter as a query param", async () => {
+    const fetchImpl = fakeFetch([{ body: { workspaces: [] } }]);
+    const http = createWorkspaceHttp(BASE, fetchImpl);
+    await http.list("true");
+    expect(fetchImpl).toHaveBeenCalledWith(`${BASE}/workspaces?archived=true`);
+  });
+
+  it("list omits the query param when no filter is given", async () => {
+    const fetchImpl = fakeFetch([{ body: { workspaces: [] } }]);
+    const http = createWorkspaceHttp(BASE, fetchImpl);
+    await http.list();
+    expect(fetchImpl).toHaveBeenCalledWith(`${BASE}/workspaces`);
+  });
+
+  it("archive PUTs /archive with no body and returns the updated workspace", async () => {
+    const ws = {
+      id: "a",
+      title: "A",
+      defaultCwd: null,
+      defaultComputerId: null,
+      starred: false,
+      archived: true,
+      createdAt: 1,
+      lastActivityAt: 2,
+    };
+    const fetchImpl = fakeFetch([{ body: ws }]);
+    const http = createWorkspaceHttp(BASE, fetchImpl);
+    const result = await http.archive("a");
+    expect(result).toEqual({ ok: true, value: ws });
+    const call = (fetchImpl as unknown as ReturnType<typeof vi.fn>).mock.calls[0];
+    expect(call?.[0]).toBe(`${BASE}/workspaces/a/archive`);
+    expect(call?.[1]).toEqual({ method: "PUT" });
+  });
+
+  it("unarchive DELETEs /archive with no body and returns the updated workspace", async () => {
+    const ws = {
+      id: "a",
+      title: "A",
+      defaultCwd: null,
+      defaultComputerId: null,
+      starred: false,
+      archived: false,
+      createdAt: 1,
+      lastActivityAt: 2,
+    };
+    const fetchImpl = fakeFetch([{ body: ws }]);
+    const http = createWorkspaceHttp(BASE, fetchImpl);
+    const result = await http.unarchive("a");
+    expect(result).toEqual({ ok: true, value: ws });
+    const call = (fetchImpl as unknown as ReturnType<typeof vi.fn>).mock.calls[0];
+    expect(call?.[0]).toBe(`${BASE}/workspaces/a/archive`);
+    expect(call?.[1]).toEqual({ method: "DELETE" });
+  });
+
+  it("archive surfaces the backend error on a 409 (default workspace)", async () => {
+    const http = createWorkspaceHttp(
+      BASE,
+      fakeFetch([{ status: 409, body: { error: 'The "default" workspace cannot be archived' } }]),
+    );
+    const result = await http.archive("default");
+    expect(result).toEqual({ ok: false, error: 'The "default" workspace cannot be archived' });
+  });
 });
diff --git a/src/features/workspaces/adapter/http.ts b/src/features/workspaces/adapter/http.ts
index 5673881..de95a61 100644
--- a/src/features/workspaces/adapter/http.ts
+++ b/src/features/workspaces/adapter/http.ts
@@ -19,7 +19,7 @@ import type {
  * safe empty/null on failure (non-fatal — the UI falls back gracefully).
  *
  * Endpoints ([email protected]):
- * - `GET /workspaces` → list
+ * - `GET /workspaces` (optional `?archived=true|false|all`, default `false` = active only) → list
  * - `PUT /workspaces/:id` (create-on-miss, idempotent) → ensure
  * - `GET /workspaces/:id` (404 → null) → get
  * - `PUT /workspaces/:id/title` → rename
@@ -27,14 +27,19 @@ import type {
  * - `PUT /workspaces/:id/default-computer` → set/clear default computer (SSH handoff #2)
  * - `PUT /workspaces/:id/star` (create-on-miss) → star (concurrency priority)
  * - `DELETE /workspaces/:id/star` (create-on-miss) → unstar
+ * - `PUT /workspaces/:id/archive` (create-on-miss; 409 for "default") → archive (hide from home grid)
+ * - `DELETE /workspaces/:id/archive` (create-on-miss; 409 for "default") → unarchive
  * - `DELETE /workspaces/:id` (409 for "default") → delete
  */
 export type WorkspaceResult<T> =
   | { readonly ok: true; readonly value: T }
   | { readonly ok: false; readonly error: string };
 
+/** Which workspaces `GET /workspaces` returns: active-only (default), archived-only, or all. */
+export type WorkspaceArchivedFilter = "true" | "false" | "all";
+
 export interface WorkspaceHttp {
-  list(): Promise<readonly WorkspaceEntry[]>;
+  list(archived?: WorkspaceArchivedFilter): Promise<readonly WorkspaceEntry[]>;
   ensure(id: string, body?: EnsureWorkspaceRequest): Promise<WorkspaceResult<Workspace>>;
   get(id: string): Promise<Workspace | null>;
   setTitle(id: string, title: string): Promise<WorkspaceResult<Workspace>>;
@@ -44,6 +49,10 @@ export interface WorkspaceHttp {
   star(id: string): Promise<WorkspaceResult<Workspace>>;
   /** Unstar a workspace. Create-on-miss; no body. */
   unstar(id: string): Promise<WorkspaceResult<Workspace>>;
+  /** Archive a workspace (hide from the home grid; data untouched). Create-on-miss; no body. */
+  archive(id: string): Promise<WorkspaceResult<Workspace>>;
+  /** Unarchive a workspace (restore to the home grid). Create-on-miss; no body. */
+  unarchive(id: string): Promise<WorkspaceResult<Workspace>>;
   delete(id: string): Promise<WorkspaceResult<{ closedCount: number }>>;
 }
 
@@ -58,9 +67,10 @@ async function errText(res: Response): Promise<string> {
 
 export function createWorkspaceHttp(httpBase: string, fetchImpl: typeof fetch): WorkspaceHttp {
   return {
-    async list(): Promise<readonly WorkspaceEntry[]> {
+    async list(archived?: WorkspaceArchivedFilter): Promise<readonly WorkspaceEntry[]> {
       try {
-        const res = await fetchImpl(`${httpBase}/workspaces`);
+        const qs = archived !== undefined ? `?archived=${archived}` : "";
+        const res = await fetchImpl(`${httpBase}/workspaces${qs}`);
         if (!res.ok) return [];
         const data = (await res.json()) as WorkspaceListResponse;
         return data.workspaces;
@@ -171,6 +181,30 @@ export function createWorkspaceHttp(httpBase: string, fetchImpl: typeof fetch):
       }
     },
 
+    async archive(id): Promise<WorkspaceResult<Workspace>> {
+      try {
+        const res = await fetchImpl(`${httpBase}/workspaces/${encodeURIComponent(id)}/archive`, {
+          method: "PUT",
+        });
+        if (!res.ok) return { ok: false, error: await errText(res) };
+        return { ok: true, value: (await res.json()) as WorkspaceResponse };
+      } catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : "Archive failed" };
+      }
+    },
+
+    async unarchive(id): Promise<WorkspaceResult<Workspace>> {
+      try {
+        const res = await fetchImpl(`${httpBase}/workspaces/${encodeURIComponent(id)}/archive`, {
+          method: "DELETE",
+        });
+        if (!res.ok) return { ok: false, error: await errText(res) };
+        return { ok: true, value: (await res.json()) as WorkspaceResponse };
+      } catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : "Unarchive failed" };
+      }
+    },
+
     async delete(id): Promise<WorkspaceResult<{ closedCount: number }>> {
       try {
         const res = await fetchImpl(`${httpBase}/workspaces/${encodeURIComponent(id)}`, {