@aaronshaf/plane 0.1.5 → 0.1.7

package/package.json

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

package/src/app.ts

@@ -38,7 +38,7 @@ CONCEPTS
 ALL SUBCOMMANDS
   init                Set up config interactively
   projects list       List all projects
-  issues list         List issues (supports --state filter)
+  issues list         List issues (supports --state, --assignee, --priority)
   issue               get | create | update | delete | comment | activity |
                       link | comments | worklogs
   cycles              list | issues (list, add)

package/src/commands/issue.ts

@@ -11,9 +11,11 @@ import {
 	WorklogSchema,
 } from "../config.js";
 import {
-	parseIssueRef,
 	findIssueBySeq,
+	getLabelId,
+	getMemberId,
 	getStateId,
+	parseIssueRef,
 	resolveProject,
 } from "../resolve.js";
 import { jsonMode, xmlMode, toXml } from "../output.js";
@@ -47,19 +49,55 @@ const priorityOption = Options.optional(
 	Options.choice("priority", ["urgent", "high", "medium", "low", "none"]),
 ).pipe(Options.withDescription("Issue priority"));
 
+const titleUpdateOption = Options.optional(Options.text("title")).pipe(
+	Options.withDescription("Issue title"),
+);
+
 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 labelOption = Options.optional(Options.text("label")).pipe(
+	Options.withDescription("Set issue label by name"),
+);
+
+const estimateOption = Options.optional(Options.integer("estimate")).pipe(
+	Options.withDescription("Estimate point (0–7)"),
+);
+
+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,
+		title: titleUpdateOption,
 		description: descriptionOption,
+		assignee: assigneeOption,
+		label: labelOption,
+		estimate: estimateOption,
+		noAssignee: noAssigneeOption,
 		ref: refArg,
 	},
