feat: project settings page with paseo.json editor

Adds a Projects settings flow for inspecting and editing per-project paseo.json (worktree setup/teardown, scripts, terminals) directly from the app. Reads/writes go through new daemon RPCs with revision-based optimistic concurrency, and the screen always keeps its header and host picker visible so a hung host doesn't trap the user.
2026-04-26 11:37:47 +07:00
parent 18903bcecb
commit 219050a7ab
36 changed files with 6447 additions and 81 deletions
@@ -0,0 +1,75 @@
+import { z } from "zod";
+
+export function normalizeLifecycleCommands(commands: unknown): string[] {
+  if (typeof commands === "string") {
+    return commands.trim().length > 0 ? [commands] : [];
+  }
+  if (!Array.isArray(commands)) {
+    return [];
+  }
+  return commands.filter((command): command is string => {
+    return typeof command === "string" && command.trim().length > 0;
+  });
+}
+
+export const PaseoLifecycleCommandRawSchema = z.union([z.string(), z.array(z.string())]);
+
+export const PaseoScriptEntryRawSchema = z
+  .object({
+    type: z.unknown().optional(),
+    command: z.unknown().optional(),
+    port: z.unknown().optional(),
+  })
+  .passthrough();
+
+export const PaseoWorktreeConfigRawSchema = z
+  .object({
+    setup: PaseoLifecycleCommandRawSchema.optional(),
+    teardown: PaseoLifecycleCommandRawSchema.optional(),
+    terminals: z.unknown().optional(),
+  })
+  .passthrough();
+
+export const PaseoConfigRawSchema = z
+  .object({
+    worktree: PaseoWorktreeConfigRawSchema.optional(),
+    scripts: z.record(z.string(), PaseoScriptEntryRawSchema).optional(),
+  })
+  .passthrough();
+
+export const WorktreeConfigSchema = PaseoWorktreeConfigRawSchema.extend({
+  setup: z.unknown().transform(normalizeLifecycleCommands),
+  teardown: z.unknown().transform(normalizeLifecycleCommands),
+})
+  .passthrough()
+  .catch({ setup: [], teardown: [] });
+
+export const ScriptEntrySchema = PaseoScriptEntryRawSchema.catch({});
+
+export const PaseoConfigSchema = PaseoConfigRawSchema.extend({
+  worktree: WorktreeConfigSchema.optional(),
+  scripts: z.record(z.string(), ScriptEntrySchema).optional().catch({}),
+})
+  .passthrough()
+  .catch({});
+
+export const PaseoConfigRevisionSchema = z.object({
+  mtimeMs: z.number(),
+  size: z.number(),
+});
+
+export const ProjectConfigRpcErrorSchema = z.discriminatedUnion("code", [
+  z.object({ code: z.literal("project_not_found") }),
+  z.object({ code: z.literal("invalid_project_config") }),
+  z.object({
+    code: z.literal("stale_project_config"),
+    currentRevision: PaseoConfigRevisionSchema.nullable(),
+  }),
+  z.object({ code: z.literal("write_failed") }),
+]);
+
+export type PaseoScriptEntryRaw = z.infer<typeof PaseoScriptEntryRawSchema>;
+export type PaseoConfigRaw = z.infer<typeof PaseoConfigRawSchema>;
+export type PaseoConfig = z.infer<typeof PaseoConfigSchema>;
+export type PaseoConfigRevision = z.infer<typeof PaseoConfigRevisionSchema>;
+export type ProjectConfigRpcError = z.infer<typeof ProjectConfigRpcErrorSchema>;