@puddle-code/cli 0.3.2 → 0.3.4

package/CHANGELOG.md

@@ -4,16 +4,18 @@ Archived release changelog. Governance lives in CLAUDE.md §"Changelog disciplin
 
 # Changelog
 
-## [0.3.2] — 2026-10-14
+## [0.3.4] — 2026-10-23
 
 ### Added
 
-- Support Claude Code, Codex, OpenCode and Gemini CLI in Puddlang with per-agent interactive or headless execution, persisted mode selection, exact reply correlation and account-preserving native conversation resume (daemon protocol 24.0).
+- Keep notebook kernels alive across runs and browser reconnects; add notebook header controls for cells, Run All, clearing output, outline navigation, kernel selection, interruption, restart and shutdown.
+- Add language-selectable compilation and execution defaults under Settings → Editor, sharing command controls with per-file overrides.
+- Choose project name colours from the profile palette when creating or editing a project, or from either sidebar's project context menu; retain colours across dashboard cards and project navigation.
+- Add editable `.ipynb` notebook views with saved rich output, a JSON source toggle, and explicit whole-notebook execution through host-installed Jupyter.
+- Run Python, JavaScript, TypeScript, C, C++, Rust, Go, Ruby, Perl, R and shell files with detected host tools, per-file command overrides, bounded output and managed result tabs; keep code execution manual.
 
 ### Changed
 
-- Rename Puddlang's `scripted` execution mode to `headless` across spawn options, session state, agent modules, examples and documentation; migrate existing placements and advance daemon protocol to 24.0 and remote protocol to 4.
-
-### Fixed
-
-- Include the Puddlang runner and its imports in standalone daemon archives, with a release smoke test that executes a TypeScript programme using both `puddlang` and `zod`.
+- Advance the daemon/cockpit protocol to 24.6 for host kernel discovery, status and explicit notebook lifecycle actions.
+- Advance the daemon/cockpit protocol to 24.5 for optional project colours; hide colour controls on older hosts and preserve existing project styling by default.
+- Advance the daemon/cockpit protocol to 24.4 for profile language command defaults, inherited file commands and an optional compilation-provider action label; retain LaTeX eager controls only for providers that advertise eager support.

package/dist/host-control.mjs