-	({ ref, state, priority, description }) =>
+	({
+		ref,
+		state,
+		priority,
+		title,
+		description,
+		assignee,
+		label,
+		estimate,
+		noAssignee,
+	}) =>
 		Effect.gen(function* () {
 			const { projectId, seq } = yield* parseIssueRef(ref);
 			const issue = yield* findIssueBySeq(projectId, seq);
@@ -72,15 +110,31 @@ export const issueUpdate = Command.make(
 			if (priority._tag === "Some") {
 				body["priority"] = priority.value;
 			}
+			if (title._tag === "Some") {
+				body["name"] = title.value;
+			}
 			if (description._tag === "Some") {
 				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 (label._tag === "Some") {
+				const labelId = yield* getLabelId(projectId, label.value);
+				body["label_ids"] = [labelId];
+			}
+			if (estimate._tag === "Some") {
+				body["estimate_point"] = estimate.value;
+			}
 
 			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, --title, --description, --assignee, --label, --estimate, or --no-assignee",
 					),
 				);
 			}
@@ -96,7 +150,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, title, 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 --title "New issue title" PROJ-29\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 +202,36 @@ 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)"),
+);
+
+const createLabelOption = Options.optional(Options.text("label")).pipe(
+	Options.withDescription("Set issue label by name"),
+);
+
 export const issueCreate = Command.make(
 	"create",
 	{
 		priority: createPriorityOption,
 		state: createStateOption,
 		description: createDescriptionOption,
+		assignee: createAssigneeOption,
+		label: createLabelOption,
+		estimate: estimateOption,
 		project: projectRefArg,
 		title: titleArg,
 	},
-	({ project, title, priority, state, description }) =>
+	({
+		project,
+		title,
+		priority,
+		state,
+		description,
+		assignee,
+		label,
+		estimate,
+	}) =>
 		Effect.gen(function* () {
 			const { key, id: projectId } = yield* resolveProject(project);
 			const body: Record<string, unknown> = { name: title };
@@ -168,6 +242,17 @@ 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];
+			}
+			if (label._tag === "Some") {
+				const labelId = yield* getLabelId(projectId, label.value);
+				body["label_ids"] = [labelId];
+			}
+			if (estimate._tag === "Some") {
+				body["estimate_point"] = estimate.value;
+			}
 			const raw = yield* api.post(`projects/${projectId}/issues/`, body);
 			const created = yield* decodeOrFail(IssueSchema, raw);
 			yield* Console.log(
@@ -176,7 +261,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/commands/issues.ts

@@ -3,7 +3,7 @@ import { Console, Effect } from "effect";
 import { api, decodeOrFail } from "../api.js";
 import { IssuesResponseSchema } from "../config.js";
 import { formatIssue } from "../format.js";
-import { resolveProject } from "../resolve.js";
+import { getMemberId, resolveProject } from "../resolve.js";
 import type { State } from "../config.js";
 import { jsonMode, xmlMode, toXml } from "../output.js";
 
@@ -19,24 +19,57 @@ const stateOption = Options.optional(Options.text("state")).pipe(
 	),
 );
 
+const assigneeOption = Options.optional(Options.text("assignee")).pipe(
+	Options.withDescription(
+		"Filter by assignee (display name, email, or member UUID)",
+	),
+);
+
+const priorityOption = Options.optional(
+	Options.choice("priority", ["urgent", "high", "medium", "low", "none"]),
+).pipe(Options.withDescription("Filter by priority"));
+
 export const issuesList = Command.make(
 	"list",
-	{ state: stateOption, project: projectArg },
-	({ project, state }) =>
+	{
+		state: stateOption,
+		assignee: assigneeOption,
+		priority: priorityOption,
+		project: projectArg,
+	},
+	({ project, state, assignee, priority }) =>
 		Effect.gen(function* () {
 			const { key, id } = yield* resolveProject(project);
 			const raw = yield* api.get(`projects/${id}/issues/?order_by=sequence_id`);
 			const { results } = yield* decodeOrFail(IssuesResponseSchema, raw);
 
-			const filtered =
-				state._tag === "Some"
-					? results.filter((i) => {
-							const s = i.state as State | string;
-							if (typeof s !== "object") return false;
-							const val = state.value.toLowerCase();
-							return s.group === val || s.name.toLowerCase() === val;
-						})
-					: results;
+			let filtered = results;
+
+			if (state._tag === "Some") {
+				filtered = filtered.filter((i) => {
+					const s = i.state as State | string;
+					if (typeof s !== "object") return false;
+					const val = state.value.toLowerCase();
+					return s.group === val || s.name.toLowerCase() === val;
+				});
+			}
+
+			if (assignee._tag === "Some") {
+				const isUuid =
+					/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
+						assignee.value,
+					);
+				const memberId = isUuid
+					? assignee.value
+					: yield* getMemberId(assignee.value);
+				filtered = filtered.filter(
+					(i) => Array.isArray(i.assignees) && i.assignees.includes(memberId),
+				);
+			}
+
+			if (priority._tag === "Some") {
+				filtered = filtered.filter((i) => i.priority === priority.value);
+			}
 
 			if (jsonMode) {
 				yield* Console.log(JSON.stringify(filtered, null, 2));

package/src/config.ts

@@ -16,7 +16,9 @@ export const IssueSchema = Schema.Struct({
 	name: Schema.String,
 	priority: Schema.String,
 	state: Schema.Union(Schema.String, StateSchema),
+	assignees: Schema.optional(Schema.NullOr(Schema.Array(Schema.String))),
 	description_html: Schema.optional(Schema.NullOr(Schema.String)),
+	estimate_point: Schema.optional(Schema.NullOr(Schema.Number)),
 });
 export type Issue = typeof IssueSchema.Type;
 

package/src/resolve.ts

@@ -2,8 +2,10 @@ import { Effect } from "effect";
 import { api, decodeOrFail } from "./api.js";
 import {
 	IssuesResponseSchema,
-	StatesResponseSchema,
+	LabelsResponseSchema,
+	MembersResponseSchema,
 	ProjectsResponseSchema,
+	StatesResponseSchema,
 } from "./config.js";
 
 // Cache project list within a process invocation
@@ -74,6 +76,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/`);
@@ -87,3 +110,15 @@ export function getStateId(projectId: string, nameOrGroup: string) {
 		return state.id;
 	});
 }
+
+export function getLabelId(projectId: string, name: string) {
+	return Effect.gen(function* () {
+		const raw = yield* api.get(`projects/${projectId}/labels/`);
+		const { results } = yield* decodeOrFail(LabelsResponseSchema, raw);
+		const lower = name.toLowerCase();
+		const label = results.find((l) => l.name.toLowerCase() === lower);
+		if (!label)
+			return yield* Effect.fail(new Error(`Label not found: ${name}`));
+		return label.id;
+	});
+}