alpic 0.0.0-dev.gf80bbbb → 0.0.0-dev.gf881e70

package/README.md

@@ -18,6 +18,8 @@ Full documentation: **https://docs.alpic.ai/cli/overview**
 | `logs` | Monitor runtime logs |
 | `insights intent list` | List grouped user intents |
 | `insights feedback list` | List user feedback |
+| `insights category list\|create\|update\|delete` | Manage intent categories |
+| `insights category link\|unlink` | Assign intent categories to intents |
 | `publish` | Share an MCP server to the registry |
 | `telemetry enable\|disable\|status` | Manage usage reporting |
 | `tunnel` | Expose local server to the internet |

package/dist/__tests__/insights-category.e2e.test.d.ts

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

package/dist/__tests__/insights-category.e2e.test.js

@@ -0,0 +1,248 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import { cliSession, createConfigFile, expectSuccessfulApiCall, registerCliE2ELifecycle } from "./utils.js";
+const ENV_ID = "env-insights-category-test";
+const PROJECT_ID = "prj-insights-category-test";
+const TEAM_ID = "mock-team-id";
+describe("alpic insights category (E2E)", () => {
+    const context = registerCliE2ELifecycle({
+        projects: [
+            {
+                projectId: PROJECT_ID,
+                teamId: TEAM_ID,
+                projectName: "insights-category-project",
+                environmentId: ENV_ID,
+                environmentName: "production",
+            },
+        ],
+    });
+    let mockServer;
+    let serverUrl;
+    let cwd;
+    let binPath;
+    beforeEach(() => {
+        ({ mockServer, serverUrl, cwd, binPath } = context);
+        mockServer.setIntents(ENV_ID, [
+            {
+                id: "group-1",
+                intentIds: ["intent-1", "intent-2"],
+                environmentId: ENV_ID,
+                message: "Schedule a meeting with the product team",
+                toolName: "create-event",
+                createdAt: new Date("2026-08-12T10:00:00.000Z"),
+                occurrenceCount: 2,
+                clientName: "Claude Desktop",
+                clientId: "claude-desktop",
+                categories: [],
+            },
+            {
+                id: "group-2",
+                intentIds: ["intent-3"],
+                environmentId: ENV_ID,
+                message: "Find the latest release notes",
+                toolName: "search",
+                createdAt: new Date("2026-08-12T09:00:00.000Z"),
+                occurrenceCount: 1,
+                clientName: null,
+                clientId: null,
+                categories: [],
+            },
+        ]);
+        mockServer.setIntentCategories(ENV_ID, [
+            {
+                id: "cat-scheduling",
+                createdAt: new Date("2026-08-10T00:00:00.000Z"),
+                environmentId: ENV_ID,
+                name: "Scheduling",
+                color: "blue",
+                linkedIntentIds: ["intent-1", "intent-2"],
+            },
+            {
+                id: "cat-search",
+                createdAt: new Date("2026-08-11T00:00:00.000Z"),
+                environmentId: ENV_ID,
+                name: "Search",
+                color: "purple",
+            },
+        ]);
+    });
+    const env = () => ({ ALPIC_API_BASE_URL: serverUrl, ALPIC_API_KEY: "test-api-key" });
+    it("lists categories with link counts using the local environment", async () => {
+        createConfigFile(cwd, PROJECT_ID, TEAM_ID, "insights-category-project", ENV_ID, "production");
+        const { exitCode, output } = await cliSession(process.execPath, [binPath, "insights", "category", "list"], {
+            cwd,
+            env: env(),
+        });
+        expect(exitCode).toBe(0);
+        expect(output).toContain("Found 2 categories");
+        expect(output).toContain("Scheduling");
+        expect(output).toContain("blue");
+        expect(output).toContain("cat-scheduling");
+        expectSuccessfulApiCall(mockServer.getLastCall("GET", /\/v1\/environments\/.*\/intent-categories$/));
+    });
+    it("emits category JSON with link counts", async () => {
+        const { exitCode, output } = await cliSession(process.execPath, [binPath, "insights", "category", "list", "--environment-id", ENV_ID, "--json", "--non-interactive"], { cwd, env: env() });
+        expect(exitCode).toBe(0);
+        const json = output.trim().split("\n").at(-1);
+        const parsed = JSON.parse(json ?? "");
+        expect(parsed).toEqual([
+            { id: "cat-scheduling", name: "Scheduling", color: "blue", intentCount: 2 },
+            { id: "cat-search", name: "Search", color: "purple", intentCount: 0 },
+        ]);
+    });
+    it("creates a category with a color and linked intents", async () => {
+        const { exitCode, output } = await cliSession(process.execPath, [
+            binPath,
+            "insights",
+            "category",
+            "create",
+            "--environment-id",
+            ENV_ID,
+            "--name",
+            "Releases",
+            "--color",
+            "green",
+            "--intent-id",
+            "intent-3",
+            "--json",
+        ], { cwd, env: env() });
+        expect(exitCode).toBe(0);
+        expect(output).toContain("Created Releases (green)");
+        const call = mockServer.getLastCall("POST", /\/v1\/environments\/.*\/intent-categories$/);
+        expectSuccessfulApiCall(call);
+        expect(call.input).toMatchObject({ name: "Releases", color: "green", intentIds: ["intent-3"] });
+        const json = JSON.parse(output.trim().split("\n").at(-1) ?? "");
+        expect(json).toMatchObject({ name: "Releases", color: "green", environmentId: ENV_ID });
+        expect(json.createdAt).toBe("2026-08-13T00:00:00.000Z");
+    });
+    it("requires --name to create in non-interactive mode", async () => {
+        const { exitCode, output } = await cliSession(process.execPath, [binPath, "insights", "category", "create", "--environment-id", ENV_ID, "--non-interactive"], { cwd, env: env() });
+        expect(exitCode).toBe(1);
+        expect(output).toContain("--name is required in non-interactive mode.");
+    });
+    it("renames and recolors a category", async () => {
+        const { exitCode, output } = await cliSession(process.execPath, [
+            binPath,
+            "insights",
+            "category",
+            "update",
+            "--environment-id",
+            ENV_ID,
+            "--category-id",
+            "cat-search",
+            "--name",
+            "Discovery",
+            "--color",
+            "orange",
+        ], { cwd, env: env() });
+        expect(exitCode).toBe(0);
+        expect(output).toContain("Updated Discovery (orange)");
+        const call = mockServer.getLastCall("PATCH", /\/v1\/environments\/.*\/intent-categories\/cat-search$/);
+        expectSuccessfulApiCall(call);
+        expect(call.input).toMatchObject({ name: "Discovery", color: "orange" });
+    });
+    it("rejects an update without --name or --color", async () => {
+        const { exitCode, output } = await cliSession(process.execPath, [binPath, "insights", "category", "update", "--environment-id", ENV_ID, "--category-id", "cat-search"], { cwd, env: env() });
+        expect(exitCode).toBe(1);
+        expect(output).toContain("At least one of --name or --color must be provided.");
+        expect(mockServer.getCalls("PATCH", /\/intent-categories/)).toHaveLength(0);
+    });
+    it("deletes a category after interactive selection and confirmation", async () => {
+        const { exitCode, output } = await cliSession(process.execPath, [binPath, "insights", "category", "delete", "--environment-id", ENV_ID], { cwd, env: env() }, async (cli) => {
+            await cli.expect("Select a category to delete");
+            await cli.send("");
+            await cli.expect("Delete Scheduling?");
+            await cli.send("y");
+            await cli.expect("Deleted Scheduling.");
+        });
+        expect(exitCode).toBe(0);
+        expect(output).toContain("It will be unlinked from 2 intents.");
+        expectSuccessfulApiCall(mockServer.getLastCall("DELETE", /\/intent-categories\/cat-scheduling$/));
+    });
+    it("deletes without prompting in non-interactive mode", async () => {
+        const { exitCode, output } = await cliSession(process.execPath, [
+            binPath,
+            "insights",
+            "category",
+            "delete",
+            "--environment-id",
+            ENV_ID,
+            "--category-id",
+            "cat-search",
+            "--non-interactive",
+        ], { cwd, env: env() });
+        expect(exitCode).toBe(0);
+        expect(output).toContain("Deleted Search.");
+        expect(output).not.toContain("Delete Search?");
+        expectSuccessfulApiCall(mockServer.getLastCall("DELETE", /\/intent-categories\/cat-search$/));
+    });
+    it("requires --category-id to delete in non-interactive mode", async () => {
+        const { exitCode, output } = await cliSession(process.execPath, [binPath, "insights", "category", "delete", "--environment-id", ENV_ID, "--non-interactive"], { cwd, env: env() });
+        expect(exitCode).toBe(1);
+        expect(output).toContain("--category-id is required in non-interactive mode.");
+    });
+    it("links intents and reflects the category in the intent list filter", async () => {
+        const link = await cliSession(process.execPath, [
+            binPath,
+            "insights",
+            "category",
+            "link",
+            "--environment-id",
+            ENV_ID,
+            "--category-id",
+            "cat-search",
+            "--intent-id",
+            "intent-3",
+        ], { cwd, env: env() });
+        expect(link.exitCode).toBe(0);
+        expect(link.output).toContain("Linked 1 intent to Search.");
+        const call = mockServer.getLastCall("POST", /\/intent-categories\/cat-search\/link$/);
+        expectSuccessfulApiCall(call);
+        expect(call.input).toMatchObject({ intentIds: ["intent-3"] });
+        const list = await cliSession(process.execPath, [binPath, "insights", "intent", "list", "--environment-id", ENV_ID, "--category-id", "cat-search"], { cwd, env: env() });
+        expect(list.exitCode).toBe(0);
+        expect(list.output).toContain("Found 1 intent");
+        expect(list.output).toContain("Find the latest release notes");
+        expect(list.output).toContain("Search");
+    });
+    it("unlinks intents from a category", async () => {
+        const { exitCode, output } = await cliSession(process.execPath, [
+            binPath,
+            "insights",
+            "category",
+            "unlink",
+            "--environment-id",
+            ENV_ID,
+            "--category-id",
+            "cat-scheduling",
+            "--intent-id",
+            "intent-1",
+            "--intent-id",
+            "intent-2",
+        ], { cwd, env: env() });
+        expect(exitCode).toBe(0);
+        expect(output).toContain("Unlinked 2 intents from Scheduling.");
+        const call = mockServer.getLastCall("POST", /\/intent-categories\/cat-scheduling\/unlink$/);
+        expectSuccessfulApiCall(call);
+        expect(call.input).toMatchObject({ intentIds: ["intent-1", "intent-2"] });
+    });
+    it("reports unknown categories and environments", async () => {
+        const unknownCategory = await cliSession(process.execPath, [
+            binPath,
+            "insights",
+            "category",
+            "update",
+            "--environment-id",
+            ENV_ID,
+            "--category-id",
+            "missing",
+            "--name",
+            "X",
+        ], { cwd, env: env() });
+        expect(unknownCategory.exitCode).toBe(1);
+        expect(unknownCategory.output).toContain('Intent category "missing" not found in this environment.');
+        const unknownEnvironment = await cliSession(process.execPath, [binPath, "insights", "category", "list", "--environment-id", "missing"], { cwd, env: env() });
+        expect(unknownEnvironment.exitCode).toBe(1);
+        expect(unknownEnvironment.output).toContain("Environment not found");
+    });
+});
+//# sourceMappingURL=insights-category.e2e.test.js.map

