fluncle 0.114.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.114.0".trim() ? "0.114.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.114.0".trim() ? "0.114.0".trim() : "0.1.0";
+  currentVersion2 = "0.115.0".trim() ? "0.115.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3270,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;
   }
@@ -3462,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;
   }
@@ -7768,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);
@@ -7901,7 +7953,7 @@ function addAdminCommands(program2) {
     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) => {
+  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);
   });
@@ -8143,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();
@@ -8792,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,
@@ -9155,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.114.0"
+  "version": "0.115.0"
 }