@aaronshaf/plane 0.1.7 → 0.1.10

package/src/commands/issues.ts

@@ -1,5 +1,5 @@
 import { Command, Options, Args } from "@effect/cli";
-import { Console, Effect } from "effect";
+import { Console, Effect, Option } from "effect";
 import { api, decodeOrFail } from "../api.js";
 import { IssuesResponseSchema } from "../config.js";
 import { formatIssue } from "../format.js";
@@ -29,6 +29,62 @@ const priorityOption = Options.optional(
 	Options.choice("priority", ["urgent", "high", "medium", "low", "none"]),
 ).pipe(Options.withDescription("Filter by priority"));
 
+export function issuesListHandler({
+	project,
+	state,
+	assignee,
+	priority,
+}: {
+	project: string;
+	state: Option.Option<string>;
+	assignee: Option.Option<string>;
+	priority: Option.Option<string>;
+}) {
+	return 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);
+
+		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));
+			return;
+		}
+		if (xmlMode) {
+			yield* Console.log(toXml(filtered));
+			return;
+		}
+		yield* Console.log(filtered.map((i) => formatIssue(i, key)).join("\n"));
+	});
+}
+
 export const issuesList = Command.make(
 	"list",
 	{
@@ -37,50 +93,7 @@ export const issuesList = Command.make(
 		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);
-
-			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));
-				return;
-			}
-			if (xmlMode) {
-				yield* Console.log(toXml(filtered));
-				return;
-			}
-			yield* Console.log(filtered.map((i) => formatIssue(i, key)).join("\n"));
-		}),
+	issuesListHandler,
 ).pipe(
 	Command.withDescription(
 		"List issues for a project ordered by sequence ID. Each line shows: REF  [state-group]  state-name  title",

package/src/commands/labels.ts

@@ -53,8 +53,12 @@ export const labelsCreate = Command.make(
 	({ project, name, color }) =>
 		Effect.gen(function* () {
 			const { id } = yield* resolveProject(project);
-			const body: Record<string, unknown> = { name };
-			if (color._tag === "Some") body["color"] = color.value;
+			interface LabelPayload {
+				name: string;
+				color?: string;
+			}
+			const body: LabelPayload = { name };
+			if (color._tag === "Some") body.color = color.value;
 			const raw = yield* api.post(`projects/${id}/labels/`, body);
 			const label = yield* decodeOrFail(LabelSchema, raw);
 			yield* Console.log(`Created label: ${label.name} (${label.id})`);

package/src/commands/modules.ts

@@ -18,32 +18,35 @@ const moduleIdArg = Args.text({ name: "module-id" }).pipe(
 
 // --- modules list ---
 
+export function modulesListHandler({ project }: { project: string }) {
+	return Effect.gen(function* () {
+		const { id } = yield* resolveProject(project);
+		const raw = yield* api.get(`projects/${id}/modules/`);
+		const { results } = yield* decodeOrFail(ModulesResponseSchema, raw);
+		if (jsonMode) {
+			yield* Console.log(JSON.stringify(results, null, 2));
+			return;
+		}
+		if (xmlMode) {
+			yield* Console.log(toXml(results));
+			return;
+		}
+		if (results.length === 0) {
+			yield* Console.log("No modules found");
+			return;
+		}
+		const lines = results.map((m) => {
+			const status = (m.status ?? "?").padEnd(12);
+			return `${m.id}  ${status}  ${m.name}`;
+		});
+		yield* Console.log(lines.join("\n"));
+	});
+}
+
 export const modulesList = Command.make(
 	"list",
 	{ project: projectArg },
-	({ project }) =>
-		Effect.gen(function* () {
-			const { id } = yield* resolveProject(project);
-			const raw = yield* api.get(`projects/${id}/modules/`);
-			const { results } = yield* decodeOrFail(ModulesResponseSchema, raw);
-			if (jsonMode) {
-				yield* Console.log(JSON.stringify(results, null, 2));
-				return;
-			}
-			if (xmlMode) {
-				yield* Console.log(toXml(results));
-				return;
-			}
-			if (results.length === 0) {
-				yield* Console.log("No modules found");
-				return;
-			}
-			const lines = results.map((m) => {
-				const status = (m.status ?? "?").padEnd(12);
-				return `${m.id}  ${status}  ${m.name}`;
-			});
-			yield* Console.log(lines.join("\n"));
-		}),
+	modulesListHandler,
 ).pipe(
 	Command.withDescription(
 		"List modules for a project. Shows module UUID, status, and name.\n\nExample:\n  plane modules list PROJ",
@@ -52,37 +55,46 @@ export const modulesList = Command.make(
 
 // --- modules issues list ---
 
+export function moduleIssuesListHandler({
+	project,
+	moduleId,
+}: {
+	project: string;
+	moduleId: string;
+}) {
+	return Effect.gen(function* () {
+		const { key, id } = yield* resolveProject(project);
+		const raw = yield* api.get(
+			`projects/${id}/modules/${moduleId}/module-issues/`,
+		);
+		const { results } = yield* decodeOrFail(ModuleIssuesResponseSchema, raw);
+		if (jsonMode) {
+			yield* Console.log(JSON.stringify(results, null, 2));
+			return;
+		}
+		if (xmlMode) {
+			yield* Console.log(toXml(results));
+			return;
+		}
+		if (results.length === 0) {
+			yield* Console.log("No issues in module");
+			return;
+		}
+		const lines = results.map((mi) => {
+			if (mi.issue_detail) {
+				const seq = String(mi.issue_detail.sequence_id).padStart(3, " ");
+				return `${key}-${seq}  ${mi.issue_detail.name}  (${mi.id})`;
+			}
+			return `${mi.issue}  (module-issue: ${mi.id})`;
+		});
+		yield* Console.log(lines.join("\n"));
+	});
+}
+
 export const moduleIssuesList = Command.make(
 	"list",
 	{ project: projectArg, moduleId: moduleIdArg },
-	({ project, moduleId }) =>
-		Effect.gen(function* () {
-			const { key, id } = yield* resolveProject(project);
-			const raw = yield* api.get(
-				`projects/${id}/modules/${moduleId}/module-issues/`,
-			);
-			const { results } = yield* decodeOrFail(ModuleIssuesResponseSchema, raw);
-			if (jsonMode) {
-				yield* Console.log(JSON.stringify(results, null, 2));
-				return;
-			}
-			if (xmlMode) {
-				yield* Console.log(toXml(results));
-				return;
-			}
-			if (results.length === 0) {
-				yield* Console.log("No issues in module");
-				return;
-			}
-			const lines = results.map((mi) => {
-				if (mi.issue_detail) {
-					const seq = String(mi.issue_detail.sequence_id).padStart(3, " ");
-					return `${key}-${seq}  ${mi.issue_detail.name}  (${mi.id})`;
-				}
-				return `${mi.issue}  (module-issue: ${mi.id})`;
-			});
-			yield* Console.log(lines.join("\n"));
-		}),
+	moduleIssuesListHandler,
 ).pipe(
 	Command.withDescription(
 		"List issues in a module.\n\nExample:\n  plane modules issues list PROJ <module-id>",
@@ -95,22 +107,33 @@ const issueRefArg = Args.text({ name: "ref" }).pipe(
 	Args.withDescription("Issue reference to add (e.g. PROJ-29)"),
 );
 
+export function moduleIssuesAddHandler({
+	project,
+	moduleId,
+	ref,
+}: {
+	project: string;
+	moduleId: string;
+	ref: string;
+}) {
+	return Effect.gen(function* () {
+		const { id: projectId } = yield* resolveProject(project);
+		const { seq } = yield* parseIssueRef(ref);
+		const issue = yield* findIssueBySeq(projectId, seq);
+		yield* api.post(
+			`projects/${projectId}/modules/${moduleId}/module-issues/`,
+			{
+				issues: [issue.id],
+			},
+		);
+		yield* Console.log(`Added ${ref} to module ${moduleId}`);
+	});
+}
+
 export const moduleIssuesAdd = Command.make(
 	"add",
 	{ project: projectArg, moduleId: moduleIdArg, ref: issueRefArg },
-	({ project, moduleId, ref }) =>
-		Effect.gen(function* () {
-			const { id: projectId } = yield* resolveProject(project);
-			const { seq } = yield* parseIssueRef(ref);
-			const issue = yield* findIssueBySeq(projectId, seq);
-			yield* api.post(
-				`projects/${projectId}/modules/${moduleId}/module-issues/`,
-				{
-					issues: [issue.id],
-				},
-			);
-			yield* Console.log(`Added ${ref} to module ${moduleId}`);
-		}),
+	moduleIssuesAddHandler,
 ).pipe(
 	Command.withDescription(
 		"Add an issue to a module.\n\nExample:\n  plane modules issues add PROJ <module-id> PROJ-29",
@@ -125,6 +148,26 @@ const moduleIssueIdArg = Args.text({ name: "module-issue-id" }).pipe(
 	),
 );
 
+export function moduleIssuesRemoveHandler({
+	project,
+	moduleId,
+	moduleIssueId,
+}: {
+	project: string;
+	moduleId: string;
+	moduleIssueId: string;
+}) {
+	return Effect.gen(function* () {
+		const { id } = yield* resolveProject(project);
+		yield* api.delete(
+			`projects/${id}/modules/${moduleId}/module-issues/${moduleIssueId}/`,
+		);
+		yield* Console.log(
+			`Removed module-issue ${moduleIssueId} from module ${moduleId}`,
+		);
+	});
+}
+
 export const moduleIssuesRemove = Command.make(
 	"remove",
 	{
@@ -132,16 +175,7 @@ export const moduleIssuesRemove = Command.make(
 		moduleId: moduleIdArg,
 		moduleIssueId: moduleIssueIdArg,
 	},
-	({ project, moduleId, moduleIssueId }) =>
-		Effect.gen(function* () {
-			const { id } = yield* resolveProject(project);
-			yield* api.delete(
-				`projects/${id}/modules/${moduleId}/module-issues/${moduleIssueId}/`,
-			);
-			yield* Console.log(
-				`Removed module-issue ${moduleIssueId} from module ${moduleId}`,
-			);
-		}),
+	moduleIssuesRemoveHandler,
 ).pipe(
 	Command.withDescription(
 		"Remove an issue from a module using the module-issue join ID.\n\nExample:\n  plane modules issues remove PROJ <module-id> <module-issue-id>",

package/src/commands/pages.ts

@@ -11,32 +11,35 @@ const projectArg = Args.text({ name: "project" }).pipe(
 
 // --- pages list ---
 
+export function pagesListHandler({ project }: { project: string }) {
+	return Effect.gen(function* () {
+		const { id } = yield* resolveProject(project);
+		const raw = yield* api.get(`projects/${id}/pages/`);
+		const { results } = yield* decodeOrFail(PagesResponseSchema, raw);
+		if (jsonMode) {
+			yield* Console.log(JSON.stringify(results, null, 2));
+			return;
+		}
+		if (xmlMode) {
+			yield* Console.log(toXml(results));
+			return;
+		}
+		if (results.length === 0) {
+			yield* Console.log("No pages");
+			return;
+		}
+		const lines = results.map((p) => {
+			const updated = (p.updated_at ?? p.created_at).slice(0, 10);
+			return `${p.id}  ${updated}  ${p.name}`;
+		});
+		yield* Console.log(lines.join("\n"));
+	});
+}
+
 export const pagesList = Command.make(
 	"list",
 	{ project: projectArg },
-	({ project }) =>
-		Effect.gen(function* () {
-			const { id } = yield* resolveProject(project);
-			const raw = yield* api.get(`projects/${id}/pages/`);
-			const { results } = yield* decodeOrFail(PagesResponseSchema, raw);
-			if (jsonMode) {
-				yield* Console.log(JSON.stringify(results, null, 2));
-				return;
-			}
-			if (xmlMode) {
-				yield* Console.log(toXml(results));
-				return;
-			}
-			if (results.length === 0) {
-				yield* Console.log("No pages");
-				return;
-			}
-			const lines = results.map((p) => {
-				const updated = (p.updated_at ?? p.created_at).slice(0, 10);
-				return `${p.id}  ${updated}  ${p.name}`;
-			});
-			yield* Console.log(lines.join("\n"));
-		}),
+	pagesListHandler,
 ).pipe(
 	Command.withDescription(
 		"List pages for a project. Shows page UUID, last updated date, and title.\n\nExample:\n  plane pages list PROJ",
@@ -49,16 +52,25 @@ const pageIdArg = Args.text({ name: "page-id" }).pipe(
 	Args.withDescription("Page UUID (from 'plane pages list')"),
 );
 
+export function pagesGetHandler({
+	project,
+	pageId,
+}: {
+	project: string;
+	pageId: string;
+}) {
+	return Effect.gen(function* () {
+		const { id } = yield* resolveProject(project);
+		const raw = yield* api.get(`projects/${id}/pages/${pageId}/`);
+		const page = yield* decodeOrFail(PageSchema, raw);
+		yield* Console.log(JSON.stringify(page, null, 2));
+	});
+}
+
 export const pagesGet = Command.make(
 	"get",
 	{ project: projectArg, pageId: pageIdArg },
-	({ project, pageId }) =>
-		Effect.gen(function* () {
-			const { id } = yield* resolveProject(project);
-			const raw = yield* api.get(`projects/${id}/pages/${pageId}/`);
-			const page = yield* decodeOrFail(PageSchema, raw);
-			yield* Console.log(JSON.stringify(page, null, 2));
-		}),
+	pagesGetHandler,
 ).pipe(
 	Command.withDescription(
 		"Print full JSON for a page including description_html.\n\nExample:\n  plane pages get PROJ <page-id>",

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;
 

package/src/output.ts

@@ -15,25 +15,28 @@ function escapeXml(val: unknown): string {
 		.replace(/"/g, """);
 }
 
-function toXmlItem(obj: unknown, tag = "item"): string {
-	if (obj === null || typeof obj !== "object") {
-		return `<${tag}>${escapeXml(obj)}</${tag}>`;
-	}
-	const attrs = Object.entries(obj as Record<string, unknown>)
+function toXmlItem(obj: Record<string, unknown>, tag = "item"): string {
+	const attrs = Object.entries(obj)
 		.filter(([, v]) => v === null || typeof v !== "object")
 		.map(([k, v]) => `${k}="${escapeXml(v)}"`)
 		.join(" ");
-	const children = Object.entries(obj as Record<string, unknown>)
+	const children = Object.entries(obj)
 		.filter(([, v]) => v !== null && typeof v === "object")
 		.map(([k, v]) =>
 			Array.isArray(v)
-				? `<${k}>${v.map((i) => toXmlItem(i)).join("")}</${k}>`
-				: toXmlItem(v, k),
+				? `<${k}>${v
+						.map((i) =>
+							typeof i === "object" && i !== null
+								? toXmlItem(i as Record<string, unknown>)
+								: `<item>${escapeXml(i)}</item>`,
+						)
+						.join("")}</${k}>`
+				: toXmlItem(v as Record<string, unknown>, k),
 		)
 		.join("");
 	return `<${tag}${attrs ? " " + attrs : ""}>${children}</${tag}>`;
 }
 
 export function toXml(results: readonly unknown[]): string {
-	return `<results>\n${results.map((r) => "  " + toXmlItem(r)).join("\n")}\n</results>`;
+	return `<results>\n${results.map((r) => "  " + toXmlItem(r as Record<string, unknown>)).join("\n")}\n</results>`;
 }

package/src/resolve.ts

@@ -7,12 +7,13 @@ import {
 	ProjectsResponseSchema,
 	StatesResponseSchema,
 } from "./config.js";
+import type { Issue } from "./config.js";
 
 // Cache project list within a process invocation
 let _projectCache: Record<string, string> | null = null;
 
 /** Clear the project cache — for use in tests only */
-export function _clearProjectCache() {
+export function _clearProjectCache(): void {
 	_projectCache = null;
 }
 
@@ -66,7 +67,10 @@ export function parseIssueRef(
 	);
 }
 
-export function findIssueBySeq(projectId: string, seq: number) {
+export function findIssueBySeq(
+	projectId: string,
+	seq: number,
+): Effect.Effect<Issue, Error> {
 	return Effect.gen(function* () {
 		const raw = yield* api.get(`projects/${projectId}/issues/`);
 		const { results } = yield* decodeOrFail(IssuesResponseSchema, raw);
@@ -76,7 +80,9 @@ export function findIssueBySeq(projectId: string, seq: number) {
 	});
 }
 
-export function getMemberId(nameEmailOrId: string) {
+export function getMemberId(
+	nameEmailOrId: string,
+): Effect.Effect<string, Error> {
 	return Effect.gen(function* () {
 		const results = yield* decodeOrFail(
 			MembersResponseSchema,
@@ -97,7 +103,10 @@ export function getMemberId(nameEmailOrId: string) {
 	});
 }
 
-export function getStateId(projectId: string, nameOrGroup: string) {
+export function getStateId(
+	projectId: string,
+	nameOrGroup: string,
+): Effect.Effect<string, Error> {
 	return Effect.gen(function* () {
 		const raw = yield* api.get(`projects/${projectId}/states/`);
 		const { results } = yield* decodeOrFail(StatesResponseSchema, raw);
@@ -111,7 +120,10 @@ export function getStateId(projectId: string, nameOrGroup: string) {
 	});
 }
 
-export function getLabelId(projectId: string, name: string) {
+export function getLabelId(
+	projectId: string,
+	name: string,
+): Effect.Effect<string, Error> {
 	return Effect.gen(function* () {
 		const raw = yield* api.get(`projects/${projectId}/labels/`);
 		const { results } = yield* decodeOrFail(LabelsResponseSchema, raw);

package/tests/api.test.ts

@@ -43,8 +43,10 @@ describe("api.get", () => {
 				}),
 			),
 		);
-		const result = await Effect.runPromise(api.get("projects/"));
-		expect((result as any).results).toHaveLength(1);
+		const result = (await Effect.runPromise(api.get("projects/"))) as {
+			results: unknown[];
+		};
+		expect(result.results).toHaveLength(1);
 	});
 
 	it("strips trailing slash from PLANE_HOST", async () => {
@@ -54,8 +56,10 @@ describe("api.get", () => {
 				HttpResponse.json({ results: [] }),
 			),
 		);
-		const result = await Effect.runPromise(api.get("projects/"));
-		expect((result as any).results).toHaveLength(0);
+		const result = (await Effect.runPromise(api.get("projects/"))) as {
+			results: unknown[];
+		};
+		expect(result.results).toHaveLength(0);
 	});
 
 	it("appends expand=state for issues/ paths", async () => {
@@ -103,7 +107,7 @@ describe("api.post", () => {
 			http.post(
 				`${BASE}/api/v1/workspaces/${WS}/projects/p1/issues/`,
 				async ({ request }) => {
-					const body = (await request.json()) as any;
+					const body = (await request.json()) as { name?: string };
 					return HttpResponse.json({
 						id: "new-issue",
 						sequence_id: 99,
@@ -116,7 +120,7 @@ describe("api.post", () => {
 		);
 		const result = (await Effect.runPromise(
 			api.post("projects/p1/issues/", { name: "New Issue" }),
-		)) as any;
+		)) as { sequence_id: number; name: string };
 		expect(result.sequence_id).toBe(99);
 		expect(result.name).toBe("New Issue");
 	});
@@ -128,7 +132,7 @@ describe("api.patch", () => {
 			http.patch(
 				`${BASE}/api/v1/workspaces/${WS}/projects/p1/issues/i1/`,
 				async ({ request }) => {
-					const body = (await request.json()) as any;
+					const body = (await request.json()) as { priority?: string };
 					return HttpResponse.json({
 						id: "i1",
 						sequence_id: 1,
@@ -141,7 +145,7 @@ describe("api.patch", () => {
 		);
 		const result = (await Effect.runPromise(
 			api.patch("projects/p1/issues/i1/", { priority: "high" }),
-		)) as any;
+		)) as { priority: string };
 		expect(result.priority).toBe("high");
 	});
 });