package/dist/__tests__/insights-category.e2e.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights-category.e2e.test.js","sourceRoot":"","sources":["../../src/__tests__/insights-category.e2e.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/mock-api.d.ts

@@ -18,6 +18,9 @@ type MockTunnelTicket = {
 };
 type MockIntents = RouterOutput["intents"]["list"]["v1"];
 type MockFeedbacks = RouterOutput["feedbacks"]["list"]["v1"];
+type MockIntentCategory = RouterOutput["intentCategories"]["create"]["v1"] & {
+    linkedIntentIds: Set<string>;
+};
 export type ApiCall = {
     method: string;
     path: string;
@@ -53,6 +56,13 @@ export declare class MockApiServer {
     setBeaconGetResponses(responses: BeaconGetResponse[]): void;
     setPlayground(environmentId: string, playground: MockPlaygroundData): void;
     setIntents(environmentId: string, intents: MockIntents["intents"]): void;
+    setIntentCategories(environmentId: string, categories: Array<Omit<MockIntentCategory, "linkedIntentIds"> & {
+        linkedIntentIds?: string[];
+    }>): void;
+    private requireMockEnvironmentCategories;
+    private requireMockIntentCategory;
+    private requireMockIntents;
+    private removeCategoryFromIntents;
     setFeedbacks(environmentId: string, feedbacks: MockFeedbacks["feedbacks"]): void;
     addProject(project: RouterOutput["projects"]["get"]["v1"]): void;
 }

package/dist/__tests__/mock-api.js

@@ -27,6 +27,8 @@ function createEmptyMockData() {
         teamUsages: new Map(),
         intents: new Map(),
         feedbacks: new Map(),
+        intentCategories: new Map(),
+        intentCategoryCounter: 0,
     };
 }
 const __testDirname = dirname(fileURLToPath(import.meta.url));
