From 42e8538c6185232ec7faecf50f3191582e4579f2 Mon Sep 17 00:00:00 2001
From: Devika Verma <devikaverma11@gmail.com>
Date: Sat, 22 Aug 2026 09:21:15 +0530
Subject: [PATCH] Cover the provenance line on the approval card

---
 .../gui/src/components/ApprovalCard.test.tsx  | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/surfaces/gui/src/components/ApprovalCard.test.tsx b/surfaces/gui/src/components/ApprovalCard.test.tsx
index b6715191..de2fd5dc 100644
--- a/surfaces/gui/src/components/ApprovalCard.test.tsx
+++ b/surfaces/gui/src/components/ApprovalCard.test.tsx
@@ -406,3 +406,46 @@ describe("ApprovalCard — session read-only grant", () => {
     expect(screen.queryByTestId("allow-readonly-session")).toBeNull();
   });
 });
+
+// The provenance line (OPE-114 §1): the one fact about a shell command that cannot be read
+// off its text — that the agent itself made the file it is about to run. Rendered on the
+// card as well as sent to the reviewer, because a human approving is just as blind to a
+// script's contents as the reviewer is.
+describe("ApprovalCard — file provenance", () => {
+  const shell = (extra: Partial<ApprovalItem> = {}): ApprovalItem => ({
+    kind: "approval",
+    name: "run_shell",
+    args: { command: "python scripts/setup.py" },
+    reason: "requires approval",
+    category: "shell",
+    ...extra,
+  });
+
+  it("shows the warning when the agent created the file this command runs", () => {
+    render(
+      <ApprovalCard
+        item={shell({ provenance: "scripts/setup.py was created by the agent 3 steps ago" })}
+        onApprove={vi.fn()}
+      />,
+    );
+    expect(screen.getByText(/created by the agent 3 steps ago/)).toBeTruthy();
+  });
+
+  it("says nothing about provenance for an ordinary command", () => {
+    render(<ApprovalCard item={shell()} onApprove={vi.fn()} />);
+    expect(screen.queryByText(/by the agent/)).toBeNull();
+  });
+
+  it("shows it for downloaded files too, since that is the sharper case", () => {
+    render(
+      <ApprovalCard
+        item={shell({
+          args: { command: "bash install.sh" },
+          provenance: "install.sh was downloaded by the agent 1 step ago",
+        })}
+        onApprove={vi.fn()}
+      />,
+    );
+    expect(screen.getByText(/downloaded by the agent/)).toBeTruthy();
+  });
+});