@aaronshaf/plane 0.1.5 → 0.1.6

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "CLI for the Plane project management API",
   "keywords": [
     "plane",

package/src/commands/issue.ts

@@ -11,9 +11,10 @@ import {
 	WorklogSchema,
 } from "../config.js";
 import {
-	parseIssueRef,
 	findIssueBySeq,
+	getMemberId,
 	getStateId,
+	parseIssueRef,
 	resolveProject,
 } from "../resolve.js";
 import { jsonMode, xmlMode, toXml } from "../output.js";
@@ -51,15 +52,26 @@ const descriptionOption = Options.optional(Options.text("description")).pipe(
 	Options.withDescription("Issue description (plain text, stored as HTML)"),
 );
 
+const assigneeOption = Options.optional(Options.text("assignee")).pipe(
+	Options.withDescription("Assign to a member (display name, email, or UUID)"),
+);
+
+const noAssigneeOption = Options.boolean("no-assignee").pipe(
+	Options.withDescription("Clear all assignees"),
+	Options.withDefault(false),
+);
+
 export const issueUpdate = Command.make(
 	"update",
 	{
 		state: stateOption,
 		priority: priorityOption,
 		description: descriptionOption,
+		assignee: assigneeOption,
+		noAssignee: noAssigneeOption,
 		ref: refArg,
 	},
-	({ ref, state, priority, description }) =>
+	({ ref, state, priority, description, assignee, noAssignee }) =>
 		Effect.gen(function* () {
 			const { projectId, seq } = yield* parseIssueRef(ref);
 			const issue = yield* findIssueBySeq(projectId, seq);
@@ -76,11 +88,17 @@ export const issueUpdate = Command.make(
 				const escaped = escapeHtmlText(description.value);
 				body["description_html"] = `<p>${escaped}</p>`;
 			}
+			if (noAssignee) {
+				body["assignees"] = [];
+			} else if (assignee._tag === "Some") {
+				const memberId = yield* getMemberId(assignee.value);
+				body["assignees"] = [memberId];
+			}
 
 			if (Object.keys(body).length === 0) {
 				yield* Effect.fail(
 					new Error(
-						"Nothing to update. Specify --state, --priority, or --description",
+						"Nothing to update. Specify --state, --priority, --description, --assignee, or --no-assignee",
 					),
 				);
 			}
@@ -96,7 +114,7 @@ export const issueUpdate = Command.make(
 		}),
 ).pipe(
 	Command.withDescription(
-		'Update an issue\'s state, priority, or description. Options must come before the REF argument.\n\nExamples:\n  plane issue update --state completed PROJ-29\n  plane issue update --priority high WEB-5\n  plane issue update --description "New description" PROJ-29\n  plane issue update --state started --priority medium OPS-3',
+		'Update an issue\'s state, priority, description, or assignee. Options must come before the REF argument.\n\nExamples:\n  plane issue update --state completed PROJ-29\n  plane issue update --priority high WEB-5\n  plane issue update --assignee "Jane Doe" PROJ-29\n  plane issue update --no-assignee PROJ-29\n  plane issue update --description "New description" PROJ-29',
 	),
 );
 
@@ -148,16 +166,21 @@ const createDescriptionOption = Options.optional(
 	Options.withDescription("Issue description (plain text, stored as HTML)"),
 );
 
+const createAssigneeOption = Options.optional(Options.text("assignee")).pipe(
+	Options.withDescription("Assign to a member (display name, email, or UUID)"),
+);
+
 export const issueCreate = Command.make(
 	"create",
 	{
 		priority: createPriorityOption,
 		state: createStateOption,
 		description: createDescriptionOption,
+		assignee: createAssigneeOption,
 		project: projectRefArg,
 		title: titleArg,
 	},
-	({ project, title, priority, state, description }) =>
+	({ project, title, priority, state, description, assignee }) =>
 		Effect.gen(function* () {
 			const { key, id: projectId } = yield* resolveProject(project);
 			const body: Record<string, unknown> = { name: title };
@@ -168,6 +191,10 @@ export const issueCreate = Command.make(
 				const escaped = escapeHtmlText(description.value);
 				body["description_html"] = `<p>${escaped}</p>`;
 			}
+			if (assignee._tag === "Some") {
+				const memberId = yield* getMemberId(assignee.value);
+				body["assignees"] = [memberId];
+			}
 			const raw = yield* api.post(`projects/${projectId}/issues/`, body);
 			const created = yield* decodeOrFail(IssueSchema, raw);
 			yield* Console.log(
@@ -176,7 +203,7 @@ export const issueCreate = Command.make(
 		}),
 ).pipe(
 	Command.withDescription(
-		'Create a new issue in a project.\n\nExamples:\n  plane issue create PROJ "Migrate Button component"\n  plane issue create --priority high --state started PROJ "Fix lint pipeline"\n  plane issue create --description "Detailed context here" PROJ "Add dark mode"',
+		'Create a new issue in a project.\n\nExamples:\n  plane issue create PROJ "Migrate Button component"\n  plane issue create --priority high --state started PROJ "Fix lint pipeline"\n  plane issue create --description "Detailed context here" PROJ "Add dark mode"\n  plane issue create --assignee "Jane Doe" PROJ "Onboarding bug"',
 	),
 );
 

package/src/resolve.ts

@@ -2,8 +2,9 @@ import { Effect } from "effect";
 import { api, decodeOrFail } from "./api.js";
 import {
 	IssuesResponseSchema,
-	StatesResponseSchema,
+	MembersResponseSchema,
 	ProjectsResponseSchema,
+	StatesResponseSchema,
 } from "./config.js";
 
 // Cache project list within a process invocation
@@ -74,6 +75,27 @@ export function findIssueBySeq(projectId: string, seq: number) {
 	});
 }
 
+export function getMemberId(nameEmailOrId: string) {
+	return Effect.gen(function* () {
+		const results = yield* decodeOrFail(
+			MembersResponseSchema,
+			yield* api.get("members/"),
+		);
+		const lower = nameEmailOrId.toLowerCase();
+		const member = results.find(
+			(m) =>
+				m.id === nameEmailOrId ||
+				m.display_name.toLowerCase() === lower ||
+				(m.email ?? "").toLowerCase() === lower,
+		);
+		if (!member)
+			return yield* Effect.fail(
+				new Error(`Member not found: ${nameEmailOrId}`),
+			);
+		return member.id;
+	});
+}
+
 export function getStateId(projectId: string, nameOrGroup: string) {
 	return Effect.gen(function* () {
 		const raw = yield* api.get(`projects/${projectId}/states/`);

package/tests/issue-commands.test.ts

@@ -41,6 +41,15 @@ const STATES = [
 	{ id: "s-todo", name: "Todo", group: "unstarted" },
 ];
 
+const MEMBERS = [
+	{
+		id: "m-alice",
+		display_name: "Alice",
+		email: "alice@example.com",
+	},
+	{ id: "m-bob", display_name: "Bob", email: "bob@example.com" },
+];
+
 const server = setupServer(
 	http.get(`${BASE}/api/v1/workspaces/${WS}/projects/`, () =>
 		HttpResponse.json({ results: PROJECTS }),
@@ -51,6 +60,9 @@ const server = setupServer(
 	http.get(`${BASE}/api/v1/workspaces/${WS}/projects/proj-acme/states/`, () =>
 		HttpResponse.json({ results: STATES }),
 	),
+	http.get(`${BASE}/api/v1/workspaces/${WS}/members/`, () =>
+		HttpResponse.json(MEMBERS),
+	),
 );
 
 beforeAll(() => server.listen({ onUnhandledRequest: "error" }));
@@ -120,6 +132,8 @@ describe("issueUpdate", () => {
 					state: { _tag: "Some", value: "completed" },
 					priority: { _tag: "None" },
 					description: { _tag: "None" },
+					assignee: { _tag: "None" },
+					noAssignee: false,
 				}),
 			);
 		} finally {
@@ -158,6 +172,8 @@ describe("issueUpdate", () => {
 					state: { _tag: "None" },
 					priority: { _tag: "Some", value: "urgent" },
 					description: { _tag: "None" },
+					assignee: { _tag: "None" },
+					noAssignee: false,
 				}),
 			);
 		} finally {
@@ -176,6 +192,8 @@ describe("issueUpdate", () => {
 					state: { _tag: "None" },
 					priority: { _tag: "None" },
 					description: { _tag: "None" },
+					assignee: { _tag: "None" },
+					noAssignee: false,
 				}),
 			),
 		);
@@ -278,6 +296,7 @@ describe("issueCreate", () => {
 					priority: { _tag: "None" },
 					state: { _tag: "None" },
 					description: { _tag: "None" },
+					assignee: { _tag: "None" },
 				}),
 			);
 		} finally {
@@ -318,6 +337,7 @@ describe("issueCreate", () => {
 					priority: { _tag: "Some", value: "high" },
 					state: { _tag: "Some", value: "completed" },
 					description: { _tag: "None" },
+					assignee: { _tag: "None" },
 				}),
 			);
 		} finally {
@@ -355,6 +375,7 @@ describe("issueCreate description", () => {
 				priority: { _tag: "None" },
 				state: { _tag: "None" },
 				description: { _tag: "Some", value: "Some context here" },
+				assignee: { _tag: "None" },
 			}),
 		);
 