@@ -219,6 +221,76 @@ export class MockApiServer {
                     }),
                 },
             },
+            intentCategories: {
+                list: {
+                    v1: implement(contract.intentCategories.list.v1).handler(async ({ input }) => {
+                        const categories = this.requireMockEnvironmentCategories(input.environmentId);
+                        return categories.map(({ linkedIntentIds, ...category }) => ({
+                            ...category,
+                            intentCount: linkedIntentIds.size,
+                        }));
+                    }),
+                },
+                create: {
+                    v1: implement(contract.intentCategories.create.v1).handler(async ({ input }) => {
+                        const categories = this.requireMockEnvironmentCategories(input.environmentId);
+                        this.requireMockIntents(input.environmentId, input.intentIds ?? [], "BAD_REQUEST");
+                        const { linkedIntentIds, ...category } = {
+                            id: `cat-mock-${++this.mockData.intentCategoryCounter}`,
+                            createdAt: new Date("2026-08-13T00:00:00.000Z"),
+                            environmentId: input.environmentId,
+                            name: input.name,
+                            color: input.color ?? "gray",
+                            linkedIntentIds: new Set(input.intentIds ?? []),
+                        };
+                        categories.push({ ...category, linkedIntentIds });
+                        return category;
+                    }),
+                },
+                update: {
+                    v1: implement(contract.intentCategories.update.v1).handler(async ({ input }) => {
+                        const category = this.requireMockIntentCategory(input.environmentId, input.categoryId);
+                        category.name = input.name ?? category.name;
+                        category.color = input.color ?? category.color;
+                        const { linkedIntentIds, ...updated } = category;
+                        return updated;
+                    }),
+                },
+                delete: {
+                    v1: implement(contract.intentCategories.delete.v1).handler(async ({ input }) => {
+                        const category = this.requireMockIntentCategory(input.environmentId, input.categoryId);
+                        this.mockData.intentCategories.set(input.environmentId, (this.mockData.intentCategories.get(input.environmentId) ?? []).filter(({ id }) => id !== category.id));
+                        this.removeCategoryFromIntents(input.environmentId, category.id, null);
+                        return { success: true };
+                    }),
+                },
+                link: {
+                    v1: implement(contract.intentCategories.link.v1).handler(async ({ input }) => {
+                        const category = this.requireMockIntentCategory(input.environmentId, input.categoryId);
+                        this.requireMockIntents(input.environmentId, input.intentIds, "NOT_FOUND");
+                        for (const intentId of input.intentIds) {
+                            category.linkedIntentIds.add(intentId);
+                        }
+                        for (const intent of this.mockData.intents.get(input.environmentId) ?? []) {
+                            const isLinked = intent.intentIds.some((intentId) => category.linkedIntentIds.has(intentId));
+                            if (isLinked && !intent.categories.some(({ id }) => id === category.id)) {
+                                intent.categories.push({ id: category.id, name: category.name, color: category.color });
+                            }
+                        }
+                        return { success: true };
+                    }),
+                },
+                unlink: {
+                    v1: implement(contract.intentCategories.unlink.v1).handler(async ({ input }) => {
+                        const category = this.requireMockIntentCategory(input.environmentId, input.categoryId);
+                        for (const intentId of input.intentIds) {
+                            category.linkedIntentIds.delete(intentId);
+                        }
+                        this.removeCategoryFromIntents(input.environmentId, category.id, category.linkedIntentIds);
+                        return { success: true };
+                    }),
+                },
+            },
             feedbacks: {
                 list: {
                     v1: implement(contract.feedbacks.list.v1).handler(async ({ input }) => {
@@ -423,6 +495,30 @@ export class MockApiServer {
                         return environment;
                     }),
                 },
+                delete: {
+                    v1: implement(contract.environments.delete.v1).handler(async ({ input }) => {
+                        const environment = this.mockData.environments.get(input.environmentId);
+                        if (!environment) {
+                            throw new ORPCError("NOT_FOUND", {
+                                message: "Environment not found",
+                            });
+                        }
+                        const project = this.mockData.projects.get(environment.projectId);
+                        if (project?.productionEnvironment?.id === input.environmentId) {
+                            throw new ORPCError("BAD_REQUEST", {
+                                message: "Cannot delete the production environment of the project",
+                            });
+                        }
+                        this.mockData.environments.delete(input.environmentId);
+                        if (project) {
+                            this.mockData.projects.set(environment.projectId, {
+                                ...project,
+                                environments: project.environments.filter((env) => env.id !== input.environmentId),
+                            });
+                        }
+                        return { success: true };
+                    }),
+                },
                 getLogs: {
                     v1: implement(contract.environments.getLogs.v1).handler(async ({ input }) => {
                         const environment = this.mockData.environments.get(input.environmentId);
@@ -926,6 +1022,38 @@ export class MockApiServer {
     setIntents(environmentId, intents) {
         this.mockData.intents.set(environmentId, intents);
     }
+    setIntentCategories(environmentId, categories) {
+        this.mockData.intentCategories.set(environmentId, categories.map((category) => ({ ...category, linkedIntentIds: new Set(category.linkedIntentIds ?? []) })));
+    }
+    requireMockEnvironmentCategories(environmentId) {
+        if (!this.mockData.environments.has(environmentId)) {
+            throw new ORPCError("NOT_FOUND", { message: "Environment not found" });
+        }
+        const categories = this.mockData.intentCategories.get(environmentId) ?? [];
+        this.mockData.intentCategories.set(environmentId, categories);
+        return categories;
+    }
+    requireMockIntentCategory(environmentId, categoryId) {
+        const category = this.requireMockEnvironmentCategories(environmentId).find(({ id }) => id === categoryId);
+        if (!category) {
+            throw new ORPCError("NOT_FOUND", { message: "Intent category not found" });
+        }
+        return category;
+    }
+    requireMockIntents(environmentId, intentIds, errorCode) {
+        const knownIntentIds = new Set((this.mockData.intents.get(environmentId) ?? []).flatMap((intent) => intent.intentIds));
+        if (intentIds.some((intentId) => !knownIntentIds.has(intentId))) {
+            throw new ORPCError(errorCode, { message: "One or more intents not found" });
+        }
+    }
+    removeCategoryFromIntents(environmentId, categoryId, remainingIntentIds) {
+        for (const intent of this.mockData.intents.get(environmentId) ?? []) {
+            const stillLinked = remainingIntentIds !== null && intent.intentIds.some((intentId) => remainingIntentIds.has(intentId));
+            if (!stillLinked) {
+                intent.categories = intent.categories.filter(({ id }) => id !== categoryId);
+            }
+        }
+    }
     setFeedbacks(environmentId, feedbacks) {
         this.mockData.feedbacks.set(environmentId, feedbacks);
     }