fluncle 0.112.0 → 0.114.0

package/bin/fluncle.mjs

@@ -557,7 +557,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.112.0".trim() ? "0.112.0".trim() : "0.1.0";
+  currentVersion = "0.114.0".trim() ? "0.114.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2209,7 +2209,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.112.0".trim() ? "0.112.0".trim() : "0.1.0";
+  currentVersion2 = "0.114.0".trim() ? "0.114.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2244,6 +2244,18 @@ var init_src = __esm(() => {
       url: `${SITE}/log`,
       weights: { ssh: "secondary", web: "primary" }
     },
+    {
+      exposedContent: [
+        "Fluncle's Logbook — the voyage as a first-person travelogue, one entry per sector-day",
+        "/logbook/:sector — one day written up, the findings inlined as photos"
+      ],
+      kind: "web_route",
+      name: "web.logbook",
+      probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
+      route: "/logbook",
+      url: `${SITE}/logbook`,
+      weights: { ssh: "tertiary", web: "primary" }
+    },
     {
       exposedContent: ["Fluncle's own DJ mixtapes — each a checkpoint set with an F-marked Log ID"],
       kind: "web_route",
@@ -2253,6 +2265,18 @@ var init_src = __esm(() => {
       url: `${SITE}/mixtapes`,
       weights: { ssh: "secondary", web: "primary" }
     },
+    {
+      exposedContent: [
+        "the mixability set-builder — chain a set from Fluncle's findings that mixes clean, share it as a link"
+      ],
+      kind: "web_route",
+      name: "web.mix",
+      operatorNotes: "ADMIN-GATED at launch (RFC mixability-engine, Decision 1): the full /mix set-builder ships behind admin auth until the archive clears the ~250-finding floor. Registered here as `pending` (dark to every public consumer — the dev-row, llms.txt, the sitemap, /status) so going public is one flip: remove `pending` + set a web weight + announce. The `list_mixable_tracks` API op already ships at its final public tier, so the flip needs no rebuild. No probeConfig — the admin gate 302s a bare GET to /admin/login, which would read as a false 'down'.",
+      pending: true,
+      route: "/mix",
+      url: `${SITE}/mix`,
+      weights: { web: "secondary" }
+    },
     {
       exposedContent: [
         "the feed-first Stories surface — full-bleed findings",
@@ -2851,6 +2875,22 @@ var init_src = __esm(() => {
       probeConfig: { cadenceMs: 10 * MINUTE_MS, cronName: "fluncle-note", kind: "cron" },
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin logbook gaps",
+      exposedContent: [
+        "author the previous day's Logbook travelogue entry, fill-empty-only (hybrid: one claude -p call)"
+      ],
+      kind: "cron",
+      name: "cron.logbook",
+      operatorNotes: "00:40 Amsterdam daily. Hybrid --no-agent; one claude -p writes the day up. Never clobbers an operator entry; the self-healing gap window backfills history oldest-first. Source: docs/agents/hermes/scripts/logbook-sweep.{sh,ts}.",
+      probeConfig: {
+        cadenceMs: 24 * 60 * MINUTE_MS,
+        cronName: "fluncle-logbook",
+        kind: "cron",
+        schedule: { time: "00:40", tz: "Europe/Amsterdam" }
+      },
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin tracks observe --queue",
       exposedContent: [
@@ -3458,6 +3498,7 @@ __export(exports_admin_tracks, {
   queueCommand: () => queueCommand,
   observeQueueCommand: () => observeQueueCommand,
   noteQueueCommand: () => noteQueueCommand,
+  mixableOrderCommand: () => mixableOrderCommand,
   listCommand: () => listCommand,
   enrichQueueCommand: () => enrichQueueCommand,
   embedQueueCommand: () => embedQueueCommand,
@@ -3637,6 +3678,13 @@ async function vehiclesCommand(limit) {
     vehicle: track.videoVehicle
   }));
 }
+async function mixableOrderCommand(logIds, seed) {
+  const params = new URLSearchParams({ ids: logIds.join(",") });
+  if (seed) {
+    params.set("seed", seed);
+  }
+  return adminApiGet(`/api/admin/tracks/mixable-order?${params.toString()}`);
+}
 var pageSize3 = 48;
 var init_admin_tracks = __esm(() => {
   init_api();
@@ -4821,6 +4869,54 @@ var init_newsletter = __esm(() => {
   init_output();
 });
 
+// src/commands/admin-logbook.ts
+var exports_admin_logbook = {};
+__export(exports_admin_logbook, {
+  logbookUpdateCommand: () => logbookUpdateCommand,
+  logbookGapsCommand: () => logbookGapsCommand,
+  logbookCreateCommand: () => logbookCreateCommand
+});
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
+async function logbookGapsCommand(limit) {
+  const query = typeof limit === "number" ? `?limit=${encodeURIComponent(String(limit))}` : "";
+  const response = await adminApiGet(`/api/admin/logbook/gaps${query}`);
+  return response.gaps;
+}
+function resolveBody(options) {
+  if (options.body !== undefined) {
+    return options.body;
+  }
+  if (options.bodyFile !== undefined) {
+    if (!existsSync5(options.bodyFile)) {
+      throw new CliError2("file_not_found", `Body file not found: ${options.bodyFile}`);
+    }
+    return readFileSync5(options.bodyFile, "utf-8");
+  }
+  throw new CliError2("missing_body", "An entry needs a body via --body <text> or --body-file <entry.md>");
+}
+function requireTitle(options) {
+  if (options.title === undefined || !options.title.trim()) {
+    throw new CliError2("missing_title", "An entry needs a title via --title <text>");
+  }
+  return options.title;
+}
+async function logbookCreateCommand(sector, options) {
+  return adminApiPost(`/api/admin/logbook/${encodeURIComponent(sector)}`, {
+    body: resolveBody(options),
+    title: requireTitle(options)
+  });
+}
+async function logbookUpdateCommand(sector, options) {
+  return adminApiPatch(`/api/admin/logbook/${encodeURIComponent(sector)}`, {
+    body: resolveBody(options),
+    title: requireTitle(options)
+  });
+}
+var init_admin_logbook = __esm(() => {
+  init_api();
+  init_output();
+});
+
 // src/commands/add.ts
 async function addCommand2(spotifyUrl, options) {
   const result = await adminApiPost("/api/admin/tracks", {
@@ -5485,7 +5581,7 @@ var init_format2 = __esm(() => {
 });
 
 // src/cli.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
 import path2 from "path";
 
 // ../../node_modules/commander/lib/error.js
@@ -7801,6 +7897,10 @@ function addAdminCommands(program2) {
     const { trackGetAdminCommand: trackGetAdminCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackGetAdmin(idOrLogId, options, trackGetAdminCommand2);
   });
+  adminTrack.command("mixable-order").description("Order findings into a smooth proposed mix (2\u201364 Log IDs)").argument("[logIds...]", "The findings to order, by Log ID").option("--seed <logId>", "Pin the first stop").option("--json", "Print JSON", false).allowExcessArguments().action(async (logIds, options) => {
+    const { mixableOrderCommand: mixableOrderCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runMixableOrder(logIds, options, mixableOrderCommand2);
+  });
   adminTrack.command("update").description("Certify a track into the archive").argument("[trackId]").option("--analyzed-at <iso>", "Analysis-write ISO timestamp (BPM/key provenance)").option("--analyzed-from <class>", "Audio class BPM/key were analyzed from: full or preview").option("--bpm <number>", "Track BPM").option("--bpm-confidence <number>", "Analyzer confidence in the BPM (0..1)").option("--bpm-source <source>", "Where the BPM came from (analyzer bpmSource)").option("--embedding <json>", "MuQ audio embedding as a JSON array of 1024 floats").option("--embedding-file <file>", "Read the MuQ embedding JSON array from a file").option("--features <json>", "Audio feature JSON").option("--json", "Print JSON", false).option("--key <key>", "Musical key").option("--key-confidence <number>", "Analyzer confidence in the key (0..1)").option("--key-source <source>", "Where the key came from (analyzer keySource)").option("--note <text>", "Operator note").option("--status <status>", "Enrichment status").option("--video-url <url>", "Rendered video URL").allowExcessArguments().action(async (trackId, options) => {
     const { trackUpdateCommand: trackUpdateCommand3 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackUpdate(trackId, options, trackUpdateCommand3);
@@ -7969,6 +8069,22 @@ function addAdminCommands(program2) {
     const { newsletterDeleteCommand: newsletterDeleteCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
     await runNewsletterDelete(id, options, newsletterDeleteCommand2);
   });
+  const adminLogbook = configureCommand(admin.command("logbook").description("Fluncle's Logbook (travelogue) commands"));
+  adminLogbook.action(() => {
+    adminLogbook.outputHelp();
+  });
+  adminLogbook.command("gaps").description("List sector-days with findings but no logbook entry (the sweep's worklist)").option("--limit <limit>", "Max gaps to return").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { logbookGapsCommand: logbookGapsCommand2 } = await Promise.resolve().then(() => (init_admin_logbook(), exports_admin_logbook));
+    await runLogbookGaps(options, logbookGapsCommand2);
+  });
+  adminLogbook.command("create").description("Author a sector-day's entry (fills an empty sector only)").argument("[sector]").option("--title <text>", "The entry title").option("--body <text>", "The entry body (markdown; [[logId]] figure tokens)").option("--body-file <file>", "Read the body from a file (the sweep's path)").option("--json", "Print JSON", false).allowExcessArguments().action(async (sector, options) => {
+    const { logbookCreateCommand: logbookCreateCommand2 } = await Promise.resolve().then(() => (init_admin_logbook(), exports_admin_logbook));
+    await runLogbookWrite(sector, options, logbookCreateCommand2);
+  });
+  adminLogbook.command("update").description("Create or overwrite a sector-day's entry. OPERATOR only").argument("[sector]").option("--title <text>", "The entry title").option("--body <text>", "The entry body (markdown; [[logId]] figure tokens)").option("--body-file <file>", "Read the body from a file").option("--json", "Print JSON", false).allowExcessArguments().action(async (sector, options) => {
+    const { logbookUpdateCommand: logbookUpdateCommand2 } = await Promise.resolve().then(() => (init_admin_logbook(), exports_admin_logbook));
+    await runLogbookWrite(sector, options, logbookUpdateCommand2);
+  });
   const submissions = configureCommand(admin.command("submissions").description("Review listener submissions"));
   submissions.option("--json", "Print JSON", false).action(async (options) => {
     const { listSubmissionsCommand: listSubmissionsCommand2 } = await Promise.resolve().then(() => (init_submissions(), exports_submissions));
@@ -7999,7 +8115,7 @@ function addAdminCommands(program2) {
     if (!submissionId) {
       throw new Error("Missing submission id for: triage");
     }
-    const verdict = options.verdictFile ? readFileSync5(options.verdictFile, "utf8") : options.verdict;
+    const verdict = options.verdictFile ? readFileSync6(options.verdictFile, "utf8") : options.verdict;
     if (!verdict || !verdict.trim()) {
       throw new Error("Usage: fluncle admin submissions triage <submissionId> (--verdict <text> | --verdict-file <file>) [--json]");
     }
@@ -8084,7 +8200,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]");
   }
@@ -8140,7 +8256,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]");
   }
@@ -8453,7 +8569,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) {
@@ -8592,6 +8708,24 @@ async function runTrackGet(idOrLogId, options, trackGetCommand2) {
     console.log(`Log: ${t.logPageUrl}`);
   }
 }
+async function runMixableOrder(logIds, options, mixableOrderCommand2) {
+  if (logIds.length < 2) {
+    throw new Error("Give 2 or more Log IDs. Usage: fluncle admin tracks mixable-order <logId...> [--seed <logId>] [--json]");
+  }
+  const result = await mixableOrderCommand2(logIds, options.seed);
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  console.log(`Proposed mix \u2014 a smooth chain (${result.algorithm}), not an energy-shaped set. Copy into Rekordbox as advisory.
+`);
+  result.order.forEach((stop, index) => {
+    const into = index === 0 ? "start" : stop.flagged ? "sparse join" : stop.transitionReason?.relationship.replace(/_/g, " ") ?? "\u2014";
+    const meta = [stop.key, stop.bpm ? `${Math.round(stop.bpm)} bpm` : undefined].filter(Boolean).join(" \xB7 ");
+    console.log(`${String(index + 1).padStart(2)}. ${stop.logId}  ${stop.artists.join(", ")} \u2014 ${stop.title}`);
+    console.log(`    ${[into, meta].filter(Boolean).join("  \xB7  ")}`);
+  });
+}
 async function runTrackGetAdmin(idOrLogId, options, trackGetAdminCommand2) {
   if (!idOrLogId) {
     throw new Error("Missing id. Usage: fluncle admin tracks get <track_id|log_id> [--json]");
@@ -8648,7 +8782,7 @@ async function runTrackUpdate(trackId, options, trackUpdateCommand3) {
   if (options.analyzedFrom !== undefined && options.analyzedFrom !== "full" && options.analyzedFrom !== "preview") {
     throw new Error(`Invalid --analyzed-from: ${options.analyzedFrom} (expected full or preview)`);
   }
-  const embeddingRaw = options.embeddingFile ? readFileSync5(options.embeddingFile, "utf8") : options.embedding;
+  const embeddingRaw = options.embeddingFile ? readFileSync6(options.embeddingFile, "utf8") : options.embedding;
   const embedding = parseEmbeddingArg(embeddingRaw);
   const result = await trackUpdateCommand3(trackId, {
     analyzedAt: options.analyzedAt,
@@ -8911,6 +9045,37 @@ async function runNewsletterList(options, newsletterListCommand2) {
     console.log(`${label}	${edition.status}	${edition.id}	${subject}`);
   }
 }
+async function runLogbookGaps(options, logbookGapsCommand2) {
+  const limit = options.limit === undefined ? undefined : Number.parseInt(options.limit, 10);
+  const gaps = await logbookGapsCommand2(limit !== undefined && Number.isFinite(limit) ? limit : undefined);
+  if (options.json) {
+    printJson({ gaps, ok: true });
+    return;
+  }
+  if (gaps.length === 0) {
+    console.log("No gaps \u2014 every past sector-day with findings has an entry.");
+    return;
+  }
+  for (const gap of gaps) {
+    console.log(`sector ${gap.sector}	${gap.date.slice(0, 10)}	${gap.findings.length} findings`);
+  }
+}
+async function runLogbookWrite(sector, options, writeCommand) {
+  if (!sector) {
+    throw new Error("Missing sector for the logbook entry");
+  }
+  const result = await writeCommand(sector, {
+    body: options.body,
+    bodyFile: options.bodyFile,
+    title: options.title
+  });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  const skipped = "skipped" in result && result.skipped;
+  console.log(skipped ? `sector ${result.entry.sector}: an entry already stands \u2014 no-op (${result.entry.generatedBy})` : `sector ${result.entry.sector}: ${result.entry.title}`);
+}
 async function runAdd(spotifyUrl, options, addCommand3) {
   if (!spotifyUrl) {
     throw new Error("Missing Spotify track URL");

package/package.json

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