fluncle 0.94.0 → 0.96.0

package/bin/fluncle.mjs

@@ -556,7 +556,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.94.0".trim() ? "0.94.0".trim() : "0.1.0";
+  currentVersion = "0.96.0".trim() ? "0.96.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.94.0".trim() ? "0.94.0".trim() : "0.1.0";
+  currentVersion2 = "0.96.0".trim() ? "0.96.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2789,6 +2789,17 @@ var init_src = __esm(() => {
       probeConfig: { cadenceMs: 10 * MINUTE_MS, cronName: "fluncle-social-capture", kind: "cron" },
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin clips drip-pause",
+      exposedContent: [
+        "post the due, cut clips to Instagram on a jittered ~daily cadence via Postiz (--no-agent, Worker HTTP)"
+      ],
+      kind: "cron",
+      name: "cron.clip-drip",
+      operatorNotes: "every 20m. Pure HTTP trigger, zero LLM tokens. Admin tier (needs the Worker's Postiz key, which the box never sees — the box only triggers; the `finalize_clip_cut` / `record_health` precedent). The Worker checks the global kill switch FIRST (paused → no-op), then posts due clips bounded by a per-tick cap AND a rolling-24h IG cap. Every clip auto-enters the schedule at a jittered ~23-25h after the queue tail. The operator pauses/resumes with `fluncle admin clips drip-pause` / `drip-resume`. Source: docs/agents/hermes/scripts/clip-drip-sweep.sh. Probed on /status as cron.clip-drip.",
+      probeConfig: { cadenceMs: 20 * MINUTE_MS, cronName: "fluncle-clip-drip", kind: "cron" },
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin tracks queue",
       exposedContent: [
@@ -3153,7 +3164,7 @@ __export(exports_helm, {
   helmInstallCommand: () => helmInstallCommand,
   buildLaunchAgentPlist: () => buildLaunchAgentPlist
 });
-import { existsSync, mkdirSync as mkdirSync2, openSync, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync, mkdirSync as mkdirSync2, openSync, rmSync as rmSync2, writeFileSync as writeFileSync2, readFileSync as readFileSync2 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
 import { dirname as dirname3, join as join4, resolve } from "node:path";
 function launchAgentPlistPath() {
@@ -3162,15 +3173,8 @@ function launchAgentPlistPath() {
 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;
+function walkUpForHelm(start) {
+  let dir = start;
   for (let depth = 0;depth < 8; depth++) {
     const candidate = join4(dir, "apps/helm");
     if (existsSync(join4(candidate, "src/server.ts"))) {
@@ -3182,7 +3186,35 @@ function resolveHelmDir() {
     }
     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.");
+  return null;
+}
+function persistHelmDir(dir) {
+  try {
+    mkdirSync2(dirname3(HELM_DIR_FILE), { recursive: true });
+    writeFileSync2(HELM_DIR_FILE, `${dir}
+`, { mode: 384 });
+  } catch {}
+}
+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);
+  }
+  const found = walkUpForHelm(process.cwd()) ?? walkUpForHelm(import.meta.dir);
+  if (found) {
+    persistHelmDir(found);
+    return found;
+  }
+  try {
+    const remembered = readFileSync2(HELM_DIR_FILE, "utf8").trim();
+    if (remembered && existsSync(join4(remembered, "src/server.ts"))) {
+      return remembered;
+    }
+  } catch {}
+  throw new CliError2("helm_not_found", "No helm aboard. Run this once from the fluncle repo (the helm remembers the way after that), or set FLUNCLE_HELM_DIR.");
 }
 function resolveBun() {
   const bun = Bun.which("bun");
@@ -3355,11 +3387,12 @@ async function helmUninstallCommand() {
   }
   console.log("No LaunchAgent on file. Nothing stood down.");
 }
-var HELM_PORT = 4190, HELM_URL, LAUNCH_AGENT_LABEL = "com.fluncle.helm";
+var HELM_PORT = 4190, HELM_URL, LAUNCH_AGENT_LABEL = "com.fluncle.helm", HELM_DIR_FILE;
 var init_helm = __esm(() => {
   init_open_external();
   init_output();
   HELM_URL = `http://127.0.0.1:${HELM_PORT}`;
+  HELM_DIR_FILE = join4(homedir4(), ".config/fluncle/helm-dir");
 });
 
 // src/commands/add.ts
@@ -4081,7 +4114,7 @@ __export(exports_recordings, {
   recordingDeleteCommand: () => recordingDeleteCommand,
   recordingCreateCommand: () => recordingCreateCommand
 });
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
 async function recordingGet(id) {
   const response = await adminApiGet(`/api/admin/recordings/${encodeURIComponent(id)}`);
   return response.recording;
@@ -4190,7 +4223,7 @@ async function recordingUpdateCommand(id, options = {}) {
       throw new CliError2("file_not_found", `Tracklist file not found: ${options.tracklistFile}`);
     }
     try {
-      body.tracklistJson = JSON.parse(readFileSync2(options.tracklistFile, "utf8"));
+      body.tracklistJson = JSON.parse(readFileSync3(options.tracklistFile, "utf8"));
     } catch {
       throw new CliError2("invalid_tracklist", `Tracklist file is not valid JSON: ${options.tracklistFile}`);
     }
@@ -4240,7 +4273,7 @@ async function recordingReplaceCuesCommand(id, options = {}) {
   }
   let cues;
   try {
-    cues = JSON.parse(readFileSync2(options.cuesFile, "utf8"));
+    cues = JSON.parse(readFileSync3(options.cuesFile, "utf8"));
   } catch {
     throw new CliError2("invalid_cues", `Cues file is not valid JSON: ${options.cuesFile}`);
   }
@@ -4262,7 +4295,10 @@ var exports_clips = {};
 __export(exports_clips, {
   setVideoUrl: () => setVideoUrl,
   clipsListCommand: () => clipsListCommand,
+  clipScheduleCommand: () => clipScheduleCommand,
+  clipPostsListCommand: () => clipPostsListCommand,
   clipFootageKey: () => clipFootageKey,
+  clipDripPauseCommand: () => clipDripPauseCommand,
   clipCutFilterComplex: () => clipCutFilterComplex,
   clipCutFfmpegArgs: () => clipCutFfmpegArgs,
   clipCutCommand: () => clipCutCommand,
@@ -4339,6 +4375,20 @@ async function clipsListCommand(filter = {}) {
   const response = await adminApiGet(`/api/admin/clips${query ? `?${query}` : ""}`);
   return response.clips;
 }
+async function clipPostsListCommand() {
+  const response = await adminApiGet("/api/admin/clips/social");
+  return response.posts;
+}
+async function clipScheduleCommand(clipId, scheduledFor) {
+  const response = await adminApiPatch(`/api/admin/clips/${encodeURIComponent(clipId)}/schedule`, { scheduledFor });
+  return response.post;
+}
+async function clipDripPauseCommand(paused) {
+  const response = await adminApiPut("/api/admin/clips/drip/state", {
+    paused
+  });
+  return response.paused;
+}
 async function resolveClipSource(clip) {
   if (!clip.recordingId) {
     throw new CliError2("clip_unlinked", `Clip ${clip.id} is linked to no recording`);
@@ -4444,7 +4494,7 @@ __export(exports_recordings2, {
   recordingDeleteCommand: () => recordingDeleteCommand2,
   recordingCreateCommand: () => recordingCreateCommand2
 });
-import { existsSync as existsSync4, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
 async function recordingGet2(id) {
   const response = await adminApiGet(`/api/admin/recordings/${encodeURIComponent(id)}`);
   return response.recording;
@@ -4553,7 +4603,7 @@ async function recordingUpdateCommand2(id, options = {}) {
       throw new CliError2("file_not_found", `Tracklist file not found: ${options.tracklistFile}`);
     }
     try {
-      body.tracklistJson = JSON.parse(readFileSync3(options.tracklistFile, "utf8"));
+      body.tracklistJson = JSON.parse(readFileSync4(options.tracklistFile, "utf8"));
     } catch {
       throw new CliError2("invalid_tracklist", `Tracklist file is not valid JSON: ${options.tracklistFile}`);
     }
@@ -4603,7 +4653,7 @@ async function recordingReplaceCuesCommand2(id, options = {}) {
   }
   let cues;
   try {
-    cues = JSON.parse(readFileSync3(options.cuesFile, "utf8"));
+    cues = JSON.parse(readFileSync4(options.cuesFile, "utf8"));
   } catch {
     throw new CliError2("invalid_cues", `Cues file is not valid JSON: ${options.cuesFile}`);
   }
@@ -4629,7 +4679,7 @@ __export(exports_newsletter, {
   newsletterDraftCommand: () => newsletterDraftCommand,
   newsletterDeleteCommand: () => newsletterDeleteCommand
 });
-import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
 function buildBody2(options, { requireContent }) {
   const body = {};
   if (options.contentFile !== undefined) {
@@ -4652,7 +4702,7 @@ function readContentFile(filePath) {
   if (!existsSync5(filePath)) {
     throw new CliError2("file_not_found", `Content file not found: ${filePath}`);
   }
-  const text = readFileSync4(filePath, "utf-8");
+  const text = readFileSync5(filePath, "utf-8");
   try {
     return JSON.parse(text);
   } catch (error) {
@@ -5287,7 +5337,7 @@ var init_format2 = __esm(() => {
 });
 
 // src/cli.ts
-import { existsSync as existsSync6, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
 import path2 from "path";
 
 // ../../node_modules/commander/lib/error.js
@@ -7682,8 +7732,20 @@ function addAdminCommands(program2) {
     adminClips.outputHelp();
   });
   adminClips.command("list").description("List clips (filter by --status pending|done and/or --recording <id>)").option("--status <status>", "Filter by cut status (pending|done)").option("--recording <id>", "Filter by recording id").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
-    const { clipsListCommand: clipsListCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
-    await runClipsList(options, clipsListCommand2);
+    const { clipsListCommand: clipsListCommand2, clipPostsListCommand: clipPostsListCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
+    await runClipsList(options, clipsListCommand2, clipPostsListCommand2);
+  });
+  adminClips.command("schedule").description("Set or override a clip's Instagram drip slot (operator)").argument("[clipId]").requiredOption("--at <iso>", "The drip slot, an ISO-8601 timestamp").option("--json", "Print JSON", false).allowExcessArguments().action(async (clipId, options) => {
+    const { clipScheduleCommand: clipScheduleCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
+    await runClipsSchedule(clipId, options, clipScheduleCommand2);
+  });
+  adminClips.command("drip-pause").description("Pause the whole Instagram drip-feed \u2014 the kill switch (operator)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { clipDripPauseCommand: clipDripPauseCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
+    await runClipsDripPause(true, options, clipDripPauseCommand2);
+  });
+  adminClips.command("drip-resume").description("Resume the Instagram drip-feed \u2014 clear the kill switch (operator)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { clipDripPauseCommand: clipDripPauseCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
+    await runClipsDripPause(false, options, clipDripPauseCommand2);
   });
   adminClips.command("cut").description("Cut one clip's framed 9:16 footage from its set rendition, then ship it").argument("[clipId]").option("--json", "Print JSON", false).allowExcessArguments().action(async (clipId, options) => {
     const { clipCutCommand: clipCutCommand2 } = await Promise.resolve().then(() => (init_clips(), exports_clips));
@@ -7824,7 +7886,7 @@ async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCo
   console.log(`  mime: ${result.mime}`);
 }
 async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
-  const script = options.scriptFile ? readFileSync5(options.scriptFile, "utf8") : options.script;
+  const script = options.scriptFile ? readFileSync6(options.scriptFile, "utf8") : options.script;
   if (!idOrLogId || !script || !script.trim()) {
     throw new Error("Usage: fluncle admin tracks observe <track_id|log_id> (--script <text> | --script-file <file>) [--voice-id <id>] [--duration-ms <ms>] [--context-note <text>] [--json]");
   }
@@ -7880,7 +7942,7 @@ async function runTrackContext(idOrLogId, options, trackContextCommand2) {
   }
 }
 async function runTrackNote(idOrLogId, options, trackNoteCommand2) {
-  const note = options.scriptFile ? readFileSync5(options.scriptFile, "utf8") : options.script;
+  const note = options.scriptFile ? readFileSync6(options.scriptFile, "utf8") : options.script;
   if (!idOrLogId || !note || !note.trim()) {
     throw new Error("Usage: fluncle admin tracks note <track_id|log_id> (--script <text> | --script-file <file>) [--json]");
   }
@@ -8299,13 +8361,17 @@ async function runMixtapeList(options, mixtapeListCommand2) {
     console.log(`${coordinate3}	${status}	${mixtape.memberCount} bangers	${mixtape.title}`);
   }
 }
-async function runClipsList(options, clipsListCommand2) {
-  const clips = await clipsListCommand2({
-    recordingId: options.recording,
-    status: options.status
-  });
+async function runClipsList(options, clipsListCommand2, clipPostsListCommand2) {
+  const [clips, posts] = await Promise.all([
+    clipsListCommand2({ recordingId: options.recording, status: options.status }),
+    clipPostsListCommand2().catch(() => [])
+  ]);
+  const dripByClip = new Map(posts.map((post) => [post.clipId, post]));
   if (options.json) {
-    printJson({ clips, ok: true });
+    printJson({
+      clips: clips.map((clip) => ({ ...clip, drip: dripByClip.get(clip.id) })),
+      ok: true
+    });
     return;
   }
   if (clips.length === 0) {
@@ -8314,7 +8380,9 @@ async function runClipsList(options, clipsListCommand2) {
   }
   for (const clip of clips) {
     const source = clip.recordingId ?? "\u2014";
-    console.log(`${clip.id}	${clip.status}	${source}	${clip.inMs}-${clip.outMs}ms	x=${clip.xOffset}`);
+    const post = dripByClip.get(clip.id);
+    const drip = post ? `${post.status} ${post.scheduledFor}` : "\u2014";
+    console.log(`${clip.id}	${clip.status}	${source}	${clip.inMs}-${clip.outMs}ms	x=${clip.xOffset}	${drip}`);
   }
 }
 async function runClipsCut(clipId, options, clipCutCommand2) {
@@ -8329,6 +8397,25 @@ async function runClipsCut(clipId, options, clipCutCommand2) {
   }
   console.log(`Cut ${result.clipId} \u2192 ${result.url} (${(result.sizeBytes / 1e6).toFixed(1)} MB).`);
 }
+async function runClipsSchedule(clipId, options, clipScheduleCommand2) {
+  if (!clipId) {
+    throw new Error("Missing clip id. Usage: fluncle admin clips schedule <clipId> --at <iso>");
+  }
+  const post = await clipScheduleCommand2(clipId, options.at);
+  if (options.json) {
+    printJson({ ok: true, post });
+    return;
+  }
+  console.log(`Scheduled ${post.clipId} for ${post.scheduledFor}.`);
+}
+async function runClipsDripPause(paused, options, clipDripPauseCommand2) {
+  const result = await clipDripPauseCommand2(paused);
+  if (options.json) {
+    printJson({ ok: true, paused: result });
+    return;
+  }
+  console.log(result ? "The drip-feed is paused." : "The drip-feed is running.");
+}
 async function runMixtapeGet(idOrLogId, options, mixtapeGetCommand2) {
   if (!idOrLogId) {
     throw new Error("Missing mixtape id or log id. Usage: fluncle admin mixtapes get <id|logId>");

package/package.json

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