@aaronshaf/plane 0.1.7 → 0.1.8

package/package.json

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

package/src/commands/issue.ts

@@ -12,6 +12,7 @@ import {
 } from "../config.js";
 import {
 	findIssueBySeq,
+	getEstimatePointId,
 	getLabelId,
 	getMemberId,
 	getStateId,
@@ -65,8 +66,10 @@ 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 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(
@@ -128,7 +131,10 @@ export const issueUpdate = Command.make(
 				body["label_ids"] = [labelId];
 			}
 			if (estimate._tag === "Some") {
-				body["estimate_point"] = estimate.value;
+				body["estimate_point"] = yield* getEstimatePointId(
+					projectId,
+					estimate.value,
+				);
 			}
 
 			if (Object.keys(body).length === 0) {
@@ -251,7 +257,10 @@ export const issueCreate = Command.make(
 				body["label_ids"] = [labelId];
 			}
 			if (estimate._tag === "Some") {
-				body["estimate_point"] = estimate.value;
+				body["estimate_point"] = yield* getEstimatePointId(
+					projectId,
+					estimate.value,
+				);
 			}
 			const raw = yield* api.post(`projects/${projectId}/issues/`, body);
 			const created = yield* decodeOrFail(IssueSchema, raw);

package/src/config.ts

@@ -18,7 +18,7 @@ export const IssueSchema = Schema.Struct({
 	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)),
+	estimate_point: Schema.optional(Schema.NullOr(Schema.String)),
 });
 export type Issue = typeof IssueSchema.Type;
 
@@ -215,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,6 +1,7 @@
 import { Effect } from "effect";
 import { api, decodeOrFail } from "./api.js";
 import {
+	EstimatesResponseSchema,
 	IssuesResponseSchema,
 	LabelsResponseSchema,
 	MembersResponseSchema,
@@ -111,6 +112,29 @@ export function getStateId(projectId: string, nameOrGroup: string) {
 	});
 }
 
+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/`);

package/tests/issue-commands.test.ts

@@ -65,6 +65,23 @@ const server = setupServer(
 			results: [{ id: "l-bug", name: "Bug", color: "#ff0000" }],
 		}),
 	),
+	http.get(
+		`${BASE}/api/v1/workspaces/${WS}/projects/proj-acme/estimates/`,
+		() =>
+			HttpResponse.json({
+				results: [
+					{
+						id: "est-1",
+						points: [
+							{ id: "ep-1", value: "1", key: 0 },
+							{ id: "ep-2", value: "2", key: 1 },
+							{ id: "ep-3", value: "3", key: 2 },
+							{ id: "ep-5", value: "5", key: 3 },
+						],
+					},
+				],
+			}),
+	),
 	http.get(`${BASE}/api/v1/workspaces/${WS}/members/`, () =>
 		HttpResponse.json(MEMBERS),
 	),
@@ -999,12 +1016,12 @@ describe("issueUpdate estimate", () => {
 				description: { _tag: "None" },
 				assignee: { _tag: "None" },
 				label: { _tag: "None" },
-				estimate: { _tag: "Some", value: 3 },
+				estimate: { _tag: "Some", value: "3" },
 				noAssignee: false,
 			}),
 		);
 
-		expect((patchedBody as any).estimate_point).toBe(3);
+		expect((patchedBody as any).estimate_point).toBe("ep-3");
 	});
 });
 
@@ -1037,11 +1054,11 @@ describe("issueCreate estimate", () => {
 				description: { _tag: "None" },
 				assignee: { _tag: "None" },
 				label: { _tag: "None" },
-				estimate: { _tag: "Some", value: 5 },
+				estimate: { _tag: "Some", value: "5" },
 			}),
 		);
 
-		expect((postedBody as any).estimate_point).toBe(5);
+		expect((postedBody as any).estimate_point).toBe("ep-5");
 	});
 });