@@ -389,6 +410,7 @@ describe("issueCreate description", () => {
 				priority: { _tag: "None" },
 				state: { _tag: "None" },
 				description: { _tag: "Some", value: "<script>alert(1)</script>" },
+				assignee: { _tag: "None" },
 			}),
 		);
 
@@ -423,6 +445,8 @@ describe("issueUpdate description", () => {
 				state: { _tag: "None" },
 				priority: { _tag: "None" },
 				description: { _tag: "Some", value: "Updated description" },
+				assignee: { _tag: "None" },
+				noAssignee: false,
 			}),
 		);
 
@@ -456,6 +480,8 @@ describe("issueUpdate description", () => {
 				state: { _tag: "None" },
 				priority: { _tag: "None" },
 				description: { _tag: "Some", value: "<b>bold</b>" },
+				assignee: { _tag: "None" },
+				noAssignee: false,
 			}),
 		);
 
@@ -464,6 +490,142 @@ describe("issueUpdate description", () => {
 	});
 });
 
+describe("issueUpdate assignee", () => {
+	it("sets assignee by display name", async () => {
+		let patchedBody: unknown;
+		server.use(
+			http.patch(
+				`${BASE}/api/v1/workspaces/${WS}/projects/proj-acme/issues/i1/`,
+				async ({ request }) => {
+					patchedBody = await request.json();
+					return HttpResponse.json({
+						id: "i1",
+						sequence_id: 29,
+						name: "Migrate Button",
+						priority: "high",
+						state: "s1",
+					});
+				},
+			),
+		);
+
+		const { issueUpdate } = await import("@/commands/issue");
+		await Effect.runPromise(
+			(issueUpdate as any).handler({
+				ref: "ACME-29",
+				state: { _tag: "None" },
+				priority: { _tag: "None" },
+				description: { _tag: "None" },
+				assignee: { _tag: "Some", value: "Alice" },
+				noAssignee: false,
+			}),
+		);
+
+		expect((patchedBody as any).assignees).toEqual(["m-alice"]);
+	});
+
+	it("clears assignees with --no-assignee", async () => {
+		let patchedBody: unknown;
+		server.use(
+			http.patch(
+				`${BASE}/api/v1/workspaces/${WS}/projects/proj-acme/issues/i1/`,
+				async ({ request }) => {
+					patchedBody = await request.json();
+					return HttpResponse.json({
+						id: "i1",
+						sequence_id: 29,
+						name: "Migrate Button",
+						priority: "high",
+						state: "s1",
+					});
+				},
+			),
+		);
+
+		const { issueUpdate } = await import("@/commands/issue");
+		await Effect.runPromise(
+			(issueUpdate as any).handler({
+				ref: "ACME-29",
+				state: { _tag: "None" },
+				priority: { _tag: "None" },
+				description: { _tag: "None" },
+				assignee: { _tag: "None" },
+				noAssignee: true,
+			}),
+		);
+
+		expect((patchedBody as any).assignees).toEqual([]);
+	});
+
+	it("resolves assignee by email", async () => {
+		let patchedBody: unknown;
+		server.use(
+			http.patch(
+				`${BASE}/api/v1/workspaces/${WS}/projects/proj-acme/issues/i1/`,
+				async ({ request }) => {
+					patchedBody = await request.json();
+					return HttpResponse.json({
+						id: "i1",
+						sequence_id: 29,
+						name: "Migrate Button",
+						priority: "high",
+						state: "s1",
+					});
+				},
+			),
+		);
+
+		const { issueUpdate } = await import("@/commands/issue");
+		await Effect.runPromise(
+			(issueUpdate as any).handler({
+				ref: "ACME-29",
+				state: { _tag: "None" },
+				priority: { _tag: "None" },
+				description: { _tag: "None" },
+				assignee: { _tag: "Some", value: "bob@example.com" },
+				noAssignee: false,
+			}),
+		);
+
+		expect((patchedBody as any).assignees).toEqual(["m-bob"]);
+	});
+});
+
+describe("issueCreate assignee", () => {
+	it("sets assignee by display name on create", async () => {
+		let postedBody: unknown;
+		server.use(
+			http.post(
+				`${BASE}/api/v1/workspaces/${WS}/projects/proj-acme/issues/`,
+				async ({ request }) => {
+					postedBody = await request.json();
+					return HttpResponse.json({
+						id: "new-assignee",
+						sequence_id: 300,
+						name: (postedBody as any).name,
+						priority: "none",
+						state: "s1",
+					});
+				},
+			),
+		);
+
+		const { issueCreate } = await import("@/commands/issue");
+		await Effect.runPromise(
+			(issueCreate as any).handler({
+				project: "ACME",
+				title: "Assigned issue",
+				priority: { _tag: "None" },
+				state: { _tag: "None" },
+				description: { _tag: "None" },
+				assignee: { _tag: "Some", value: "Alice" },
+			}),
+		);
+
+		expect((postedBody as any).assignees).toEqual(["m-alice"]);
+	});
+});
+
 describe("issueDelete", () => {
 	it("deletes an issue", async () => {
 		let deleted = false;