fluncle 0.153.0 → 0.155.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.153.0".trim() ? "0.153.0".trim() : "0.1.0";
+  currentVersion = "0.155.0".trim() ? "0.155.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2189,7 +2189,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.153.0".trim() ? "0.153.0".trim() : "0.1.0";
+  currentVersion2 = "0.155.0".trim() ? "0.155.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3626,6 +3626,7 @@ var init_admin_attention = __esm(() => {
     "label-review": "label",
     newsletter: "newsletter",
     "note-rejected": "held note",
+    "observation-rejected": "held observation",
     "post-tiktok": "tiktok",
     "post-youtube": "youtube",
     submission: "submission",
@@ -5761,6 +5762,35 @@ var init_admin_notes = __esm(() => {
   init_api();
 });
 
+// src/commands/admin-observations.ts
+var exports_admin_observations = {};
+__export(exports_admin_observations, {
+  observationHeldCommand: () => observationHeldCommand,
+  observationGateCommand: () => observationGateCommand
+});
+async function observationHeldCommand(options) {
+  const query = options.settled ? "?open=false" : "";
+  return adminApiGet(`/api/admin/observation-rejections${query}`);
+}
+async function observationGateCommand(options) {
+  const patch = {};
+  if (options.minPhraseWords !== undefined) {
+    patch.minPhraseWords = options.minPhraseWords;
+  }
+  if (options.maxOverlap !== undefined) {
+    patch.maxOverlap = options.maxOverlap;
+  }
+  if (Object.keys(patch).length === 0) {
+    const response2 = await adminApiGet("/api/admin/observation-rejections");
+    return response2.gate;
+  }
+  const response = await adminApiPatch("/api/admin/observation-gate", patch);
+  return response.gate;
+}
+var init_admin_observations = __esm(() => {
+  init_api();
+});
+
 // src/commands/admin-catalogue.ts
 var exports_admin_catalogue = {};
 __export(exports_admin_catalogue, {
@@ -5866,9 +5896,29 @@ var exports_admin_artists = {};
 __export(exports_admin_artists, {
   resolveArtistCommand: () => resolveArtistCommand,
   listArtistsCommand: () => listArtistsCommand,
+  describeArtistCommand: () => describeArtistCommand,
+  buildBioBody: () => buildBioBody,
   backfillArtistsCommand: () => backfillArtistsCommand,
-  backfillArtistImagesCommand: () => backfillArtistImagesCommand
+  backfillArtistImagesCommand: () => backfillArtistImagesCommand,
+  artistsBioQueueCommand: () => artistsBioQueueCommand
 });
+function buildBioBody(options) {
+  const body = { bio: options.bio };
+  if (options.dryRun) {
+    body.dryRun = true;
+  }
+  if (typeof options.promptVersion === "number") {
+    body.promptVersion = options.promptVersion;
+  }
+  return body;
+}
+async function describeArtistCommand(slug, options) {
+  return adminApiPost(`/api/admin/artists/${encodeURIComponent(slug)}/bio`, buildBioBody(options));
+}
+async function artistsBioQueueCommand(limit) {
+  const response = await adminApiGet(`/api/admin/artists/bio-queue?limit=${limit}`);
+  return response.artists;
+}
 async function listArtistsCommand(limit, cursor) {
   const params = new URLSearchParams({ limit: String(limit) });
   if (cursor) {
@@ -5897,11 +5947,35 @@ var init_admin_artists = __esm(() => {
   init_api();
 });
 
+// src/commands/admin-artists.ts
+function buildBioBody2(options) {
+  const body = { bio: options.bio };
+  if (options.dryRun) {
+    body.dryRun = true;
+  }
+  if (typeof options.promptVersion === "number") {
+    body.promptVersion = options.promptVersion;
+  }
+  return body;
+}
+var init_admin_artists2 = __esm(() => {
+  init_api();
+});
+
 // src/commands/admin-labels.ts
 var exports_admin_labels = {};
 __export(exports_admin_labels, {
+  labelsBioQueueCommand: () => labelsBioQueueCommand,
+  describeLabelCommand: () => describeLabelCommand,
   backfillLabelImagesCommand: () => backfillLabelImagesCommand
 });
+async function describeLabelCommand(slug, options) {
+  return adminApiPost(`/api/admin/labels/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
+}
+async function labelsBioQueueCommand(limit) {
+  const response = await adminApiGet(`/api/admin/labels/bio-queue?limit=${limit}`);
+  return response.labels;
+}
 async function backfillLabelImagesCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
@@ -5911,6 +5985,7 @@ async function backfillLabelImagesCommand(limit, dryRun, cursor) {
 }
 var init_admin_labels = __esm(() => {
   init_api();
+  init_admin_artists2();
 });
 
 // src/commands/admin-covers.ts
@@ -8901,6 +8976,18 @@ function addAdminCommands(program2) {
     const { noteGateCommand: noteGateCommand2 } = await Promise.resolve().then(() => (init_admin_notes(), exports_admin_notes));
     await runNoteGate(options, noteGateCommand2);
   });
+  const observations = configureCommand(admin.command("observations").description("The observation echo gate: held scripts + dials"));
+  observations.action(() => {
+    observations.outputHelp();
+  });
+  observations.command("held").description("The observation scripts the echo gate held back (and why)").option("--settled", "Read the ones already ruled on instead (the retune evidence)", false).option("--json", "Print JSON", false).action(async (options) => {
+    const { observationHeldCommand: observationHeldCommand2 } = await Promise.resolve().then(() => (init_admin_observations(), exports_admin_observations));
+    await runObservationHeld(options, observationHeldCommand2);
+  });
+  observations.command("gate").description("Read or retune the observation echo gate's thresholds (a flip, not a deploy)").option("--min-phrase-words <n>", "A shared run this long is a lift (2-20; default 4)").option("--max-overlap <x>", "Content-word overlap at/above this is an echo (0.05-1; default 0.3)").option("--json", "Print JSON", false).action(async (options) => {
+    const { observationGateCommand: observationGateCommand2 } = await Promise.resolve().then(() => (init_admin_observations(), exports_admin_observations));
+    await runObservationGate(options, observationGateCommand2);
+  });
   const catalogue = configureCommand(admin.command("catalogue").description("The catalogue (uncertified tracks): the crawler + its ranking"));
   catalogue.action(() => {
     catalogue.outputHelp();
@@ -9079,6 +9166,28 @@ function addAdminCommands(program2) {
     const { resolveArtistCommand: resolveArtistCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runArtistResolve(artistId, options, resolveArtistCommand2);
   });
+  artists.command("describe").description("Author the voiced bio for an artist (fills an empty bio only)").argument("[slug]").option("--queue", "Show the bio worklist (artists with findings but no bio), oldest first", false).option("--limit <limit>", "Number of artists to show with --queue", "50").option("--bio <text>", "The voice-gated bio paragraph").option("--bio-file <file>", "Read the bio from a file").option("--prompt-version <n>", "The prompt-registry version that authored the bio (the sweep sends this; it is the bio's provenance)").option("--dry-run", "Run the voice gate and report the verdict without storing anything", false).option("--json", "Print JSON", false).allowExcessArguments().action(async (slug, options) => {
+    if (options.queue) {
+      const { artistsBioQueueCommand: artistsBioQueueCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
+      await runEntityBioQueue("artist", options, artistsBioQueueCommand2);
+      return;
+    }
+    const { describeArtistCommand: describeArtistCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
+    await runEntityDescribe("artist", slug, options, describeArtistCommand2);
+  });
+  const labels = configureCommand(admin.command("labels").description("Label entity commands (the voiced bio)"));
+  labels.action(() => {
+    labels.outputHelp();
+  });
+  labels.command("describe").description("Author the voiced bio for a label (fills an empty bio only)").argument("[slug]").option("--queue", "Show the bio worklist (labels with findings but no bio), oldest first", false).option("--limit <limit>", "Number of labels to show with --queue", "50").option("--bio <text>", "The voice-gated bio paragraph").option("--bio-file <file>", "Read the bio from a file").option("--prompt-version <n>", "The prompt-registry version that authored the bio (the sweep sends this; it is the bio's provenance)").option("--dry-run", "Run the voice gate and report the verdict without storing anything", false).option("--json", "Print JSON", false).allowExcessArguments().action(async (slug, options) => {
+    if (options.queue) {
+      const { labelsBioQueueCommand: labelsBioQueueCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
+      await runEntityBioQueue("label", options, labelsBioQueueCommand2);
+      return;
+    }
+    const { describeLabelCommand: describeLabelCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
+    await runEntityDescribe("label", slug, options, describeLabelCommand2);
+  });
   const migrations = configureCommand(admin.command("migrations").description("One-off operator data migrations"));
   migrations.action(() => {
     migrations.outputHelp();
@@ -9200,6 +9309,49 @@ async function runTrackNote(idOrLogId, options, trackNoteCommand2) {
   console.log(`Authored the note for ${result.logId}:`);
   console.log(`  ${result.note}`);
 }
+async function runEntityDescribe(kind, slug, options, describeCommand) {
+  const bio = options.bioFile ? readFileSync7(options.bioFile, "utf8") : options.bio;
+  if (!slug || !bio || !bio.trim()) {
+    throw new Error(`Usage: fluncle admin ${kind}s describe <slug> (--bio <text> | --bio-file <file>) [--dry-run] [--json]`);
+  }
+  const result = await describeCommand(slug, {
+    bio: bio.trim(),
+    dryRun: options.dryRun,
+    promptVersion: parsePromptVersion(options.promptVersion)
+  });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  if (result.skipped) {
+    console.log(`A bio is already on file for ${result.slug}. The operator's bio stands.`);
+    return;
+  }
+  if (result.dryRun) {
+    console.log(`The voice gate passed for ${result.slug}. Nothing was stored (dry run).`);
+    console.log(`  ${result.bio}`);
+    return;
+  }
+  console.log(`Authored the bio for ${result.slug}:`);
+  console.log(`  ${result.bio}`);
+}
+async function runEntityBioQueue(kind, options, queueCommand2) {
+  const limit = options.limit ? Number.parseInt(options.limit, 10) : 50;
+  const items = await queueCommand2(Number.isFinite(limit) ? limit : 50);
+  if (options.json) {
+    printJson(items);
+    return;
+  }
+  if (items.length === 0) {
+    console.log(`No ${kind}s awaiting a bio.`);
+    return;
+  }
+  const noun = items.length === 1 ? kind : `${kind}s`;
+  console.log(`${items.length} ${noun} awaiting a bio, oldest first:`);
+  for (const item of items) {
+    console.log(`  ${item.slug}  ${item.name}`);
+  }
+}
 async function runTrackSimilar(idOrLogId, options, trackSimilarCommand2) {
   if (!idOrLogId) {
     throw new Error("Missing id. Usage: fluncle tracks similar <track_id|log_id> [--limit <n>] [--json]");
@@ -10771,6 +10923,44 @@ async function runNoteGate(options, noteGateCommand2) {
   }
   console.log(`The echo gate: a lift is ${gate.minPhraseWords}+ shared words; an echo is ${Math.round(gate.maxOverlap * 100)}%+ of a neighbour's words.`);
 }
+async function runObservationHeld(options, observationHeldCommand2) {
+  const { gate, rejections } = await observationHeldCommand2({ settled: options.settled === true });
+  if (options.json) {
+    printJson({ gate, ok: true, rejections });
+    return;
+  }
+  if (rejections.length === 0) {
+    console.log(options.settled ? "Nothing ruled on yet." : "Nothing held back. The gate is quiet.");
+    return;
+  }
+  console.log(`The gate sits at ${gate.minPhraseWords} lifted words / ${Math.round(gate.maxOverlap * 100)}% overlap.`);
+  for (const held of rejections) {
+    const ruled = held.resolution ? ` [${held.resolution}]` : "";
+    const bounced = held.attempts > 1 ? ` (bounced ${held.attempts}x)` : "";
+    console.log("");
+    console.log(`${held.logId ?? held.trackId}  ${held.title}${bounced}${ruled}`);
+    console.log(`  wrote:  ${held.script}`);
+    if (held.phrase) {
+      console.log(`  lifted: "${held.phrase}" from ${held.neighborLogId ?? "a neighbour"}`);
+    } else {
+      console.log(`  reuses: ${Math.round(held.overlap * 100)}% of ${held.neighborLogId ?? "a neighbour"}'s words`);
+    }
+    console.log(`  judged at: ${held.minPhraseWords} words / ${Math.round(held.maxOverlap * 100)}%`);
+  }
+}
+async function runObservationGate(options, observationGateCommand2) {
+  const minPhraseWords = options.minPhraseWords === undefined ? undefined : Number(options.minPhraseWords);
+  const maxOverlap = options.maxOverlap === undefined ? undefined : Number(options.maxOverlap);
+  const gate = await observationGateCommand2({
+    ...maxOverlap === undefined ? {} : { maxOverlap },
+    ...minPhraseWords === undefined ? {} : { minPhraseWords }
+  });
+  if (options.json) {
+    printJson({ gate, ok: true });
+    return;
+  }
+  console.log(`The observation echo gate: a lift is ${gate.minPhraseWords}+ shared words; an echo is ${Math.round(gate.maxOverlap * 100)}%+ of a neighbour's words.`);
+}
 async function runGalaxyMapRead(options, galaxyMapReadCommand2) {
   const galaxies = await galaxyMapReadCommand2();
   if (options.json) {
@@ -11343,6 +11533,8 @@ var stringOptions = new Set([
   "--analyzed-from",
   "--at",
   "--audio",
+  "--bio",
+  "--bio-file",
   "--body",
   "--body-file",
   "--bpm",

package/package.json

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