fluncle 0.154.0 → 0.156.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.154.0".trim() ? "0.154.0".trim() : "0.1.0";
+  currentVersion = "0.156.0".trim() ? "0.156.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.154.0".trim() ? "0.154.0".trim() : "0.1.0";
+  currentVersion2 = "0.156.0".trim() ? "0.156.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3025,6 +3025,28 @@ var init_src = __esm(() => {
       probeConfig: { cadenceMs: 10 * MINUTE_MS, cronName: "fluncle-note", kind: "cron" },
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin artists describe --queue",
+      exposedContent: [
+        "auto-author the /artist/<slug> voiced bio, fill-empty-only (hybrid: one claude -p call)"
+      ],
+      kind: "cron",
+      name: "cron.artist-bio",
+      operatorNotes: "every 30m. Hybrid --no-agent; one claude -p authors the paragraph off best-effort Firecrawl facts + identity. Never clobbers an operator bio. Box activation operator-gated. Source: docs/agents/hermes/scripts/{entity-bio-sweep.ts,artist-bio-sweep.sh}.",
+      probeConfig: { cadenceMs: 30 * MINUTE_MS, cronName: "fluncle-artist-bio", kind: "cron" },
+      weights: { status: "hidden" }
+    },
+    {
+      command: "fluncle admin labels describe --queue",
+      exposedContent: [
+        "auto-author the /label/<slug> voiced bio, fill-empty-only (hybrid: one claude -p call)"
+      ],
+      kind: "cron",
+      name: "cron.label-bio",
+      operatorNotes: "every 30m. Hybrid --no-agent; one claude -p authors the paragraph off best-effort Firecrawl facts + identity. Never clobbers an operator bio. Box activation operator-gated. Source: docs/agents/hermes/scripts/{entity-bio-sweep.ts,label-bio-sweep.sh}.",
+      probeConfig: { cadenceMs: 30 * MINUTE_MS, cronName: "fluncle-label-bio", kind: "cron" },
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin submissions triage",
       exposedContent: [
@@ -5896,9 +5918,33 @@ var exports_admin_artists = {};
 __export(exports_admin_artists, {
   resolveArtistCommand: () => resolveArtistCommand,
   listArtistsCommand: () => listArtistsCommand,
+  draftArtistBioCommand: () => draftArtistBioCommand,
+  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 draftArtistBioCommand(slug) {
+  return adminApiGet(`/api/admin/artists/${encodeURIComponent(slug)}/bio-draft`);
+}
+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) {
@@ -5927,11 +5973,39 @@ 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,
+  draftLabelBioCommand: () => draftLabelBioCommand,
+  describeLabelCommand: () => describeLabelCommand,
   backfillLabelImagesCommand: () => backfillLabelImagesCommand
 });
+async function describeLabelCommand(slug, options) {
+  return adminApiPost(`/api/admin/labels/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
+}
+async function draftLabelBioCommand(slug) {
+  return adminApiGet(`/api/admin/labels/${encodeURIComponent(slug)}/bio-draft`);
+}
+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) {
@@ -5941,6 +6015,7 @@ async function backfillLabelImagesCommand(limit, dryRun, cursor) {
 }
 var init_admin_labels = __esm(() => {
   init_api();
+  init_admin_artists2();
 });
 
 // src/commands/admin-covers.ts
@@ -9121,6 +9196,36 @@ 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);
+  });
+  artists.command("draft-bio").description("Assemble the Worker-grounded bio prompt for an artist (the sweep's trigger)").argument("<slug>").option("--json", "Print JSON", false).allowExcessArguments().action(async (slug, options) => {
+    const { draftArtistBioCommand: draftArtistBioCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
+    await runEntityBioDraft("artist", slug, options, draftArtistBioCommand2);
+  });
+  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);
+  });
+  labels.command("draft-bio").description("Assemble the Worker-grounded bio prompt for a label (the sweep's trigger)").argument("<slug>").option("--json", "Print JSON", false).allowExcessArguments().action(async (slug, options) => {
+    const { draftLabelBioCommand: draftLabelBioCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
+    await runEntityBioDraft("label", slug, options, draftLabelBioCommand2);
+  });
   const migrations = configureCommand(admin.command("migrations").description("One-off operator data migrations"));
   migrations.action(() => {
     migrations.outputHelp();
@@ -9242,6 +9347,61 @@ 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 runEntityBioDraft(kind, slug, options, draftCommand) {
+  const draft = await draftCommand(slug);
+  if (options.json) {
+    printJson(draft);
+    return;
+  }
+  if (!draft.found) {
+    console.log(`No ${kind} with slug ${slug}.`);
+    return;
+  }
+  console.log(`Drafted a bio prompt for ${draft.name} (${draft.findingCount} finding(s), facts: ${draft.hasFacts ? "yes" : "none"}, prompt v${draft.promptVersion}).`);
+}
 async function runTrackSimilar(idOrLogId, options, trackSimilarCommand2) {
   if (!idOrLogId) {
     throw new Error("Missing id. Usage: fluncle tracks similar <track_id|log_id> [--limit <n>] [--json]");
@@ -11423,6 +11583,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.154.0"
+  "version": "0.156.0"
 }