feat: bundle workspace tasks plugin

2026-06-03 22:31:36 +02:00
parent fda6fb0eca
commit 08f69d09c0
52 changed files with 879 additions and 681 deletions
@@ -0,0 +1,121 @@
+export const TASKS_CONFIG_PATH = ".pi-web/tasks.json";
+export const TASKS_CONFIG_VERSION = 1;
+
+const taskIdPattern = /^[a-z][a-z0-9.-]*$/u;
+
+export interface WorkspaceTasksConfig {
+  version: typeof TASKS_CONFIG_VERSION;
+  tasks: WorkspaceTask[];
+}
+
+export interface WorkspaceTask {
+  id: string;
+  title: string;
+  command: string;
+  description?: string;
+  group?: string;
+  confirm: boolean;
+}
+
+export type ParseTasksConfigResult =
+  | { ok: true; config: WorkspaceTasksConfig }
+  | { ok: false; error: string };
+
+export function parseTasksConfigText(text: string): ParseTasksConfigResult {
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(text);
+  } catch (error) {
+    return { ok: false, error: `Invalid JSON: ${error instanceof Error ? error.message : String(error)}` };
+  }
+  return parseTasksConfig(parsed);
+}
+
+export function parseTasksConfig(value: unknown): ParseTasksConfigResult {
+  if (!isRecord(value)) return invalid("Config must be an object");
+  if (value["version"] !== TASKS_CONFIG_VERSION) return invalid("Config version must be 1");
+
+  const tasks = value["tasks"];
+  if (!Array.isArray(tasks)) return invalid("Config tasks must be an array");
+
+  const ids = new Set<string>();
+  const parsedTasks: WorkspaceTask[] = [];
+  for (const [index, task] of tasks.entries()) {
+    const parsedTask = parseTask(task, index);
+    if (!parsedTask.ok) return parsedTask;
+    if (ids.has(parsedTask.task.id)) return invalid(`Duplicate task id: ${parsedTask.task.id}`);
+    ids.add(parsedTask.task.id);
+    parsedTasks.push(parsedTask.task);
+  }
+
+  return { ok: true, config: { version: TASKS_CONFIG_VERSION, tasks: parsedTasks } };
+}
+
+type ParseTaskResult =
+  | { ok: true; task: WorkspaceTask }
+  | { ok: false; error: string };
+
+function parseTask(value: unknown, index: number): ParseTaskResult {
+  const label = `Task ${String(index + 1)}`;
+  if (!isRecord(value)) return invalid(`${label} must be an object`);
+
+  const id = requireNonEmptyString(value, "id", label);
+  if (!id.ok) return id;
+  if (!taskIdPattern.test(id.value)) return invalid(`${label} id must match ${taskIdPattern.source}`);
+
+  const title = requireNonEmptyString(value, "title", label);
+  if (!title.ok) return title;
+
+  const command = requireNonEmptyString(value, "command", label);
+  if (!command.ok) return command;
+
+  const description = optionalNonEmptyString(value, "description", label);
+  if (!description.ok) return description;
+
+  const group = optionalNonEmptyString(value, "group", label);
+  if (!group.ok) return group;
+
+  const confirm = value["confirm"];
+  if (confirm !== undefined && typeof confirm !== "boolean") return invalid(`${label} confirm must be a boolean`);
+
+  return {
+    ok: true,
+    task: {
+      id: id.value,
+      title: title.value,
+      command: command.value,
+      ...(description.value === undefined ? {} : { description: description.value }),
+      ...(group.value === undefined ? {} : { group: group.value }),
+      confirm: confirm ?? false,
+    },
+  };
+}
+
+type StringFieldResult =
+  | { ok: true; value: string }
+  | { ok: false; error: string };
+
+type OptionalStringFieldResult =
+  | { ok: true; value: string | undefined }
+  | { ok: false; error: string };
+
+function requireNonEmptyString(record: Record<string, unknown>, key: string, label: string): StringFieldResult {
+  const value = record[key];
+  if (typeof value !== "string" || value.trim() === "") return invalid(`${label} ${key} must be a non-empty string`);
+  return { ok: true, value };
+}
+
+function optionalNonEmptyString(record: Record<string, unknown>, key: string, label: string): OptionalStringFieldResult {
+  const value = record[key];
+  if (value === undefined) return { ok: true, value: undefined };
+  if (typeof value !== "string" || value.trim() === "") return invalid(`${label} ${key} must be a non-empty string when provided`);
+  return { ok: true, value };
+}
+
+function invalid(error: string): { ok: false; error: string } {
+  return { ok: false, error };
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}