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,129 @@
+import { existsSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+import {
+  PaseoConfigRawSchema,
+  type PaseoConfigRaw,
+  type PaseoConfigRevision,
+  type ProjectConfigRpcError,
+} from "./paseo-config-schema.js";
+export {
+  PaseoConfigRevisionSchema,
+  ProjectConfigRpcErrorSchema,
+  type PaseoConfigRevision,
+  type ProjectConfigRpcError,
+} from "./paseo-config-schema.js";
+
+export const PASEO_CONFIG_FILE_NAME = "paseo.json";
+
+export type ReadPaseoConfigForEditResult =
+  | { ok: true; config: PaseoConfigRaw | null; revision: PaseoConfigRevision | null }
+  | { ok: false; error: ProjectConfigRpcError };
+
+export type WritePaseoConfigForEditResult =
+  | { ok: true; config: PaseoConfigRaw; revision: PaseoConfigRevision }
+  | { ok: false; error: ProjectConfigRpcError };
+
+export interface WritePaseoConfigForEditInput {
+  repoRoot: string;
+  config: PaseoConfigRaw;
+  expectedRevision: PaseoConfigRevision | null;
+}
+
+export function resolvePaseoConfigPath(repoRoot: string): string {
+  return join(repoRoot, PASEO_CONFIG_FILE_NAME);
+}
+
+export function statPaseoConfigPath(repoRoot: string): PaseoConfigRevision | null {
+  const configPath = resolvePaseoConfigPath(repoRoot);
+  if (!existsSync(configPath)) {
+    return null;
+  }
+  const stats = statSync(configPath);
+  return {
+    mtimeMs: stats.mtimeMs,
+    size: stats.size,
+  };
+}
+
+export function readPaseoConfigJson(repoRoot: string): unknown | null {
+  const configPath = resolvePaseoConfigPath(repoRoot);
+  if (!existsSync(configPath)) {
+    return null;
+  }
+  return JSON.parse(readFileSync(configPath, "utf8"));
+}
+
+export function readPaseoConfigForEdit(repoRoot: string): ReadPaseoConfigForEditResult {
+  try {
+    const json = readPaseoConfigJson(repoRoot);
+    if (json === null) {
+      return { ok: true, config: null, revision: null };
+    }
+    return {
+      ok: true,
+      config: PaseoConfigRawSchema.parse(json),
+      revision: statPaseoConfigPath(repoRoot),
+    };
+  } catch {
+    return {
+      ok: false,
+      error: { code: "invalid_project_config" },
+    };
+  }
+}
+
+export function writePaseoConfigForEdit(
+  input: WritePaseoConfigForEditInput,
+): WritePaseoConfigForEditResult {
+  const parsed = PaseoConfigRawSchema.safeParse(input.config);
+  if (!parsed.success) {
+    return { ok: false, error: { code: "invalid_project_config" } };
+  }
+
+  const configPath = resolvePaseoConfigPath(input.repoRoot);
+  const tempPath = join(
+    input.repoRoot,
+    `.${PASEO_CONFIG_FILE_NAME}.${process.pid}.${randomUUID()}.tmp`,
+  );
+
+  try {
+    writeFileSync(tempPath, `${JSON.stringify(parsed.data, null, 2)}\n`);
+    const currentRevision = statPaseoConfigPath(input.repoRoot);
+    if (!paseoConfigRevisionsEqual(currentRevision, input.expectedRevision)) {
+      removeTempPaseoConfig(tempPath);
+      return {
+        ok: false,
+        error: { code: "stale_project_config", currentRevision },
+      };
+    }
+
+    renameSync(tempPath, configPath);
+    const revision = statPaseoConfigPath(input.repoRoot);
+    if (!revision) {
+      return { ok: false, error: { code: "write_failed" } };
+    }
+    return { ok: true, config: parsed.data, revision };
+  } catch {
+    removeTempPaseoConfig(tempPath);
+    return { ok: false, error: { code: "write_failed" } };
+  }
+}
+
+function paseoConfigRevisionsEqual(
+  left: PaseoConfigRevision | null,
+  right: PaseoConfigRevision | null,
+): boolean {
+  if (left === null || right === null) {
+    return left === right;
+  }
+  return left.mtimeMs === right.mtimeMs && left.size === right.size;
+}
+
+function removeTempPaseoConfig(tempPath: string): void {
+  try {
+    rmSync(tempPath, { force: true });
+  } catch {
+    // Best-effort cleanup only; callers need the original write outcome.
+  }
+}