fluncle 0.113.0 → 0.115.0

package/bin/fluncle.mjs

@@ -557,7 +557,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.113.0".trim() ? "0.113.0".trim() : "0.1.0";
+  currentVersion = "0.115.0".trim() ? "0.115.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -1042,6 +1042,48 @@ var init_artists = __esm(() => {
   init_api();
 });
 
+// src/commands/galaxies.ts
+var exports_galaxies = {};
+__export(exports_galaxies, {
+  galaxyMapWriteCommand: () => galaxyMapWriteCommand,
+  galaxyMapReadCommand: () => galaxyMapReadCommand,
+  galaxyGetCommand: () => galaxyGetCommand,
+  galaxyEmbeddingsCommand: () => galaxyEmbeddingsCommand,
+  galaxiesListCommand: () => galaxiesListCommand
+});
+async function galaxiesListCommand() {
+  const response = await publicApiGet("/api/v1/galaxies");
+  return response.galaxies;
+}
+async function galaxyGetCommand(slug) {
+  const response = await publicApiGet(`/api/v1/galaxies/${encodeURIComponent(slug)}`);
+  return { findings: response.findings, galaxy: response.galaxy };
+}
+async function galaxyMapReadCommand() {
+  const response = await adminApiGet("/api/admin/galaxies");
+  return response.galaxies;
+}
+async function galaxyEmbeddingsCommand(options) {
+  const params = new URLSearchParams;
+  if (options.cursor) {
+    params.set("cursor", options.cursor);
+  }
+  if (options.limit) {
+    params.set("limit", options.limit);
+  }
+  const query = params.toString();
+  return adminApiGet(`/api/admin/tracks/embeddings${query ? `?${query}` : ""}`);
+}
+async function galaxyMapWriteCommand(clusters) {
+  const response = await adminApiPut("/api/admin/galaxies/map", {
+    clusters
+  });
+  return response.galaxies;
+}
+var init_galaxies = __esm(() => {
+  init_api();
+});
+
 // src/commands/mixtape-api.ts
 async function mixtapeListCommand() {
   const response = await adminApiGet("/api/admin/mixtapes");
@@ -2209,7 +2251,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.113.0".trim() ? "0.113.0".trim() : "0.1.0";
+  currentVersion2 = "0.115.0".trim() ? "0.115.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2265,6 +2307,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",
@@ -3258,6 +3312,9 @@ async function trackUpdateCommand(trackId, options) {
   if (options.embedding !== undefined) {
     body.embedding = options.embedding;
   }
+  if (options.galaxyId !== undefined) {
+    body.galaxyId = options.galaxyId;
+  }
   if (options.note !== undefined) {
     body.note = options.note;
   }
@@ -3450,6 +3507,9 @@ async function trackUpdateCommand2(trackId, options) {
   if (options.embedding !== undefined) {
     body.embedding = options.embedding;
   }
+  if (options.galaxyId !== undefined) {
+    body.galaxyId = options.galaxyId;
+  }
   if (options.note !== undefined) {
     body.note = options.note;
   }
@@ -3486,6 +3546,7 @@ __export(exports_admin_tracks, {
   queueCommand: () => queueCommand,
   observeQueueCommand: () => observeQueueCommand,
   noteQueueCommand: () => noteQueueCommand,
+  mixableOrderCommand: () => mixableOrderCommand,
   listCommand: () => listCommand,
   enrichQueueCommand: () => enrichQueueCommand,
   embedQueueCommand: () => embedQueueCommand,
@@ -3665,6 +3726,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();
@@ -7748,6 +7816,10 @@ function addListenCommands(program2) {
     const { artistsListCommand: artistsListCommand2, artistsGetCommand: artistsGetCommand2 } = await Promise.resolve().then(() => (init_artists(), exports_artists));
     await runArtists(slug, options, { artistsGetCommand: artistsGetCommand2, artistsListCommand: artistsListCommand2 });
   });
+  program2.command("galaxies").description("Wander Fluncle's sonic galaxies").argument("[slug]", "Galaxy slug (omit for the full map)").option("--json", "Print JSON", false).action(async (slug, options) => {
+    const { galaxiesListCommand: galaxiesListCommand2, galaxyGetCommand: galaxyGetCommand2 } = await Promise.resolve().then(() => (init_galaxies(), exports_galaxies));
+    await runGalaxies(slug, options, { galaxiesListCommand: galaxiesListCommand2, galaxyGetCommand: galaxyGetCommand2 });
+  });
   program2.command("mixtapes").description("Fluncle's checkpoint sets").option("--json", "Print JSON", false).action(async (options) => {
     const { mixtapesCommand: mixtapesCommand2 } = await Promise.resolve().then(() => (init_mixtapes(), exports_mixtapes));
     await runMixtapes(options, mixtapesCommand2);
@@ -7877,7 +7949,11 @@ function addAdminCommands(program2) {
     const { trackGetAdminCommand: trackGetAdminCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackGetAdmin(idOrLogId, options, trackGetAdminCommand2);
   });
-  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) => {
+  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("--galaxy-id <id>", "Sonic galaxy assignment (empty string clears it)").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);
   });
@@ -8119,6 +8195,22 @@ function addAdminCommands(program2) {
   artists.action(() => {
     artists.outputHelp();
   });
+  const galaxies = configureCommand(admin.command("galaxies").description("Sonic galaxy map (cluster sweep) commands"));
+  galaxies.action(() => {
+    galaxies.outputHelp();
+  });
+  galaxies.command("map").description("Read the full galaxy map (named + unnamed + retired, with centroids)").option("--json", "Print JSON", false).action(async (options) => {
+    const { galaxyMapReadCommand: galaxyMapReadCommand2 } = await Promise.resolve().then(() => (init_galaxies(), exports_galaxies));
+    await runGalaxyMapRead(options, galaxyMapReadCommand2);
+  });
+  galaxies.command("embeddings").description("Read a cursor page of the embedded corpus (the cluster engine's input)").option("--cursor <cursor>", "Opaque cursor from a prior page's nextCursor").option("--limit <limit>", "Page size (default 200, clamped to 500)").option("--json", "Print JSON", false).action(async (options) => {
+    const { galaxyEmbeddingsCommand: galaxyEmbeddingsCommand2 } = await Promise.resolve().then(() => (init_galaxies(), exports_galaxies));
+    await runGalaxyEmbeddings(options, galaxyEmbeddingsCommand2);
+  });
+  galaxies.command("set-map").description("Write the galaxy map transactionally (mint new ids, upsert centroids, retire)").requiredOption("--file <file>", "Path to the clusters JSON ({ clusters: [...] } or a bare array)").option("--json", "Print JSON", false).action(async (options) => {
+    const { galaxyMapWriteCommand: galaxyMapWriteCommand2 } = await Promise.resolve().then(() => (init_galaxies(), exports_galaxies));
+    await runGalaxyMapWrite(options, galaxyMapWriteCommand2);
+  });
   const backfill = configureCommand(admin.command("backfills").description("Backfill operator-only archives"));
   backfill.action(() => {
     backfill.outputHelp();
@@ -8684,6 +8776,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]");
@@ -8750,6 +8860,7 @@ async function runTrackUpdate(trackId, options, trackUpdateCommand3) {
     bpmSource: options.bpmSource,
     embedding,
     features: options.features,
+    galaxyId: options.galaxyId,
     key: options.key,
     keyConfidence,
     keySource: options.keySource,
@@ -9113,6 +9224,71 @@ async function runArtists(slug, options, commands) {
     console.log(`${a.name.padEnd(40)} ${String(a.findingCount).padStart(3)} finding${a.findingCount === 1 ? "" : "s"}`);
   }
 }
+async function runGalaxies(slug, options, commands) {
+  if (slug) {
+    const { findings, galaxy } = await commands.galaxyGetCommand(slug);
+    if (options.json) {
+      printJson({ findings, galaxy, ok: true });
+      return;
+    }
+    console.log(`${galaxy.name}  (${galaxy.slug})`);
+    console.log(`${galaxy.memberCount} finding${galaxy.memberCount === 1 ? "" : "s"}`);
+    for (const finding of findings) {
+      const coordinate3 = finding.logId ? `${finding.logId}  ` : "";
+      console.log(`  ${coordinate3}${finding.artists.join(", ")} \u2014 ${finding.title}`);
+    }
+    return;
+  }
+  const galaxies = await commands.galaxiesListCommand();
+  if (options.json) {
+    printJson({ galaxies, ok: true });
+    return;
+  }
+  if (galaxies.length === 0) {
+    console.log("No galaxies named yet. Quiet map tonight.");
+    return;
+  }
+  for (const galaxy of galaxies) {
+    console.log(`${galaxy.name.padEnd(40)} ${String(galaxy.memberCount).padStart(3)} finding${galaxy.memberCount === 1 ? "" : "s"}`);
+  }
+}
+async function runGalaxyMapRead(options, galaxyMapReadCommand2) {
+  const galaxies = await galaxyMapReadCommand2();
+  if (options.json) {
+    printJson({ galaxies, ok: true });
+    return;
+  }
+  if (galaxies.length === 0) {
+    console.log("No galaxies on the map yet.");
+    return;
+  }
+  for (const galaxy of galaxies) {
+    const name = galaxy.name ?? "(unnamed)";
+    const retired = galaxy.retiredAt ? " [retired]" : "";
+    console.log(`${galaxy.id}  ${galaxy.handle.padEnd(30)} ${name.padEnd(24)} ${String(galaxy.memberCount).padStart(4)} members${retired}`);
+  }
+}
+async function runGalaxyEmbeddings(options, galaxyEmbeddingsCommand2) {
+  const result = await galaxyEmbeddingsCommand2({ cursor: options.cursor, limit: options.limit });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  console.log(`${result.embeddings.length} embedding(s)${result.nextCursor ? ` \xB7 nextCursor: ${result.nextCursor}` : " \xB7 end of corpus"}`);
+}
+async function runGalaxyMapWrite(options, galaxyMapWriteCommand2) {
+  const raw = JSON.parse(readFileSync6(options.file, "utf8"));
+  const clusters = Array.isArray(raw) || raw === null ? raw : raw.clusters;
+  if (!Array.isArray(clusters)) {
+    throw new Error("Invalid --file: expected { clusters: [...] } or a JSON array of cluster rows");
+  }
+  const galaxies = await galaxyMapWriteCommand2(clusters);
+  if (options.json) {
+    printJson({ galaxies, ok: true });
+    return;
+  }
+  console.log(`Wrote ${clusters.length} cluster(s); the map now holds ${galaxies.length} galaxy(ies).`);
+}
 async function runMixtapes(options, mixtapesCommand2) {
   const mixtapes = await mixtapesCommand2();
   if (options.json) {

package/package.json

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