fluncle 0.93.0 → 0.94.0

package/bin/fluncle.mjs

@@ -556,7 +556,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.93.0".trim() ? "0.93.0".trim() : "0.1.0";
+  currentVersion = "0.94.0".trim() ? "0.94.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2186,7 +2186,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.93.0".trim() ? "0.93.0".trim() : "0.1.0";
+  currentVersion2 = "0.94.0".trim() ? "0.94.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3144,6 +3144,224 @@ var init_track = __esm(() => {
   NON_FILE_OPTIONS = ["model", "reasoning"];
 });
 
+// src/commands/helm.ts
+var exports_helm = {};
+__export(exports_helm, {
+  resolveHelmDir: () => resolveHelmDir,
+  helmUninstallCommand: () => helmUninstallCommand,
+  helmOpenCommand: () => helmOpenCommand,
+  helmInstallCommand: () => helmInstallCommand,
+  buildLaunchAgentPlist: () => buildLaunchAgentPlist
+});
+import { existsSync, mkdirSync as mkdirSync2, openSync, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { dirname as dirname3, join as join4, resolve } from "node:path";
+function launchAgentPlistPath() {
+  return join4(homedir4(), "Library/LaunchAgents", `${LAUNCH_AGENT_LABEL}.plist`);
+}
+function helmLogPath() {
+  return join4(homedir4(), "Library/Logs/fluncle-helm.log");
+}
+function resolveHelmDir() {
+  const fromEnv = process.env.FLUNCLE_HELM_DIR;
+  if (fromEnv) {
+    if (!existsSync(join4(fromEnv, "src/server.ts"))) {
+      throw new CliError2("helm_not_found", `FLUNCLE_HELM_DIR points at ${fromEnv}, but there's no helm there (src/server.ts missing).`);
+    }
+    return resolve(fromEnv);
+  }
+  let dir = import.meta.dir;
+  for (let depth = 0;depth < 8; depth++) {
+    const candidate = join4(dir, "apps/helm");
+    if (existsSync(join4(candidate, "src/server.ts"))) {
+      return candidate;
+    }
+    const parent = dirname3(dir);
+    if (parent === dir) {
+      break;
+    }
+    dir = parent;
+  }
+  throw new CliError2("helm_not_found", "No helm aboard. Run this from the fluncle repo, or set FLUNCLE_HELM_DIR to the apps/helm checkout.");
+}
+function resolveBun() {
+  const bun = Bun.which("bun");
+  if (!bun) {
+    throw new CliError2("no_bun", "No bun on the PATH. The helm daemon runs under bun.");
+  }
+  return bun;
+}
+async function daemonHealthy() {
+  try {
+    const response = await fetch(`${HELM_URL}/api/health`, {
+      signal: AbortSignal.timeout(1500)
+    });
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+async function ensureBuilt(helmDir) {
+  if (existsSync(join4(helmDir, "dist/index.html"))) {
+    return;
+  }
+  console.log("The glass isn't built yet. Building it once…");
+  const proc = Bun.spawn([resolveBun(), "run", "build"], {
+    cwd: helmDir,
+    stderr: "inherit",
+    stdin: "ignore",
+    stdout: "inherit"
+  });
+  const exitCode = await proc.exited;
+  if (exitCode !== 0) {
+    throw new CliError2("helm_build_failed", `The glass build failed (exit ${exitCode}).`);
+  }
+}
+function bootDaemon(helmDir) {
+  const logPath = helmLogPath();
+  mkdirSync2(dirname3(logPath), { recursive: true });
+  const logFd = openSync(logPath, "a");
+  const proc = Bun.spawn([resolveBun(), "src/server.ts"], {
+    cwd: helmDir,
+    stderr: logFd,
+    stdin: "ignore",
+    stdout: logFd
+  });
+  proc.unref();
+}
+async function waitForHealth(timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await daemonHealthy()) {
+      return true;
+    }
+    await Bun.sleep(250);
+  }
+  return false;
+}
+async function openAppWindow() {
+  if (process.platform === "darwin" && chromeInstalled()) {
+    const proc = Bun.spawn(["open", "-na", "Google Chrome", "--args", `--app=${HELM_URL}`], {
+      stderr: "ignore",
+      stdin: "ignore",
+      stdout: "ignore"
+    });
+    if (await proc.exited === 0) {
+      return;
+    }
+  }
+  await openExternal(HELM_URL);
+}
+function chromeInstalled() {
+  return existsSync("/Applications/Google Chrome.app") || existsSync(join4(homedir4(), "Applications/Google Chrome.app"));
+}
+async function helmOpenCommand() {
+  if (await daemonHealthy()) {
+    console.log(`The helm holds on :${HELM_PORT}. Opening the window.`);
+    await openAppWindow();
+    return;
+  }
+  const helmDir = resolveHelmDir();
+  await ensureBuilt(helmDir);
+  bootDaemon(helmDir);
+  if (!await waitForHealth(15000)) {
+    throw new CliError2("helm_no_answer", `The daemon didn't answer on :${HELM_PORT}. Its log is at ${helmLogPath()}.`);
+  }
+  console.log(`Helm raised on :${HELM_PORT}. Opening the window.`);
+  await openAppWindow();
+}
+function xmlEscape(text) {
+  return text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+}
+function buildLaunchAgentPlist(helmDir, bunPath, logPath) {
+  const path2 = `${dirname3(bunPath)}:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin`;
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${xmlEscape(path2)}</string>
+  </dict>
+  <key>KeepAlive</key>
+  <dict>
+    <key>SuccessfulExit</key>
+    <false/>
+  </dict>
+  <key>Label</key>
+  <string>${LAUNCH_AGENT_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${xmlEscape(bunPath)}</string>
+    <string>src/server.ts</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardErrorPath</key>
+  <string>${xmlEscape(logPath)}</string>
+  <key>StandardOutPath</key>
+  <string>${xmlEscape(logPath)}</string>
+  <key>WorkingDirectory</key>
+  <string>${xmlEscape(helmDir)}</string>
+</dict>
+</plist>
+`;
+}
+function currentUid() {
+  const uid = typeof process.getuid === "function" ? process.getuid() : undefined;
+  if (uid === undefined) {
+    throw new CliError2("no_uid", "Couldn't read the user id — launchd needs a gui domain.");
+  }
+  return uid;
+}
+async function launchctl(args) {
+  const proc = Bun.spawn(["launchctl", ...args], {
+    stderr: "ignore",
+    stdin: "ignore",
+    stdout: "ignore"
+  });
+  return proc.exited;
+}
+async function helmInstallCommand() {
+  if (process.platform !== "darwin") {
+    throw new CliError2("unsupported_platform", "launchd is a macOS thing. Nothing to install here.");
+  }
+  const helmDir = resolveHelmDir();
+  await ensureBuilt(helmDir);
+  const plistPath = launchAgentPlistPath();
+  mkdirSync2(dirname3(plistPath), { recursive: true });
+  mkdirSync2(dirname3(helmLogPath()), { recursive: true });
+  writeFileSync2(plistPath, buildLaunchAgentPlist(helmDir, resolveBun(), helmLogPath()));
+  const uid = currentUid();
+  await launchctl(["bootout", `gui/${uid}/${LAUNCH_AGENT_LABEL}`]);
+  const exitCode = await launchctl(["bootstrap", `gui/${uid}`, plistPath]);
+  if (exitCode !== 0) {
+    throw new CliError2("launchctl_refused", `launchctl bootstrap refused (exit ${exitCode}). The plist is at ${plistPath}.`);
+  }
+  console.log(`LaunchAgent installed (${LAUNCH_AGENT_LABEL}).`);
+  console.log(`The daemon rises at login and holds :${HELM_PORT}. Log: ${helmLogPath()}`);
+}
+async function helmUninstallCommand() {
+  if (process.platform !== "darwin") {
+    throw new CliError2("unsupported_platform", "launchd is a macOS thing. Nothing to remove here.");
+  }
+  const plistPath = launchAgentPlistPath();
+  await launchctl(["bootout", `gui/${currentUid()}/${LAUNCH_AGENT_LABEL}`]);
+  if (existsSync(plistPath)) {
+    rmSync2(plistPath);
+    console.log("LaunchAgent removed and the daemon stood down.");
+    return;
+  }
+  console.log("No LaunchAgent on file. Nothing stood down.");
+}
+var HELM_PORT = 4190, HELM_URL, LAUNCH_AGENT_LABEL = "com.fluncle.helm";
+var init_helm = __esm(() => {
+  init_open_external();
+  init_output();
+  HELM_URL = `http://127.0.0.1:${HELM_PORT}`;
+});
+
 // src/commands/add.ts
 var exports_add = {};
 __export(exports_add, {
@@ -3675,9 +3893,9 @@ var init_mixtape_youtube2 = __esm(() => {
 
 // src/commands/mixtape-set-video.ts
 import { randomUUID } from "node:crypto";
-import { existsSync, rmSync as rmSync2, statSync as statSync3 } from "node:fs";
+import { existsSync as existsSync2, rmSync as rmSync3, statSync as statSync3 } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join4 } from "node:path";
+import { join as join5 } from "node:path";
 function planMultipart(contentLength, partSize = DEFAULT_PART_SIZE) {
   if (!Number.isInteger(contentLength) || contentLength <= 0) {
     throw new CliError2("invalid_size", `The rendition size must be a positive integer (got ${contentLength})`);
@@ -3732,11 +3950,11 @@ function renditionFfmpegArgs(inputPath, outputPath) {
   ];
 }
 async function uploadRenditionMultipart(masterPath, presignPath, onProgress = () => {}) {
-  if (!existsSync(masterPath)) {
+  if (!existsSync2(masterPath)) {
     throw new CliError2("file_not_found", `Set-video master not found: ${masterPath}`);
   }
   await assertFfmpeg();
-  const renditionPath = join4(tmpdir(), `fluncle-set-${randomUUID()}.mp4`);
+  const renditionPath = join5(tmpdir(), `fluncle-set-${randomUUID()}.mp4`);
   onProgress("Set video: deriving the 1080p faststart rendition (ffmpeg)…");
   await deriveRendition(masterPath, renditionPath);
   try {
@@ -3765,7 +3983,7 @@ async function uploadRenditionMultipart(masterPath, presignPath, onProgress = ()
     }
     return { key: presign.key, url: `${FOUND_BASE2}/${presign.key}` };
   } finally {
-    rmSync2(renditionPath, { force: true });
+    rmSync3(renditionPath, { force: true });
   }
 }
 async function putPart(url, path2, part, onProgress = () => {}) {
@@ -3782,7 +4000,7 @@ async function putPart(url, path2, part, onProgress = () => {}) {
       }
       const backoffMs = 500 * 2 ** (attempt - 1);
       onProgress(`Set video: part ${part.partNumber} dropped — retry ${attempt}/${MAX_PART_ATTEMPTS - 1} in ${backoffMs}ms…`);
-      await new Promise((resolve) => setTimeout(resolve, backoffMs));
+      await new Promise((resolve2) => setTimeout(resolve2, backoffMs));
     }
   }
 }
@@ -3863,7 +4081,7 @@ __export(exports_recordings, {
   recordingDeleteCommand: () => recordingDeleteCommand,
   recordingCreateCommand: () => recordingCreateCommand
 });
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "node:fs";
 async function recordingGet(id) {
   const response = await adminApiGet(`/api/admin/recordings/${encodeURIComponent(id)}`);
   return response.recording;
@@ -3932,7 +4150,7 @@ async function recordingCreateCommand(options = {}) {
   if (!options.video) {
     throw new CliError2("missing_video", "A recording needs a --video <file> to stage");
   }
-  if (!existsSync2(options.video)) {
+  if (!existsSync3(options.video)) {
     throw new CliError2("file_not_found", `Set-video master not found: ${options.video}`);
   }
   const created = await adminApiPost("/api/admin/recordings", {
@@ -3968,7 +4186,7 @@ async function recordingUpdateCommand(id, options = {}) {
     body.parentId = options.parentId;
   }
   if (options.tracklistFile !== undefined) {
-    if (!existsSync2(options.tracklistFile)) {
+    if (!existsSync3(options.tracklistFile)) {
       throw new CliError2("file_not_found", `Tracklist file not found: ${options.tracklistFile}`);
     }
     try {
@@ -4017,7 +4235,7 @@ async function recordingReplaceCuesCommand(id, options = {}) {
   if (!options.cuesFile) {
     throw new CliError2("missing_cues_file", "replace-cues needs a --cues-file <file> (the ordered cue array)");
   }
-  if (!existsSync2(options.cuesFile)) {
+  if (!existsSync3(options.cuesFile)) {
     throw new CliError2("file_not_found", `Cues file not found: ${options.cuesFile}`);
   }
   let cues;
@@ -4057,9 +4275,9 @@ __export(exports_clips, {
   CLIP_AUDIO_BITRATE: () => CLIP_AUDIO_BITRATE
 });
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { rmSync as rmSync3, statSync as statSync4 } from "node:fs";
+import { rmSync as rmSync4, statSync as statSync4 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 function clipFootageKey(clipId) {
   return `${clipId}/footage.mp4`;
 }
@@ -4142,7 +4360,7 @@ async function clipCutCommand(clipId, onProgress = () => {}) {
   }
   const source = await resolveClipSource(clip);
   await assertFfmpeg2();
-  const outputPath = join5(tmpdir2(), `fluncle-clip-${randomUUID2()}.mp4`);
+  const outputPath = join6(tmpdir2(), `fluncle-clip-${randomUUID2()}.mp4`);
   try {
     onProgress(`Clip ${clipId}: cutting [${clip.inMs}–${clip.outMs}ms]…`);
     await runClipCut({
@@ -4168,7 +4386,7 @@ async function clipCutCommand(clipId, onProgress = () => {}) {
       url: `${FOUND_BASE3}/${presign.key}`
     };
   } finally {
-    rmSync3(outputPath, { force: true });
+    rmSync4(outputPath, { force: true });
   }
 }
 async function putClip(url, contentType, path2) {
@@ -4226,7 +4444,7 @@ __export(exports_recordings2, {
   recordingDeleteCommand: () => recordingDeleteCommand2,
   recordingCreateCommand: () => recordingCreateCommand2
 });
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync4, readFileSync as readFileSync3 } from "node:fs";
 async function recordingGet2(id) {
   const response = await adminApiGet(`/api/admin/recordings/${encodeURIComponent(id)}`);
   return response.recording;
@@ -4295,7 +4513,7 @@ async function recordingCreateCommand2(options = {}) {
   if (!options.video) {
     throw new CliError2("missing_video", "A recording needs a --video <file> to stage");
   }
-  if (!existsSync3(options.video)) {
+  if (!existsSync4(options.video)) {
     throw new CliError2("file_not_found", `Set-video master not found: ${options.video}`);
   }
   const created = await adminApiPost("/api/admin/recordings", {
@@ -4331,7 +4549,7 @@ async function recordingUpdateCommand2(id, options = {}) {
     body.parentId = options.parentId;
   }
   if (options.tracklistFile !== undefined) {
-    if (!existsSync3(options.tracklistFile)) {
+    if (!existsSync4(options.tracklistFile)) {
       throw new CliError2("file_not_found", `Tracklist file not found: ${options.tracklistFile}`);
     }
     try {
@@ -4380,7 +4598,7 @@ async function recordingReplaceCuesCommand2(id, options = {}) {
   if (!options.cuesFile) {
     throw new CliError2("missing_cues_file", "replace-cues needs a --cues-file <file> (the ordered cue array)");
   }
-  if (!existsSync3(options.cuesFile)) {
+  if (!existsSync4(options.cuesFile)) {
     throw new CliError2("file_not_found", `Cues file not found: ${options.cuesFile}`);
   }
   let cues;
@@ -4411,7 +4629,7 @@ __export(exports_newsletter, {
   newsletterDraftCommand: () => newsletterDraftCommand,
   newsletterDeleteCommand: () => newsletterDeleteCommand
 });
-import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
 function buildBody2(options, { requireContent }) {
   const body = {};
   if (options.contentFile !== undefined) {
@@ -4431,7 +4649,7 @@ function buildBody2(options, { requireContent }) {
   return body;
 }
 function readContentFile(filePath) {
-  if (!existsSync4(filePath)) {
+  if (!existsSync5(filePath)) {
     throw new CliError2("file_not_found", `Content file not found: ${filePath}`);
   }
   const text = readFileSync4(filePath, "utf-8");
@@ -4823,7 +5041,7 @@ async function selectWithKeyboard2(items, options) {
   let renderedLines = 0;
   let done = false;
   const wasRaw = stdin.isRaw === true;
-  return await new Promise((resolve) => {
+  return await new Promise((resolve2) => {
     function cleanup() {
       if (done) {
         return;
@@ -4838,14 +5056,14 @@ async function selectWithKeyboard2(items, options) {
       cleanup();
       stdout.write(renderedLines > 0 ? `
 ` : "");
-      resolve(item);
+      resolve2(item);
     }
     function cancel() {
       cleanup();
       clearRendered2(stdout, renderedLines);
       stdout.write(`Cancelled.
 `);
-      resolve(undefined);
+      resolve2(undefined);
     }
     function render() {
       clearRendered2(stdout, renderedLines);
@@ -4901,7 +5119,7 @@ async function paginateWithKeyboard(options) {
   let busy = false;
   let done = false;
   const wasRaw = stdin.isRaw === true;
-  return await new Promise((resolve) => {
+  return await new Promise((resolve2) => {
     function cleanup() {
       if (done) {
         return;
@@ -4916,7 +5134,7 @@ async function paginateWithKeyboard(options) {
       cleanup();
       stdout.write(`
 `);
-      resolve();
+      resolve2();
     }
     function render() {
       clearRendered2(stdout, renderedLines);
@@ -5069,7 +5287,7 @@ var init_format2 = __esm(() => {
 });
 
 // src/cli.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync5 } from "fs";
 import path2 from "path";
 
 // ../../node_modules/commander/lib/error.js
@@ -7215,6 +7433,7 @@ ${fluncleAsciiLogo}
   addMetaCommands(program2);
   addTrackCommands(program2);
   addAdminCommands(program2);
+  addHelmCommands(program2);
   return program2;
 }
 async function main(args = process.argv.slice(2)) {
@@ -7313,6 +7532,21 @@ function addTrackCommands(program2) {
     await runTrackGet(idOrLogId, options, trackGetCommand2);
   });
 }
+function addHelmCommands(program2) {
+  const helm = configureCommand(program2.command("helm", { hidden: true }).description("Fluncle's Helm \u2014 the operator's mission control"));
+  helm.action(async () => {
+    const { helmOpenCommand: helmOpenCommand2 } = await Promise.resolve().then(() => (init_helm(), exports_helm));
+    await helmOpenCommand2();
+  });
+  helm.command("install").description("Install the launchd LaunchAgent (the daemon rises at login)").action(async () => {
+    const { helmInstallCommand: helmInstallCommand2 } = await Promise.resolve().then(() => (init_helm(), exports_helm));
+    await helmInstallCommand2();
+  });
+  helm.command("uninstall").description("Remove the LaunchAgent and stand the daemon down").action(async () => {
+    const { helmUninstallCommand: helmUninstallCommand2 } = await Promise.resolve().then(() => (init_helm(), exports_helm));
+    await helmUninstallCommand2();
+  });
+}
 function addAdminCommands(program2) {
   const admin = configureCommand(program2.command("admin", { hidden: true }).description("Operator commands"));
   admin.action(() => {
@@ -7792,7 +8026,7 @@ async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
       return;
     }
     const candidate = path2.join(dir, name);
-    return existsSync5(candidate) ? candidate : undefined;
+    return existsSync6(candidate) ? candidate : undefined;
   };
   const resolveFile = (explicit, name) => {
     if (explicit) {

package/package.json

@@ -31,5 +31,5 @@
     "url": "git+https://github.com/mauricekleine/fluncle.git"
   },
   "type": "module",
-  "version": "0.93.0"
+  "version": "0.94.0"
 }