@aaronshaf/plane 0.1.6 → 0.1.8

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.6",
+  "version": "0.1.8",
   "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

@@ -12,6 +12,8 @@ import {
 } from "../config.js";
 import {
 	findIssueBySeq,
+	getEstimatePointId,
+	getLabelId,
 	getMemberId,
 	getStateId,
 	parseIssueRef,
@@ -48,6 +50,10 @@ 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)"),
 );
@@ -56,6 +62,16 @@ 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.text("estimate")).pipe(
+	Options.withDescription(
+		"Estimate point value (e.g. '3', 'Medium', 'L') — resolved to UUID from the project's estimate scheme",
+	),
+);
+
 const noAssigneeOption = Options.boolean("no-assignee").pipe(
 	Options.withDescription("Clear all assignees"),
 	Options.withDefault(false),
@@ -66,12 +82,25 @@ export const issueUpdate = Command.make(
 	{
 		state: stateOption,
 		priority: priorityOption,
+		title: titleUpdateOption,
 		description: descriptionOption,
 		assignee: assigneeOption,
+		label: labelOption,
+		estimate: estimateOption,
 		noAssignee: noAssigneeOption,
 		ref: refArg,
 	},
-	({ ref, state, priority, description, assignee, noAssignee }) =>
+	({
+		ref,
+		state,
+		priority,
+		title,
+		description,
+		assignee,
+		label,
+		estimate,
+		noAssignee,
+	}) =>
 		Effect.gen(function* () {
 			const { projectId, seq } = yield* parseIssueRef(ref);
 			const issue = yield* findIssueBySeq(projectId, seq);
@@ -84,6 +113,9 @@ 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>`;
@@ -94,11 +126,21 @@ export const issueUpdate = Command.make(
 				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"] = yield* getEstimatePointId(
+					projectId,
+					estimate.value,
+				);
+			}
 
 			if (Object.keys(body).length === 0) {
 				yield* Effect.fail(
 					new Error(
-						"Nothing to update. Specify --state, --priority, --description, --assignee, or --no-assignee",
+						"Nothing to update. Specify --state, --priority, --title, --description, --assignee, --label, --estimate, or --no-assignee",
 					),
 				);
 			}
@@ -114,7 +156,7 @@ export const issueUpdate = Command.make(
 		}),
 ).pipe(
 	Command.withDescription(
-		'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',
+		'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',
 	),
 );
 
@@ -170,6 +212,10 @@ 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",
 	{
@@ -177,10 +223,21 @@ export const issueCreate = Command.make(
 		state: createStateOption,
 		description: createDescriptionOption,
 		assignee: createAssigneeOption,
+		label: createLabelOption,
+		estimate: estimateOption,
 		project: projectRefArg,
 		title: titleArg,
 	},
-	({ project, title, priority, state, description, assignee }) =>
+	({
+		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 };
@@ -195,6 +252,16 @@ export const issueCreate = Command.make(
 				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"] = yield* getEstimatePointId(
+					projectId,
+					estimate.value,
+				);
+			}
 			const raw = yield* api.post(`projects/${projectId}/issues/`, body);
 			const created = yield* decodeOrFail(IssueSchema, raw);
 			yield* Console.log(

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.String)),
 });
 export type Issue = typeof IssueSchema.Type;
 
@@ -213,3 +215,19 @@ export type CycleIssue = typeof CycleIssueSchema.Type;
 export const CycleIssuesResponseSchema = Schema.Struct({
 	results: Schema.Array(CycleIssueSchema),
 });
+
+export const EstimatePointSchema = Schema.Struct({
+	id: Schema.String,
+	value: Schema.String,
+	key: Schema.Number,
+});
+export type EstimatePoint = typeof EstimatePointSchema.Type;
+
+export const EstimateSchema = Schema.Struct({
+	id: Schema.String,
+	points: Schema.Array(EstimatePointSchema),
+});
+
+export const EstimatesResponseSchema = Schema.Struct({
+	results: Schema.Array(EstimateSchema),
+});

package/src/resolve.ts

@@ -1,7 +1,9 @@
 import { Effect } from "effect";
 import { api, decodeOrFail } from "./api.js";
 import {
+	EstimatesResponseSchema,
 	IssuesResponseSchema,
+	LabelsResponseSchema,
 	MembersResponseSchema,
 	ProjectsResponseSchema,
 	StatesResponseSchema,
@@ -109,3 +111,38 @@ export function getStateId(projectId: string, nameOrGroup: string) {
 		return state.id;
 	});
 }
+
+export function getEstimatePointId(projectId: string, value: string) {
+	return Effect.gen(function* () {
+		const raw = yield* api.get(`projects/${projectId}/estimates/`);
+		const { results } = yield* decodeOrFail(EstimatesResponseSchema, raw);
+		if (results.length === 0)
+			return yield* Effect.fail(
+				new Error("No estimate scheme configured for this project"),
+			);
+		const points = results[0].points;
+		const lower = value.toLowerCase();
+		const point = points.find(
+			(p) => p.value.toLowerCase() === lower || String(p.key) === value,
+		);
+		if (!point)
+			return yield* Effect.fail(
+				new Error(
+					`Estimate point not found: ${value}. Available: ${points.map((p) => p.value).join(", ")}`,
+				),
+			);
+		return point.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;
+	});
+}