@@ -14557,6 +14557,7 @@ var notificationContentSchema = external_exports.object({
 var desktopNotificationRequestSchema = external_exports.object({
   id: external_exports.string().min(1).max(128),
   title: external_exports.string().min(1).max(160),
+  subtitle: external_exports.string().min(1).max(160).optional(),
   body: external_exports.string().min(1).max(256),
   target: notificationTargetSchema.optional()
 }).strict();
@@ -14689,6 +14690,15 @@ ${RULES_TOKEN}
 4. If the user states a standing rule for all future worktrees ("always\u2026", "never\u2026", "from now on\u2026"), write the complete updated rules to \`.puddle/onboarding-notes.md\` in this worktree \u2014 full replacement, user-owned prose; record their decision, don't invent policy.
 
 Then proceed with the task below (or await instructions if none is given).`;
+var PROFILE_ICON_COLOURS = [
+  "navy",
+  "gold",
+  "blue",
+  "green",
+  "red",
+  "violet",
+  "cyan"
+];
 var profileSchema = external_exports.object({
   id: profileId,
   name: fsSafeName,
@@ -15110,13 +15120,15 @@ var archiveRequestSchema = external_exports.object({
 });
 
 // ../shared/src/api/projects.ts
-var projectAbbrev = external_exports.string().min(1).max(5);
+var projectAbbrev2 = external_exports.string().min(1).max(5);
+var projectColourSchema = external_exports.enum(PROFILE_ICON_COLOURS);
 var projectSchema = external_exports.object({
   id: projectId,
   profile_id: profileId,
   repo_id: rowId,
   name: external_exports.string(),
-  abbrev: projectAbbrev.nullable().default(null),
+  abbrev: projectAbbrev2.nullable().default(null),
+  colour: projectColourSchema.nullable().optional(),
   /**
    * Hidden from the homescreen but never deleted — every session, worktree, and
    * bit of data is retained, and un-archiving restores it all (SPEC §11).
@@ -15130,11 +15142,13 @@ var createProjectRequestSchema = external_exports.object({
   profile_id: profileId,
   repo_id: rowId,
   name: external_exports.string().min(1).max(100),
-  abbrev: projectAbbrev.optional()
+  abbrev: projectAbbrev2.optional(),
+  colour: projectColourSchema.nullable().optional()
 });
 var patchProjectRequestSchema = external_exports.object({
   name: external_exports.string().min(1).max(100).optional(),
-  abbrev: projectAbbrev.optional(),
+  abbrev: projectAbbrev2.optional(),
+  colour: projectColourSchema.nullable().optional(),
   archived: external_exports.boolean().optional()
 });
 var projectDetailSchema = external_exports.object({
@@ -15195,7 +15209,9 @@ var compilationProviderSchema = external_exports.object({
   available: external_exports.boolean(),
   /** The preferred host executable when available, for honest capability UI. */
   executor: external_exports.string().min(1).nullable(),
-  eager: external_exports.boolean()
+  eager: external_exports.boolean(),
+  /** Omitted by older providers, whose action remains compilation. */
+  action: external_exports.enum(["compile", "run"]).optional()
 });
 var compilationCapabilitiesResponseSchema = external_exports.object({
   providers: external_exports.array(compilationProviderSchema)
@@ -15264,7 +15280,9 @@ var compilationCommandSlotSchema = external_exports.object({
   /** Stable trigger copy lets a generic dialog explain exactly when this slot runs. */
   run_when: external_exports.enum(["when_clicked", "upon_file_change"]),
   default_command: external_exports.string().min(1).nullable(),
-  override_command: external_exports.string().min(1).nullable()
+  override_command: external_exports.string().min(1).nullable(),
+  /** Profile language default inherited by this file (24.4); null uses the provider. */
+  inherited_command: external_exports.string().min(1).nullable().optional()
 });
 var compilationSettingsRequestSchema = compilationTargetRequestSchema.extend({
   profile_id: profileId,
@@ -15284,6 +15302,18 @@ var updateCompilationSettingsRequestSchema = compilationSettingsRequestSchema.ex
   mode: compilationModeSchema,
   command: external_exports.string().trim().min(1).max(16384).nullable()
 });
+var compilationDefaultsRequestSchema = external_exports.object({
+  profile_id: profileId,
+  provider: compilationProviderIdSchema
+});
+var compilationDefaultsResponseSchema = compilationSettingsResponseSchema.omit({
+  file_type: true,
+  file_path: true
+});
+var updateCompilationDefaultsRequestSchema = compilationDefaultsRequestSchema.extend({
+  mode: compilationModeSchema,
+  command: updateCompilationSettingsRequestSchema.shape.command
+});
 
 // ../shared/src/api/ui-state.ts
 var editorTabRefSchema = external_exports.object({
@@ -15450,6 +15480,31 @@ var patchLayoutRequestSchema = external_exports.object({
   active_session: sessionId.nullable().optional()
 });
 
+// ../shared/src/api/notebooks.ts
+var notebookKernelSpecSchema = external_exports.object({
+  name: external_exports.string().min(1),
+  display_name: external_exports.string().min(1),
+  language: external_exports.string()
+});
+var notebookKernelsResponseSchema = external_exports.object({
+  available: external_exports.boolean(),
+  kernels: external_exports.array(notebookKernelSpecSchema),
+  error: external_exports.string().optional()
+});
+var notebookKernelRequestSchema = external_exports.object({ source: compilationFileTargetSchema });
+var notebookKernelStatusSchema = external_exports.object({
+  state: external_exports.enum(["stopped", "starting", "idle", "busy", "dead"]),
+  kernel: external_exports.string().nullable(),
+  error: external_exports.string().optional()
+});
+var notebookKernelActionSchema = external_exports.discriminatedUnion("action", [
+  notebookKernelRequestSchema.extend({
+    action: external_exports.literal("select"),
+    kernel: external_exports.string().min(1).max(256)
+  }),
+  notebookKernelRequestSchema.extend({ action: external_exports.enum(["interrupt", "restart", "shutdown"]) })
+]);
+
 // ../shared/src/api/latex.ts
 var latexSynctexRequestSchema = compilationFileTargetSchema.extend({
   root: external_exports.string().min(1),
@@ -15749,6 +15804,12 @@ var cockpitRefreshResponseSchema = external_exports.object({
   refreshId: external_exports.string().uuid(),
   instance: external_exports.string().uuid()
 });
+var cockpitFileManagerSchema = external_exports.object({
+  name: external_exports.enum(["Finder", "File Explorer", "File Manager"]).nullable()
+});
+var cockpitRevealRequestSchema = external_exports.object({
+  path: external_exports.string().min(1).max(4096).refine((path) => !path.includes("\0"))
+}).strict();
 
 // ../shared/src/ws/messages.ts
 var termId = external_exports.string().regex(/^(agent|shell-[0-9]+)$/);

package/dist/index.js

@@ -3925,7 +3925,7 @@ import { createInterface } from "node:readline";
 import { Writable } from "node:stream";
 
 // ../shared/src/protocol.ts
-var PROTOCOL_VERSION = { major: 24, minor: 0 };
+var PROTOCOL_VERSION = { major: 24, minor: 6 };
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -18477,6 +18477,7 @@ var notificationContentSchema = external_exports.object({
 var desktopNotificationRequestSchema = external_exports.object({
   id: external_exports.string().min(1).max(128),
   title: external_exports.string().min(1).max(160),
+  subtitle: external_exports.string().min(1).max(160).optional(),
   body: external_exports.string().min(1).max(256),
   target: notificationTargetSchema.optional()
 }).strict();
@@ -18609,6 +18610,15 @@ ${RULES_TOKEN}
 4. If the user states a standing rule for all future worktrees ("always\u2026", "never\u2026", "from now on\u2026"), write the complete updated rules to \`.puddle/onboarding-notes.md\` in this worktree \u2014 full replacement, user-owned prose; record their decision, don't invent policy.
 
 Then proceed with the task below (or await instructions if none is given).`;
+var PROFILE_ICON_COLOURS = [
+  "navy",
+  "gold",
+  "blue",
+  "green",
+  "red",
+  "violet",
+  "cyan"
+];
 var profileSchema = external_exports.object({
   id: profileId,
   name: fsSafeName,
@@ -19030,13 +19040,15 @@ var archiveRequestSchema = external_exports.object({
 });
 
 // ../shared/src/api/projects.ts
-var projectAbbrev = external_exports.string().min(1).max(5);
+var projectAbbrev2 = external_exports.string().min(1).max(5);
+var projectColourSchema = external_exports.enum(PROFILE_ICON_COLOURS);
 var projectSchema = external_exports.object({
   id: projectId,
   profile_id: profileId,
   repo_id: rowId,
   name: external_exports.string(),
-  abbrev: projectAbbrev.nullable().default(null),
+  abbrev: projectAbbrev2.nullable().default(null),
+  colour: projectColourSchema.nullable().optional(),
   /**
    * Hidden from the homescreen but never deleted — every session, worktree, and
    * bit of data is retained, and un-archiving restores it all (SPEC §11).
@@ -19050,11 +19062,13 @@ var createProjectRequestSchema = external_exports.object({
   profile_id: profileId,
   repo_id: rowId,
   name: external_exports.string().min(1).max(100),
-  abbrev: projectAbbrev.optional()
+  abbrev: projectAbbrev2.optional(),
+  colour: projectColourSchema.nullable().optional()
 });
 var patchProjectRequestSchema = external_exports.object({
   name: external_exports.string().min(1).max(100).optional(),
-  abbrev: projectAbbrev.optional(),
+  abbrev: projectAbbrev2.optional(),
+  colour: projectColourSchema.nullable().optional(),
   archived: external_exports.boolean().optional()
 });
 var projectDetailSchema = external_exports.object({
@@ -19115,7 +19129,9 @@ var compilationProviderSchema = external_exports.object({
   available: external_exports.boolean(),
   /** The preferred host executable when available, for honest capability UI. */
   executor: external_exports.string().min(1).nullable(),
-  eager: external_exports.boolean()
+  eager: external_exports.boolean(),
+  /** Omitted by older providers, whose action remains compilation. */
+  action: external_exports.enum(["compile", "run"]).optional()
 });
 var compilationCapabilitiesResponseSchema = external_exports.object({
   providers: external_exports.array(compilationProviderSchema)
@@ -19184,7 +19200,9 @@ var compilationCommandSlotSchema = external_exports.object({
   /** Stable trigger copy lets a generic dialog explain exactly when this slot runs. */
   run_when: external_exports.enum(["when_clicked", "upon_file_change"]),
   default_command: external_exports.string().min(1).nullable(),
-  override_command: external_exports.string().min(1).nullable()
+  override_command: external_exports.string().min(1).nullable(),
+  /** Profile language default inherited by this file (24.4); null uses the provider. */
+  inherited_command: external_exports.string().min(1).nullable().optional()
 });
 var compilationSettingsRequestSchema = compilationTargetRequestSchema.extend({
   profile_id: profileId,
@@ -19204,6 +19222,18 @@ var updateCompilationSettingsRequestSchema = compilationSettingsRequestSchema.ex
   mode: compilationModeSchema,
   command: external_exports.string().trim().min(1).max(16384).nullable()
 });
+var compilationDefaultsRequestSchema = external_exports.object({
+  profile_id: profileId,
+  provider: compilationProviderIdSchema
+});
+var compilationDefaultsResponseSchema = compilationSettingsResponseSchema.omit({
+  file_type: true,
+  file_path: true
+});
+var updateCompilationDefaultsRequestSchema = compilationDefaultsRequestSchema.extend({
+  mode: compilationModeSchema,
+  command: updateCompilationSettingsRequestSchema.shape.command
+});
 
 // ../shared/src/api/ui-state.ts
 var editorTabRefSchema = external_exports.object({
@@ -19370,6 +19400,31 @@ var patchLayoutRequestSchema = external_exports.object({
   active_session: sessionId.nullable().optional()
 });
 
+// ../shared/src/api/notebooks.ts
+var notebookKernelSpecSchema = external_exports.object({
+  name: external_exports.string().min(1),
+  display_name: external_exports.string().min(1),
+  language: external_exports.string()
+});
+var notebookKernelsResponseSchema = external_exports.object({
+  available: external_exports.boolean(),
+  kernels: external_exports.array(notebookKernelSpecSchema),
+  error: external_exports.string().optional()
+});
+var notebookKernelRequestSchema = external_exports.object({ source: compilationFileTargetSchema });
+var notebookKernelStatusSchema = external_exports.object({
+  state: external_exports.enum(["stopped", "starting", "idle", "busy", "dead"]),
+  kernel: external_exports.string().nullable(),
+  error: external_exports.string().optional()
+});
+var notebookKernelActionSchema = external_exports.discriminatedUnion("action", [
+  notebookKernelRequestSchema.extend({
+    action: external_exports.literal("select"),
+    kernel: external_exports.string().min(1).max(256)
+  }),
+  notebookKernelRequestSchema.extend({ action: external_exports.enum(["interrupt", "restart", "shutdown"]) })
+]);
+
 // ../shared/src/api/latex.ts
 var latexSynctexRequestSchema = compilationFileTargetSchema.extend({
   root: external_exports.string().min(1),
@@ -19669,6 +19724,12 @@ var cockpitRefreshResponseSchema = external_exports.object({
   refreshId: external_exports.string().uuid(),
   instance: external_exports.string().uuid()
 });
+var cockpitFileManagerSchema = external_exports.object({
+  name: external_exports.enum(["Finder", "File Explorer", "File Manager"]).nullable()
+});
+var cockpitRevealRequestSchema = external_exports.object({
+  path: external_exports.string().min(1).max(4096).refine((path) => !path.includes("\0"))
+}).strict();
 
 // ../shared/src/ws/messages.ts
 var termId = external_exports.string().regex(/^(agent|shell-[0-9]+)$/);
@@ -21773,7 +21834,7 @@ async function acquireAuthority(transport) {
 // src/cli/run.ts
 init_attach();
 import { existsSync as existsSync7 } from "node:fs";
-import { dirname as dirname12, join as join17 } from "node:path";
+import { dirname as dirname13, join as join17 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 
 // src/lib/browser.ts
@@ -21817,7 +21878,7 @@ import { readFileSync as readFileSync4 } from "node:fs";
 import { dirname as dirname4, join as join5 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 function cliVersion() {
-  if (true) return "0.3.2";
+  if (true) return "0.3.4";
   const here = dirname4(fileURLToPath2(import.meta.url));
   for (const candidate of [
     join5(here, "..", "..", "package.json"),
@@ -22217,7 +22278,9 @@ var RELEASE_PROTOCOLS = {
   "0.2.24": { major: 22, minor: 5 },
   "0.3.0": { major: 23, minor: 0 },
   "0.3.1": { major: 23, minor: 0 },
-  "0.3.2": { major: 24, minor: 0 }
+  "0.3.2": { major: 24, minor: 0 },
+  "0.3.3": { major: 24, minor: 2 },
+  "0.3.4": { major: 24, minor: 6 }
 };
 function validProtocol(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -23663,6 +23726,34 @@ async function checkRemoteRegistration(req, res, authorised) {
   }
 }
 
+// src/lib/serve/file-manager.ts
+function fileManagerHandler(manager) {
+  let busy = false;
+  return async (req, res, authorised) => {
+    if (req.method === "GET") return json2(res, 200, { name: manager?.name ?? null });
+    if (req.method !== "POST") return fail(res, 405, "method_not_allowed");
+    if (!manager) return fail(res, 404, "file_manager_unavailable");
+    const request = cockpitRevealRequestSchema.parse(await readJson(req));
+    if (!authorised()) return fail(res, 401, "browser_rejected");
+    if (busy) return fail(res, 409, "file_manager_busy", "A folder is already being revealed.");
+    busy = true;
+    try {
+      await manager.reveal(request.path, authorised);
+      res.writeHead(204);
+      res.end();
+    } catch (error51) {
+      fail(
+        res,
+        400,
+        "reveal_failed",
+        error51 instanceof Error ? error51.message : "Could not reveal this path."
+      );
+    } finally {
+      busy = false;
+    }
+  };
+}
+
 // src/lib/serve/ui-server.ts
 var DEFAULT_UI_PORT = 7433;
 var MAX_PORT_PROBES = 50;
@@ -23672,6 +23763,9 @@ async function startUiServer(opts) {
   const tracker = new ProxySocketTracker();
   const serveStatic = createStaticHandler(opts.assetsDir);
   const handleRemoteAccess = remoteAccessHandler(opts.remoteAccess);
+  const handleFileManager = fileManagerHandler(
+    opts.identity === "local" ? opts.fileManager : void 0
+  );
   const nonce = randomUUID3();
   let origin = "";
   let proxyOrigin = "";
@@ -23720,6 +23814,8 @@ async function startUiServer(opts) {
       }
       if (url2.pathname === "/cockpit/local-sync")
         return handleLocalSync(req, res, opts.localSync, () => browsers.valid(browser));
+      if (url2.pathname === "/cockpit/file-manager")
+        return handleFileManager(req, res, () => browsers.valid(browser));
       if (url2.pathname === "/cockpit/remote")
         return handleRemoteAccess(req, res, () => browsers.valid(browser));
       if (url2.pathname === "/cockpit/remote/registration") {
@@ -24383,6 +24479,69 @@ function sanitise(record2) {
 // src/lib/start.ts
 import { join as join14 } from "node:path";
 init_types();
+
+// src/lib/file-manager.ts
+import { execFile, spawn as spawn6 } from "node:child_process";
+import { lstat, stat } from "node:fs/promises";
+import { dirname as dirname9, isAbsolute, win32 } from "node:path";
+import { pathToFileURL } from "node:url";
+import { promisify } from "node:util";
+var execute = promisify(execFile);
+function localFileManager(platform = process.platform) {
+  const name = platform === "darwin" ? "Finder" : platform === "win32" ? "File Explorer" : platform === "linux" ? "File Manager" : null;
+  if (!name) return;
+  return {
+    name,
+    async reveal(path, authorised) {
+      if (!(platform === "win32" ? win32.isAbsolute(path) : isAbsolute(path)) || path.includes("\0"))
+        throw new Error("Expected an absolute local path.");
+      const entry = await lstat(path);
+      const directory = entry.isDirectory() || entry.isSymbolicLink() && await stat(path).then(
+        (target) => target.isDirectory(),
+        () => false
+      );
+      const run3 = async (command, args, detached = false) => {
+        if (!authorised()) throw new Error("Browser authorisation expired.");
+        if (detached) {
+          await new Promise((resolve6, reject) => {
+            const child = spawn6(command, args, { stdio: "ignore", detached: true });
+            child.once("error", reject);
+            child.once("spawn", () => {
+              child.unref();
+              resolve6();
+            });
+          });
+          return;
+        }
+        await execute(command, args, { timeout: 1e4, maxBuffer: 16384, windowsHide: true });
+      };
+      if (platform === "darwin") {
+        await run3("/usr/bin/open", directory ? ["-a", "Finder", "--", path] : ["-R", "--", path]);
+      } else if (platform === "win32") {
+        await run3("explorer.exe", directory ? [path] : ["/select,", path], true);
+      } else {
+        try {
+          await run3("gdbus", [
+            "call",
+            "--session",
+            "--dest",
+            "org.freedesktop.FileManager1",
+            "--object-path",
+            "/org/freedesktop/FileManager1",
+            "--method",
+            `org.freedesktop.FileManager1.${directory ? "ShowFolders" : "ShowItems"}`,
+            JSON.stringify([pathToFileURL(path).href]),
+            ""
+          ]);
+        } catch {
+          await run3("xdg-open", [directory ? path : dirname9(path)], true);
+        }
+      }
+    }
+  };
+}
+
+// src/lib/start.ts
 async function startLocal(opts) {
   const logger = opts.logger ?? silentLogger;
   const transport = new LocalTransport();
@@ -24417,6 +24576,7 @@ async function startLocal(opts) {
       target: { host: "127.0.0.1", port: endpoint.port },
       ...opts.onRefreshRequest !== void 0 ? { control: { onRefresh: opts.onRefreshRequest } } : {},
       localSync: { file: join14(clientHome(), "local-sync.json") },
+      fileManager: localFileManager(),
       remoteAccess: new RemoteAccessControl(transport)
     });
     currentUi = ui;
@@ -24471,23 +24631,23 @@ init_types();
 
 // src/cli/manage-cli.ts
 init_types();
-import { spawn as spawn7 } from "node:child_process";
-import { dirname as dirname10 } from "node:path";
+import { spawn as spawn8 } from "node:child_process";
+import { dirname as dirname11 } from "node:path";
 
 // src/lib/standalone-cli.ts
 init_types();
-import { spawn as spawn6 } from "node:child_process";
+import { spawn as spawn7 } from "node:child_process";
 import { existsSync as existsSync5, lstatSync as lstatSync2, readFileSync as readFileSync9, realpathSync as realpathSync2 } from "node:fs";
 import { mkdir as mkdir2, readFile as readFile2, rm as rm2, unlink } from "node:fs/promises";
-import { basename, dirname as dirname9, isAbsolute, join as join15, resolve as resolve5 } from "node:path";
+import { basename, dirname as dirname10, isAbsolute as isAbsolute2, join as join15, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 function standaloneInstallation(entryFile = fileURLToPath4(import.meta.url), execPath = process.execPath) {
-  const release = resolve5(dirname9(entryFile), "..");
+  const release = resolve5(dirname10(entryFile), "..");
   if (!existsSync5(join15(release, "STANDALONE"))) return null;
   try {
     const root = resolve5(release, "..", "..");
     const record2 = JSON.parse(readFileSync9(join15(root, "installation.json"), "utf8"));
-    if (readFileSync9(join15(release, "STANDALONE"), "utf8").trim() !== "puddle-cli" || readFileSync9(join15(root, "INSTALLATION"), "utf8").trim() !== "puddle-cli" || dirname9(release) !== join15(root, "versions") || realpathSync2(release) !== release || realpathSync2(execPath) !== join15(release, "bin/node") || record2.kind !== "puddle-cli" || typeof record2.launcher !== "string" || !isAbsolute(record2.launcher) || record2.scriptLauncher !== void 0 && record2.scriptLauncher !== join15(dirname9(record2.launcher), "pudl") && record2.scriptLauncher !== join15(dirname9(record2.launcher), "puddlang"))
+    if (readFileSync9(join15(release, "STANDALONE"), "utf8").trim() !== "puddle-cli" || readFileSync9(join15(root, "INSTALLATION"), "utf8").trim() !== "puddle-cli" || dirname10(release) !== join15(root, "versions") || realpathSync2(release) !== release || realpathSync2(execPath) !== join15(release, "bin/node") || record2.kind !== "puddle-cli" || typeof record2.launcher !== "string" || !isAbsolute2(record2.launcher) || record2.scriptLauncher !== void 0 && record2.scriptLauncher !== join15(dirname10(record2.launcher), "pudl") && record2.scriptLauncher !== join15(dirname10(record2.launcher), "puddlang"))
       throw new Error("Installation metadata does not match this CLI");
     return {
       root,
@@ -24511,12 +24671,12 @@ function upgradeStandaloneCli(installation, version2, repo) {
     "--prefix",
     installation.root,
     "--bin-dir",
-    dirname9(installation.launcher)
+    dirname10(installation.launcher)
   ];
   if (version2 !== void 0) args.push("--version", version2);
   if (repo !== void 0) args.push("--repo", repo);
   return new Promise((resolve6, reject) => {
-    const child = spawn6("sh", args, { stdio: ["pipe", "inherit", "inherit"] });
+    const child = spawn7("sh", args, { stdio: ["pipe", "inherit", "inherit"] });
     child.on("error", reject);
     child.stdin.on("error", (error51) => {
       if (error51.code !== "EPIPE") reject(error51);
@@ -24571,7 +24731,7 @@ function upgradeCli(version2, logger) {
   const spec = `@puddle-code/cli@${version2 ?? "latest"}`;
   logger.info(`puddle CLI ${cliVersion()} \u2014 asking npm for ${version2 ?? "the latest release"}`);
   return new Promise((resolve6, reject) => {
-    const child = spawn7("npm", ["install", "-g", spec], { stdio: "inherit" });
+    const child = spawn8("npm", ["install", "-g", spec], { stdio: "inherit" });
     child.on(
       "error",
       () => reject(
@@ -24596,7 +24756,7 @@ async function removeCli(yes, logger) {
   const standalone = standaloneInstallation();
   if (standalone) {
     const proceed2 = await confirm(
-      `Remove the standalone CLI at ${standalone.root} and its launcher in ${dirname10(standalone.launcher)}? Close its cockpits first; daemons and their sessions are untouched.`,
+      `Remove the standalone CLI at ${standalone.root} and its launcher in ${dirname11(standalone.launcher)}? Close its cockpits first; daemons and their sessions are untouched.`,
       { skip: yes }
     );
     if (!proceed2) {
@@ -24608,7 +24768,7 @@ async function removeCli(yes, logger) {
     return 0;
   }
   const managed = await new Promise((resolve6) => {
-    const child = spawn7("npm", ["ls", "-g", "@puddle-code/cli", "--depth=0"], { stdio: "ignore" });
+    const child = spawn8("npm", ["ls", "-g", "@puddle-code/cli", "--depth=0"], { stdio: "ignore" });
     child.on("error", () => resolve6(false));
     child.on("exit", (code) => resolve6(code === 0));
   });
@@ -24628,7 +24788,7 @@ async function removeCli(yes, logger) {
     return 0;
   }
   return new Promise((resolve6, reject) => {
-    const child = spawn7("npm", ["uninstall", "-g", "@puddle-code/cli"], { stdio: "inherit" });
+    const child = spawn8("npm", ["uninstall", "-g", "@puddle-code/cli"], { stdio: "inherit" });
     child.on("error", () => reject(new CliError("not_installed", "npm is not on PATH")));
     child.on("exit", (code) => {
       if (code === 0) {
@@ -24642,7 +24802,7 @@ async function removeCli(yes, logger) {
 }
 
 // src/cli/manage.ts
-import { spawn as spawn9 } from "node:child_process";
+import { spawn as spawn10 } from "node:child_process";
 import { existsSync as existsSync6 } from "node:fs";
 import { chmod as chmod2, copyFile, mkdir as mkdir3, rename, rm as rm3 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
@@ -24783,9 +24943,9 @@ async function upgradeDaemon(transport, opts = {}) {
 }
 
 // src/cli/detach.ts
-import { spawn as spawn8 } from "node:child_process";
+import { spawn as spawn9 } from "node:child_process";
 import { closeSync as closeSync2, mkdirSync as mkdirSync6, openSync as openSync2, readFileSync as readFileSync10 } from "node:fs";
-import { dirname as dirname11 } from "node:path";
+import { dirname as dirname12 } from "node:path";
 init_types();
 var COCKPIT_CHILD_ENV = "PUDDLE_COCKPIT_CHILD";
 var READY_TIMEOUT_MS = 3e5;
@@ -24824,10 +24984,10 @@ async function launchDetached(opts) {
   }
   if (target !== "local") await new SshTransport(target).open();
   const logFile = cockpitLogPath(target);
-  mkdirSync6(dirname11(logFile), { recursive: true });
+  mkdirSync6(dirname12(logFile), { recursive: true });
   const fd = openSync2(logFile, "w");
   const argv = opts.argv ?? process.argv.slice(2);
-  const child = spawn8(process.execPath, [process.argv[1] ?? "", ...argv], {
+  const child = spawn9(process.execPath, [process.argv[1] ?? "", ...argv], {
     detached: true,
     stdio: ["ignore", fd, fd, "ipc"],
     env: { ...process.env, [COCKPIT_CHILD_ENV]: "1" }
@@ -24892,7 +25052,7 @@ async function followStartup(target, childPid, logFile) {
 }
 function spawnDetachedRefresh(target, argv, refreshId) {
   const logFile = cockpitLogPath(target);
-  mkdirSync6(dirname11(logFile), { recursive: true });
+  mkdirSync6(dirname12(logFile), { recursive: true });
   const fd = openSync2(logFile, "a");
   const env = {
     ...process.env,
@@ -24900,7 +25060,7 @@ function spawnDetachedRefresh(target, argv, refreshId) {
     PUDDLE_INTERNAL_REFRESH: "1"
   };
   delete env[COCKPIT_CHILD_ENV];
-  const child = spawn8(process.execPath, [process.argv[1] ?? "", ...argv], {
+  const child = spawn9(process.execPath, [process.argv[1] ?? "", ...argv], {
     detached: true,
     stdio: ["ignore", fd, fd],
     env
@@ -25135,7 +25295,7 @@ async function installDesktopAppImage(version2, logger) {
     ...protocol ? { protocol } : {}
   });
   logger.info(`installed \u2014 run it directly (${target}) or add it to your launcher`);
-  const opener = spawn9("xdg-open", [dir], { stdio: "ignore", detached: true });
+  const opener = spawn10("xdg-open", [dir], { stdio: "ignore", detached: true });
   opener.on("error", () => void 0);
   opener.unref();
   return 0;
@@ -25302,7 +25462,7 @@ function timestampedLogger() {
 
 // src/cli/run.ts
 function assetsDir() {
-  const here = dirname12(fileURLToPath5(import.meta.url));
+  const here = dirname13(fileURLToPath5(import.meta.url));
   for (const candidate of [join17(here, "public"), join17(here, "..", "..", "dist", "public")]) {
     if (existsSync7(join17(candidate, "index.html"))) return candidate;
   }