Confirm before Reset, and rewrite the docs for the new UI

Reset is destructive in a way its name does not advertise: rebuild_project_container deletes both project volumes, so it wipes the claude login, anything installed in the container, and every saved session transcript. It was a single unconfirmed click in the overflow menu, while the comparably destructive Remove already confirmed. Adds ConfirmResetModal, which names each loss and says explicitly that the host-side mounted folders are untouched. Docs: the user guides still described the pre-Project-Home UI. Sixteen factually wrong statements corrected, including "expand the Config panel" (six sites), the actions table (Reset and Remove are in an overflow menu, Files is a tab), a progress modal that no longer exists, a double-click-to-rename gesture ProjectRow never had, the Full Permissions boolean, an incomplete reserved-env list, and the claim in TECHNICAL.md that OAuth tokens survive a Reset. Both layout diagrams and the project tree were rebuilt from the filesystem. New sections cover permission modes with the exact CLI mapping, Project Home, Sessions, capability tiles, Automation, shared authentication, the Auth Bridge and its security posture, and keyboard shortcuts. Known gap recorded rather than papered over: the Automation tab manages existing scheduled tasks but cannot create them — no add command is registered — so task creation remains `triple-c-scheduler add` in the terminal. 87 frontend tests, 34 Rust tests, both builds clean. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-09 12:02:35 -07:00
parent d95ba54a69
commit cf3b021c72
6 changed files with 1018 additions and 161 deletions
@@ -0,0 +1,57 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { render, screen, fireEvent, act } from "@testing-library/react";
+import ConfirmResetModal from "./ConfirmResetModal";
+
+/** Modal focuses via rAF so the panel is laid out first; jsdom needs a flush. */
+async function flushFocus() {
+  await act(async () => {
+    vi.advanceTimersByTime(20);
+  });
+}
+
+describe("ConfirmResetModal", () => {
+  beforeEach(() => {
+    vi.useFakeTimers({ toFake: ["requestAnimationFrame", "setTimeout"] });
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  async function renderModal() {
+    const onConfirm = vi.fn();
+    const onCancel = vi.fn();
+    render(
+      <ConfirmResetModal
+        projectName="api-server"
+        onConfirm={onConfirm}
+        onCancel={onCancel}
+      />,
+    );
+    await flushFocus();
+    return { onConfirm, onCancel };
+  }
+
+  it("names what will be lost rather than just asking to confirm", async () => {
+    await renderModal();
+    // The whole point of the gate: Reset deletes the volumes, and the two
+    // losses users do not expect are the login and the session transcripts.
+    expect(screen.getByText(/sign in again/i)).toBeInTheDocument();
+    expect(screen.getByText(/session transcript/i)).toBeInTheDocument();
+    // And it must say what is safe, or the warning reads as "you lose everything".
+    expect(screen.getByText(/mounted project folders/i)).toBeInTheDocument();
+  });
+
+  it("does not reset until confirmed", async () => {
+    const { onConfirm, onCancel } = await renderModal();
+    fireEvent.click(screen.getByRole("button", { name: "Cancel" }));
+    expect(onCancel).toHaveBeenCalledTimes(1);
+    expect(onConfirm).not.toHaveBeenCalled();
+  });
+
+  it("resets on confirm", async () => {
+    const { onConfirm } = await renderModal();
+    fireEvent.click(screen.getByRole("button", { name: "Reset container" }));
+    expect(onConfirm).toHaveBeenCalledTimes(1);
+  });
+});