alpic 0.0.0-staging.fe80e32 → 0.0.0-staging.ff03b3f

package/README.md

@@ -4,24 +4,6 @@ Deploy and manage your MCP servers from the command line.
 
 Full documentation: **https://docs.alpic.ai/cli/overview**
 
-## Install
-
-```bash
-npm install -g alpic
-```
-
-## Authenticate
-
-```bash
-alpic login
-```
-
-Or set an API key:
-
-```bash
-export ALPIC_API_KEY=your_api_key_here
-```
-
 ## Commands
 
 | Command | Description |
@@ -38,3 +20,53 @@ export ALPIC_API_KEY=your_api_key_here
 | `telemetry enable\|disable\|status` | Manage usage reporting |
 | `tunnel` | Expose local server to the internet |
 | `whoami` | Display current user |
+
+## Development
+
+Run `pnpm update:docs` to ensure CLI documentation stays aligned with the current CLI code before finalizing changes.
+
+For release validation, the safest way to test the current published versions is:
+
+```bash
+npx alpic@latest <command>
+npx alpic@staging <command>
+```
+
+`alpic@staging` is available for staging builds. For local development of this repository, execute `./bin/dev.js` instead of invoking a published package.
+
+### Testing locally
+
+**node-pty**: The root `postinstall` script automatically runs `chmod +x` on node-pty's `spawn-helper` binary (workaround for [microsoft/node-pty#850](https://github.com/microsoft/node-pty/issues/850)). No manual step needed, but if the `tunnel` command fails with a permission error, re-run `pnpm install`.
+
+**wellknown controller**: `alpic login` relies on OAuth discovery. The marketplace backend must be running locally and serving `http://localhost:3000/.well-known/oauth-protected-resource`. Without it, the login flow will fail.
+
+**Token management**: `alpic login` and `alpic logout` modify your stored credentials on disk. Check your current state with `alpic whoami` before and after tests to avoid accidentally clobbering your credentials.
+
+```bash
+# Point the CLI at the local API
+# Inline these env vars when running commands:
+# ALPIC_API_BASE_URL=http://localhost:3000 ALPIC_COGNITO_CLIENT_ID=2ab4khb8voo489m8qe2lj0u2lp
+alpic whoami
+alpic deploy
+```
+
+### Testing on staging
+
+```bash
+# Point the CLI at the staging API
+# Inline these env vars when running commands:
+# ALPIC_API_BASE_URL=https://api.staging.alpic.ai ALPIC_COGNITO_CLIENT_ID=2ab4khb8voo489m8qe2lj0u2lp
+alpic login   # uses staging credentials — separate from production
+alpic whoami
+alpic deploy
+```
+
+## Development Guidelines
+
+**Tests**: The CLI is heavily tested. Any change should be covered by the existing test suite, or you should add or extend tests so behavior stays protected.
+
+**Agent-first**: The CLI must work in non-TTY environments (Claude, Cursor, CI, etc.). Never call `p.spinner()` from `@clack/prompts` directly — use `createSpinner()` from `src/lib/agent-mode.ts`, which auto-detects agent mode via `@vercel/detect-agent` and falls back to plain `console.log`.
+
+**Exit handling**: Never call `process.exit()` directly from commands. Use one of the exit helpers provided by the Alpic base command so cleanup, formatting, and agent-mode behavior remain consistent.
+
+**`@clack/prompts` is for commands only**: Only command files (`src/commands/**`) and base command classes (`src/lib/alpic-command.ts`, `src/lib/base-workflow.ts`) may import `@clack/prompts` or write to the console. Library utilities in `src/lib/**` must return data — let the calling command handle output.

package/dist/__tests__/alpic-command.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/alpic-command.test.js

