@aaronshaf/plane 0.1.8 → 0.1.11

package/package.json

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

package/src/api.ts

@@ -66,7 +66,22 @@ function request(
 			// 204 No Content
 			if (res.status === 204) return null;
 
-			return res.json();
+			// Use text + lenient parse to handle bare control characters (U+0000–U+001F)
+			// that may appear inside JSON string values (e.g. description_html with \n in <pre>).
+			const text = await res.text();
+			try {
+				return JSON.parse(text);
+			} catch {
+				// Escape bare control characters inside JSON string values and retry.
+				const sanitized = text.replace(
+					/"(?:[^"\\]|\\.)*"/g,
+					(match) => match.replace(/[\x00-\x1F]/g, (c) => {
+						const hex = c.charCodeAt(0).toString(16).padStart(4, "0");
+						return `\\u${hex}`;
+					}),
+				);
+				return JSON.parse(sanitized);
+			}
 		},
 		catch: (e) => (e instanceof Error ? e : new Error(String(e))),
 	});

package/src/commands/cycles.ts

@@ -15,34 +15,37 @@ const cycleIdArg = Args.text({ name: "cycle-id" }).pipe(
 
 // --- cycles list ---
 
+export function cyclesListHandler({ project }: { project: string }) {
+	return Effect.gen(function* () {
+		const { id } = yield* resolveProject(project);
+		const raw = yield* api.get(`projects/${id}/cycles/`);
+		const { results } = yield* decodeOrFail(CyclesResponseSchema, 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 cycles found");
+			return;
+		}
+		const lines = results.map((c) => {
+			const start = c.start_date ?? "—";
+			const end = c.end_date ?? "—";
+			const status = (c.status ?? "?").padEnd(10);
+			return `${c.id}  ${status}  ${start} → ${end}  ${c.name}`;
+		});
+		yield* Console.log(lines.join("\n"));
+	});
+}
+
 export const cyclesList = Command.make(
 	"list",
 	{ project: projectArg },
-	({ project }) =>
-		Effect.gen(function* () {
-			const { id } = yield* resolveProject(project);
-			const raw = yield* api.get(`projects/${id}/cycles/`);
-			const { results } = yield* decodeOrFail(CyclesResponseSchema, 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 cycles found");
-				return;
-			}
-			const lines = results.map((c) => {
-				const start = c.start_date ?? "—";
-				const end = c.end_date ?? "—";
-				const status = (c.status ?? "?").padEnd(10);
-				return `${c.id}  ${status}  ${start} → ${end}  ${c.name}`;
-			});
-			yield* Console.log(lines.join("\n"));
-		}),
+	cyclesListHandler,
 ).pipe(
 	Command.withDescription(
 		"List cycles for a project. Shows cycle UUID, status, date range, and name.\n\nExample:\n  plane cycles list PROJ",
@@ -51,37 +54,46 @@ export const cyclesList = Command.make(
 
 // --- cycles issues list ---
 
+export function cycleIssuesListHandler({
+	project,
+	cycleId,
+}: {
+	project: string;
+	cycleId: string;
+}) {
+	return Effect.gen(function* () {
+		const { key, id } = yield* resolveProject(project);
+		const raw = yield* api.get(
+			`projects/${id}/cycles/${cycleId}/cycle-issues/`,
+		);
+		const { results } = yield* decodeOrFail(CycleIssuesResponseSchema, 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 cycle");
+			return;
+		}
+		const lines = results.map((ci) => {
+			if (ci.issue_detail) {
+				const seq = String(ci.issue_detail.sequence_id).padStart(3, " ");
+				return `${key}-${seq}  ${ci.issue_detail.name}  (${ci.id})`;
+			}
+			return `${ci.issue}  (cycle-issue: ${ci.id})`;
+		});
+		yield* Console.log(lines.join("\n"));
+	});
+}
+
 export const cycleIssuesList = Command.make(
 	"list",
 	{ project: projectArg, cycleId: cycleIdArg },
-	({ project, cycleId }) =>
-		Effect.gen(function* () {
-			const { key, id } = yield* resolveProject(project);
-			const raw = yield* api.get(
-				`projects/${id}/cycles/${cycleId}/cycle-issues/`,
-			);
-			const { results } = yield* decodeOrFail(CycleIssuesResponseSchema, 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 cycle");
-				return;
-			}
-			const lines = results.map((ci) => {
-				if (ci.issue_detail) {
-					const seq = String(ci.issue_detail.sequence_id).padStart(3, " ");
-					return `${key}-${seq}  ${ci.issue_detail.name}  (${ci.id})`;
-				}
-				return `${ci.issue}  (cycle-issue: ${ci.id})`;
-			});
-			yield* Console.log(lines.join("\n"));
-		}),
+	cycleIssuesListHandler,
 ).pipe(
 	Command.withDescription(
 		"List issues in a cycle.\n\nExample:\n  plane cycles issues list PROJ <cycle-id>",
@@ -94,19 +106,30 @@ const issueRefArg = Args.text({ name: "ref" }).pipe(
 	Args.withDescription("Issue reference to add (e.g. PROJ-29)"),
 );
 
+export function cycleIssuesAddHandler({
+	project,
+	cycleId,
+	ref,
+}: {
+	project: string;
+	cycleId: 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}/cycles/${cycleId}/cycle-issues/`, {
+			issues: [issue.id],
+		});
+		yield* Console.log(`Added ${ref} to cycle ${cycleId}`);
+	});
+}
+
 export const cycleIssuesAdd = Command.make(
 	"add",
 	{ project: projectArg, cycleId: cycleIdArg, ref: issueRefArg },
-	({ project, cycleId, 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}/cycles/${cycleId}/cycle-issues/`, {
-				issues: [issue.id],
-			});
-			yield* Console.log(`Added ${ref} to cycle ${cycleId}`);
-		}),
+	cycleIssuesAddHandler,
 ).pipe(
 	Command.withDescription(
 		"Add an issue to a cycle.\n\nExample:\n  plane cycles issues add PROJ <cycle-id> PROJ-29",

package/src/commands/intake.ts

@@ -20,37 +20,39 @@ const STATUS_LABELS: Record<number, string> = {
 
 // --- intake list ---
 
+export function intakeListHandler({ project }: { project: string }) {
+	return Effect.gen(function* () {
+		const { id } = yield* resolveProject(project);
+		const raw = yield* api.get(`projects/${id}/intake-issues/`);
+		const { results } = yield* decodeOrFail(IntakeIssuesResponseSchema, 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 intake issues");
+			return;
+		}
+		const lines = results.map((i) => {
+			const status = STATUS_LABELS[i.status ?? 0] ?? String(i.status ?? "?");
+			const statusPad = status.padEnd(10);
+			if (i.issue_detail) {
+				return `${i.id}  [${statusPad}]  ${i.issue_detail.name}`;
+			}
+			return `${i.id}  [${statusPad}]`;
+		});
+		yield* Console.log(lines.join("\n"));
+	});
+}
+
 export const intakeList = Command.make(
 	"list",
 	{ project: projectArg },
-	({ project }) =>
-		Effect.gen(function* () {
-			const { id } = yield* resolveProject(project);
-			const raw = yield* api.get(`projects/${id}/intake-issues/`);
-			const { results } = yield* decodeOrFail(IntakeIssuesResponseSchema, 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 intake issues");
-				return;
-			}
-			const lines = results.map((i) => {
-				const status = STATUS_LABELS[i.status ?? 0] ?? String(i.status ?? "?");
-				const statusPad = status.padEnd(10);
-				if (i.issue_detail) {
-					const seq = String(i.issue_detail.sequence_id).padStart(3, " ");
-					return `${i.id}  [${statusPad}]  ${i.issue_detail.name}`;
-				}
-				return `${i.id}  [${statusPad}]`;
-			});
-			yield* Console.log(lines.join("\n"));
-		}),
+	intakeListHandler,
 ).pipe(
 	Command.withDescription(
 		"List intake (triage) issues for a project. Shows status: pending, accepted, rejected, snoozed, duplicate.\n\nExample:\n  plane intake list PROJ",
@@ -63,17 +65,26 @@ const intakeIdArg = Args.text({ name: "intake-id" }).pipe(
 	Args.withDescription("Intake issue ID (from 'plane intake list')"),
 );
 
+export function intakeAcceptHandler({
+	project,
+	intakeId,
+}: {
+	project: string;
+	intakeId: string;
+}) {
+	return Effect.gen(function* () {
+		const { id } = yield* resolveProject(project);
+		yield* api.patch(`projects/${id}/intake-issues/${intakeId}/`, {
+			status: 1,
+		});
+		yield* Console.log(`Intake issue ${intakeId} accepted`);
+	});
+}
+
 export const intakeAccept = Command.make(
 	"accept",
 	{ project: projectArg, intakeId: intakeIdArg },
-	({ project, intakeId }) =>
-		Effect.gen(function* () {
-			const { id } = yield* resolveProject(project);
-			yield* api.patch(`projects/${id}/intake-issues/${intakeId}/`, {
-				status: 1,
-			});
-			yield* Console.log(`Intake issue ${intakeId} accepted`);
-		}),
+	intakeAcceptHandler,
 ).pipe(
 	Command.withDescription(
 		"Accept an intake issue, creating it as a tracked work item.",
@@ -82,17 +93,26 @@ export const intakeAccept = Command.make(
 
 // --- intake reject ---
 
+export function intakeRejectHandler({
+	project,
+	intakeId,
+}: {
+	project: string;
+	intakeId: string;
+}) {
+	return Effect.gen(function* () {
+		const { id } = yield* resolveProject(project);
+		yield* api.patch(`projects/${id}/intake-issues/${intakeId}/`, {
+			status: -2,
+		});
+		yield* Console.log(`Intake issue ${intakeId} rejected`);
+	});
+}
+
 export const intakeReject = Command.make(
 	"reject",
 	{ project: projectArg, intakeId: intakeIdArg },
-	({ project, intakeId }) =>
-		Effect.gen(function* () {
-			const { id } = yield* resolveProject(project);
-			yield* api.patch(`projects/${id}/intake-issues/${intakeId}/`, {
-				status: -2,
-			});
-			yield* Console.log(`Intake issue ${intakeId} rejected`);
-		}),
+	intakeRejectHandler,
 ).pipe(Command.withDescription("Reject an intake issue."));
 
 // --- intake (parent) ---