@@ -0,0 +1,41 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const mockIsAuthenticated = vi.fn();
+const mockOauthLogin = vi.fn();
+vi.mock("../lib/auth/auth.js", () => ({
+    isAuthenticated: () => mockIsAuthenticated(),
+    oauthLogin: () => mockOauthLogin(),
+}));
+// Must import after vi.mock so the mock is in place
+const { AlpicCommand } = await import("../lib/alpic-command.js");
+class TestCommand extends AlpicCommand {
+    static id = "test";
+    async run() {
+        await this.ensureAuthenticated({ "non-interactive": false });
+    }
+}
+describe("ensureAuthenticated", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("does nothing when already authenticated", async () => {
+        mockIsAuthenticated.mockResolvedValue(true);
+        const command = new TestCommand([], {});
+        await command.ensureAuthenticated({ "non-interactive": false });
+        expect(mockIsAuthenticated).toHaveBeenCalled();
+        expect(mockOauthLogin).not.toHaveBeenCalled();
+    });
+    it("triggers login flow when not authenticated in interactive mode", async () => {
+        mockIsAuthenticated.mockResolvedValue(false);
+        mockOauthLogin.mockResolvedValue(undefined);
+        const command = new TestCommand([], {});
+        await command.ensureAuthenticated({ "non-interactive": false });
+        expect(mockOauthLogin).toHaveBeenCalled();
+    });
+    it("exits with error when not authenticated in non-interactive mode", async () => {
+        mockIsAuthenticated.mockResolvedValue(false);
+        const command = new TestCommand([], {});
+        await expect(command.ensureAuthenticated({ "non-interactive": true })).rejects.toThrow();
+        expect(mockOauthLogin).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=alpic-command.test.js.map

package/dist/__tests__/alpic-command.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alpic-command.test.js","sourceRoot":"","sources":["../../src/__tests__/alpic-command.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9D,MAAM,mBAAmB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AACpC,MAAM,cAAc,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAE/B,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,CAAC;IACpC,eAAe,EAAE,GAAG,EAAE,CAAC,mBAAmB,EAAE;IAC5C,UAAU,EAAE,GAAG,EAAE,CAAC,cAAc,EAAE;CACnC,CAAC,CAAC,CAAC;AAEJ,oDAAoD;AACpD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAEjE,MAAM,WAAY,SAAQ,YAAY;IACpC,MAAM,CAAU,EAAE,GAAG,MAAM,CAAC;IAC5B,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/D,CAAC;;AAGH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,mBAAmB,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,EAAW,CAAC,CAAC;QACjD,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhE,MAAM,CAAC,mBAAmB,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,mBAAmB,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC7C,cAAc,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,EAAW,CAAC,CAAC;QACjD,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhE,MAAM,CAAC,cAAc,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,mBAAmB,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAE7C,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,EAAW,CAAC,CAAC;QAEjD,MAAM,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAEzF,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/audit.e2e.test.js

@@ -1,19 +1,32 @@
 import { rmSync } from "node:fs";
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { MockApiServer } from "./mock-server.js";
+import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it } from "vitest";
+import { MockApiServer } from "./mock-api.js";
 import { buildMockProject, cliSession, createConfigFile, expectSuccessfulApiCall, setupTestDirectory, } from "./utils.js";
 const TEAM_ID = "mock-team-id";
 const PROJECT_ID = "mock-project-id";
 const ENV_ID = "mock-env-id";
 const STAGING_ENV_ID = "staging-env-id";
+const DEPLOYED_DEPLOYMENT = {
+    id: "mock-deployment-id",
+    status: "deployed",
+    sourceCommitId: "abc1234",
+    sourceCommitMessage: "initial deploy",
+    completedAt: new Date(),
+};
 describe("alpic audit (E2E)", () => {
     let mockServer;
     let serverUrl;
     let cwd;
     let binPath;
-    beforeEach(async () => {
+    beforeAll(async () => {
         mockServer = new MockApiServer();
         serverUrl = await mockServer.start();
+    });
+    afterAll(async () => {
+        await mockServer.stop();
+    });
+    beforeEach(async () => {
+        mockServer.reset();
         const setup = await setupTestDirectory();
         cwd = setup.cwd;
         binPath = setup.binPath;
@@ -23,10 +36,10 @@ describe("alpic audit (E2E)", () => {
             projectName: "my-project",
             environmentId: ENV_ID,
             environmentName: "production",
+            latestDeployment: DEPLOYED_DEPLOYMENT,
         }));
     });
-    afterEach(async () => {
-        await mockServer.stop();
+    afterEach(() => {
         if (cwd) {
             rmSync(cwd, { recursive: true, force: true });
         }
@@ -43,9 +56,9 @@ describe("alpic audit (E2E)", () => {
                 await cli.expect("Beacon Report");
             });
             expect(exitCode).toBe(0);
-            const createCall = mockServer.getLastCall("POST", "/v1/beacon/analyses");
+            const createCall = mockServer.getLastCall("POST", "/v1/beacon/audits");
             expectSuccessfulApiCall(createCall, (call) => {
-                expect(call.input).toMatchObject({ targetUrl: "https://example.com/mcp" });
+                expect(call.input).toMatchObject({ targetUrl: "https://example.com/mcp", excludeCategories: ["e2e"] });
                 expect(call.input.projectId).toBeUndefined();
             });
         });
@@ -90,7 +103,7 @@ describe("alpic audit (E2E)", () => {
                 await cli.expect("Beacon Report");
             });
             expect(exitCode).toBe(0);
-            const createCall = mockServer.getLastCall("POST", "/v1/beacon/analyses");
+            const createCall = mockServer.getLastCall("POST", "/v1/beacon/audits");
             expectSuccessfulApiCall(createCall, (call) => {
                 expect(call.input).toMatchObject({
                     teamId: TEAM_ID,
@@ -124,7 +137,7 @@ describe("alpic audit (E2E)", () => {
             });
             expect(exitCode).toBe(0);
             expect(output).not.toContain("Using project config from .alpic");
-            const createCall = mockServer.getLastCall("POST", "/v1/beacon/analyses");
+            const createCall = mockServer.getLastCall("POST", "/v1/beacon/audits");
             expectSuccessfulApiCall(createCall, (call) => {
                 expect(call.input).toMatchObject({
                     projectId: PROJECT_ID,
@@ -140,8 +153,7 @@ describe("alpic audit (E2E)", () => {
                     ALPIC_API_KEY: "test-api-key",
                 },
             }, async (cli) => {
-                await cli.expect("Choose a team");
-                await cli.send("");
+                await cli.expect("Using team");
                 await cli.expect("Choose a project");
                 await cli.send("");
                 await cli.expect("Beacon Report");
@@ -156,6 +168,7 @@ describe("alpic audit (E2E)", () => {
                     projectName: "my-project",
                     environmentId: ENV_ID,
                     environmentName: "production",
+                    latestDeployment: DEPLOYED_DEPLOYMENT,
                 }),
                 environments: [
                     {
@@ -165,7 +178,7 @@ describe("alpic audit (E2E)", () => {
                         mcpServerUrl: "https://mcp-production.alpic.ai",
                         createdAt: new Date(),
                         projectId: PROJECT_ID,
-                        latestDeployment: null,
+                        latestDeployment: DEPLOYED_DEPLOYMENT,
                     },
                     {
                         id: STAGING_ENV_ID,
@@ -189,7 +202,7 @@ describe("alpic audit (E2E)", () => {
                 await cli.expect("Beacon Report");
             });
             expect(exitCode).toBe(0);
-            const createCall = mockServer.getLastCall("POST", "/v1/beacon/analyses");
+            const createCall = mockServer.getLastCall("POST", "/v1/beacon/audits");
             expectSuccessfulApiCall(createCall, (call) => {
                 expect(call.input).toMatchObject({
                     targetUrl: "https://mcp-staging.alpic.ai",
@@ -209,6 +222,180 @@ describe("alpic audit (E2E)", () => {
             });
             expect(exitCode).toBe(1);
         });
+        it("hides projects without successful deployments in interactive selection", async () => {
+            mockServer.reset();
+            mockServer.addProject(buildMockProject({
+                projectId: "deployed-project",
+                teamId: TEAM_ID,
+                projectName: "deployed-project",
+                environmentId: "deployed-env",
+                environmentName: "production",
+                latestDeployment: DEPLOYED_DEPLOYMENT,
+            }));
+            mockServer.addProject(buildMockProject({
+                projectId: "undeployed-project",
+                teamId: TEAM_ID,
+                projectName: "undeployed-project",
+                environmentId: "undeployed-env",
+                environmentName: "production",
+            }));
+            const { exitCode, output } = await cliSession(process.execPath, [binPath, "audit"], {
+                cwd,
+                env: {
+                    ALPIC_API_BASE_URL: serverUrl,
+                    ALPIC_API_KEY: "test-api-key",
+                },
+            }, async (cli) => {
+                await cli.expect("Choose a project");
+                await cli.send("");
+                await cli.expect("Beacon Report");
+            });
+            expect(exitCode).toBe(0);
+            expect(output).toContain("deployed-project");
+            expect(output).not.toContain("undeployed-project");
+        });
+        it("errors when no projects have successful deployments in interactive mode", async () => {
+            mockServer.reset();
+            mockServer.addProject(buildMockProject({
+                projectId: "failed-project",
+                teamId: TEAM_ID,
+                projectName: "failed-project",
+                environmentId: "failed-env",
+                environmentName: "production",
+            }));
+            const { exitCode } = await cliSession(process.execPath, [binPath, "audit"], {
+                cwd,
+                env: {
+                    ALPIC_API_BASE_URL: serverUrl,
+                    ALPIC_API_KEY: "test-api-key",
+                },
+            }, async (cli) => {
+                await cli.expect("No projects with a successful deployment found");
+            });
+            expect(exitCode).toBe(1);
+        });
+        it("only shows deployed environments when selecting interactively", async () => {
+            mockServer.reset();
+            const multiEnvProject = {
+                ...buildMockProject({
+                    projectId: PROJECT_ID,
+                    teamId: TEAM_ID,
+                    projectName: "my-project",
+                    environmentId: ENV_ID,
+                    environmentName: "production",
+                    latestDeployment: DEPLOYED_DEPLOYMENT,
+                }),
+                environments: [
+                    {
+                        id: ENV_ID,
+                        name: "production",
+                        sourceBranch: null,
+                        mcpServerUrl: "https://mcp-production.alpic.ai",
+                        createdAt: new Date(),
+                        projectId: PROJECT_ID,
+                        latestDeployment: DEPLOYED_DEPLOYMENT,
+                    },
+                    {
+                        id: STAGING_ENV_ID,
+                        name: "staging",
+                        sourceBranch: "develop",
+                        mcpServerUrl: "https://mcp-staging.alpic.ai",
+                        createdAt: new Date(),
+                        projectId: PROJECT_ID,
+                        latestDeployment: null,
+                    },
+                ],
+            };
+            mockServer.addProject(multiEnvProject);
+            const { exitCode, output } = await cliSession(process.execPath, [binPath, "audit", "--project-id", PROJECT_ID], {
+                cwd,
+                env: {
+                    ALPIC_API_BASE_URL: serverUrl,
+                    ALPIC_API_KEY: "test-api-key",
+                },
+            }, async (cli) => {
+                await cli.expect('Using environment "production"');
+                await cli.expect("Beacon Report");
+            });
+            expect(exitCode).toBe(0);
+            expect(output).not.toContain("staging");
+        });
+        it("errors in --non-interactive mode when production environment is not deployed but others are", async () => {
+            mockServer.reset();
+            const multiEnvProject = {
+                ...buildMockProject({
+                    projectId: PROJECT_ID,
+                    teamId: TEAM_ID,
+                    projectName: "my-project",
+                    environmentId: ENV_ID,
+                    environmentName: "production",
+                }),
+                environments: [
+                    {
+                        id: ENV_ID,
+                        name: "production",
+                        sourceBranch: null,
+                        mcpServerUrl: "https://mcp-production.alpic.ai",
+                        createdAt: new Date(),
+                        projectId: PROJECT_ID,
+                        latestDeployment: null,
+                    },
+                    {
+                        id: STAGING_ENV_ID,
+                        name: "staging",
+                        sourceBranch: "develop",
+                        mcpServerUrl: "https://mcp-staging.alpic.ai",
+                        createdAt: new Date(),
+                        projectId: PROJECT_ID,
+                        latestDeployment: DEPLOYED_DEPLOYMENT,
+                    },
+                    {
+                        id: "feature-env-id",
+                        name: "feature-x",
+                        sourceBranch: "feature-x",
+                        mcpServerUrl: "https://mcp-feature.alpic.ai",
+                        createdAt: new Date(),
+                        projectId: PROJECT_ID,
+                        latestDeployment: DEPLOYED_DEPLOYMENT,
+                    },
+                ],
+            };
+            mockServer.addProject(multiEnvProject);
+            const { exitCode } = await cliSession(process.execPath, [binPath, "audit", "--project-id", PROJECT_ID, "--non-interactive"], {
+                cwd,
+                env: {
+                    ALPIC_API_BASE_URL: serverUrl,
+                    ALPIC_API_KEY: "test-api-key",
+                },
+            }, async (cli) => {
+                await cli.expect("Multiple environments found. Use --environment-id to specify which one to audit.");
+            });
+            expect(exitCode).toBe(1);
+        });
+        it("--environment-id bypasses deployment filter and audits an undeployed environment", async () => {
+            mockServer.reset();
+            mockServer.addProject(buildMockProject({
+                projectId: PROJECT_ID,
+                teamId: TEAM_ID,
+                projectName: "my-project",
+                environmentId: ENV_ID,
+                environmentName: "production",
+            }));
+            const { exitCode } = await cliSession(process.execPath, [binPath, "audit", "--project-id", PROJECT_ID, "--environment-id", ENV_ID], {
+                cwd,
+                env: {
+                    ALPIC_API_BASE_URL: serverUrl,
+                    ALPIC_API_KEY: "test-api-key",
+                },
+            }, async (cli) => {
+                await cli.expect("Beacon Report");
+            });
+            expect(exitCode).toBe(0);
+            const createCall = mockServer.getLastCall("POST", "/v1/beacon/audits");
+            expectSuccessfulApiCall(createCall, (call) => {
+                expect(call.input).toMatchObject({ projectId: PROJECT_ID });
+            });
+        });
         it("errors in --non-interactive mode without flags or config", async () => {
             const { exitCode } = await cliSession(process.execPath, [binPath, "audit", "--non-interactive"], {
                 cwd,
@@ -222,8 +409,8 @@ describe("alpic audit (E2E)", () => {
             expect(exitCode).toBe(1);
         });
     });
-    describe("analysis lifecycle", () => {
-        it("polls until analysis completes", async () => {
+    describe("audit lifecycle", () => {
+        it("polls until audit completes", async () => {
             const pendingResponse = {
                 id: "mock-analysis-id",
                 targetUrl: "https://example.com/mcp",
@@ -249,6 +436,8 @@ describe("alpic audit (E2E)", () => {
                     requiresAuth: false,
                     hasViewSupport: false,
                     isReadyForPlatform: { chatgpt: true, claudeai: true },
+                    widgetScreenshotKeys: {},
+                    widgetScreenshots: {},
                 },
             };
             mockServer.setBeaconGetResponses([pendingResponse, pendingResponse, completedResponse]);
@@ -262,10 +451,10 @@ describe("alpic audit (E2E)", () => {
                 await cli.expect("Beacon Report");
             });
             expect(exitCode).toBe(0);
-            const getCalls = mockServer.getCalls("GET", "/v1/beacon/analyses");
+            const getCalls = mockServer.getCalls("GET", "/v1/beacon/audits");
             expect(getCalls.length).toBeGreaterThanOrEqual(3);
         }, 15_000);
-        it("handles failed analysis", async () => {
+        it("handles failed audit", async () => {
             mockServer.setBeaconGetResponses([
                 {
                     id: "mock-analysis-id",
@@ -283,7 +472,7 @@ describe("alpic audit (E2E)", () => {
                     ALPIC_API_KEY: "test-api-key",
                 },
             }, async (cli) => {
-                await cli.expect("The analysis failed");
+                await cli.expect("The audit failed");
             });
             expect(exitCode).toBe(1);
         });
@@ -307,6 +496,8 @@ describe("alpic audit (E2E)", () => {
                         results: [
                             {
                                 checkId: "check-pass",
+                                checkName: "Server Responds",
+                                description: "Check server connectivity",
                                 status: "pass",
                                 message: "Server is reachable",
                                 severity: "error",
@@ -316,6 +507,8 @@ describe("alpic audit (E2E)", () => {
                             },
                             {
                                 checkId: "check-error",
+                                checkName: "Tool Description",
+                                description: "Check tool descriptions",
                                 status: "fail",
                                 message: "Missing tool description",
                                 severity: "error",
@@ -326,6 +519,8 @@ describe("alpic audit (E2E)", () => {
                             },
                             {
                                 checkId: "check-warning",
+                                checkName: "Response Time",
+                                description: "Check response time",
                                 status: "fail",
                                 message: "Slow response time",
                                 severity: "warning",
@@ -337,6 +532,8 @@ describe("alpic audit (E2E)", () => {
                         requiresAuth: false,
                         hasViewSupport: false,
                         isReadyForPlatform: { chatgpt: false, claudeai: true },
+                        widgetScreenshotKeys: {},
+                        widgetScreenshots: {},
                     },
                 },
             ]);
@@ -375,6 +572,8 @@ describe("alpic audit (E2E)", () => {
                         results: [
                             {
                                 checkId: "server-responds",
+                                checkName: "Server Responds",
+                                description: "Check server connectivity",
                                 status: "skip",
                                 message: "Server requires authentication",
                                 skipReason: "The server returned HTTP 401",
@@ -387,6 +586,8 @@ describe("alpic audit (E2E)", () => {
                         requiresAuth: true,
                         hasViewSupport: false,
                         isReadyForPlatform: { chatgpt: false, claudeai: false },
+                        widgetScreenshotKeys: {},
+                        widgetScreenshots: {},
                     },
                 },
             ]);
@@ -424,6 +625,8 @@ describe("alpic audit (E2E)", () => {
                         results: [
                             {
                                 checkId: "connectivity-check",
+                                checkName: "Server Responds",
+                                description: "Check server connectivity",
                                 status: "pass",
                                 message: "Server is reachable",
                                 severity: "error",
@@ -433,6 +636,8 @@ describe("alpic audit (E2E)", () => {
                             },
                             {
                                 checkId: "tool-description-check",
+                                checkName: "Tool Description",
+                                description: "Check tool descriptions",
                                 status: "fail",
                                 message: "Missing tool description",
                                 severity: "error",
@@ -443,6 +648,8 @@ describe("alpic audit (E2E)", () => {
                             },
                             {
                                 checkId: "response-time-check",
+                                checkName: "Response Time",
+                                description: "Check response time",
                                 status: "fail",
                                 message: "Slow response time",
                                 severity: "warning",
@@ -452,6 +659,8 @@ describe("alpic audit (E2E)", () => {
                             },
                             {
                                 checkId: "view-check",
+                                checkName: "View Support",
+                                description: "Check if the server has view support",
                                 status: "skip",
                                 message: "View support check",
                                 skipReason: "No view resources found",
@@ -464,6 +673,8 @@ describe("alpic audit (E2E)", () => {
                         requiresAuth: false,
                         hasViewSupport: false,
                         isReadyForPlatform: { chatgpt: false, claudeai: true },
+                        widgetScreenshotKeys: {},
+                        widgetScreenshots: {},
                     },
                 },
             ]);
@@ -499,6 +710,8 @@ describe("alpic audit (E2E)", () => {
                         results: [
                             {
                                 checkId: "connectivity-check",
+                                checkName: "Server Responds",
+                                description: "Check server connectivity",
                                 status: "pass",
                                 message: "Server is reachable",
                                 severity: "error",
@@ -508,6 +721,8 @@ describe("alpic audit (E2E)", () => {
                             },
                             {
                                 checkId: "tool-description-check",
+                                checkName: "Tool Description",
+                                description: "Check tool descriptions",
                                 status: "pass",
                                 message: "Tool descriptions are present",
                                 severity: "error",
@@ -519,6 +734,8 @@ describe("alpic audit (E2E)", () => {
                         requiresAuth: false,
                         hasViewSupport: false,
                         isReadyForPlatform: { chatgpt: true, claudeai: true },
+                        widgetScreenshotKeys: {},
+                        widgetScreenshots: {},
                     },
                 },
             ]);