fluncle 0.218.0 → 0.220.0

package/bin/fluncle.mjs

@@ -610,7 +610,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.218.0".trim() ? "0.218.0".trim() : "0.1.0";
+  currentVersion = "0.220.0".trim() ? "0.220.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2452,7 +2452,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.218.0".trim() ? "0.218.0".trim() : "0.1.0";
+  currentVersion2 = "0.220.0".trim() ? "0.220.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2779,7 +2779,7 @@ var init_src = __esm(() => {
     },
     {
       exposedContent: [
-        "the R2 media zone — each finding's video bundle + mixtape audio",
+        "the R2 media zone: each finding's video bundle and mixtape audio",
         "the /cdn-cgi/media transform base (same zone, no cross-origin)"
       ],
       kind: "subdomain",
@@ -2810,7 +2810,7 @@ var init_src = __esm(() => {
     },
     {
       exposedContent: [
-        "the Tor onion mirror of www.fluncle.com — the archive, API, RSS, and MCP over Tor"
+        "the Tor onion mirror of www.fluncle.com: the archive, API, RSS, and MCP over Tor"
       ],
       kind: "subdomain",
       name: "subdomain.onion",
@@ -7016,15 +7016,48 @@ var init_admin_reach = __esm(() => {
 var exports_admin_artists = {};
 __export(exports_admin_artists, {
   resolveArtistCommand: () => resolveArtistCommand,
+  removeArtistRuleCommand: () => removeArtistRuleCommand,
   rankArtistsCommand: () => rankArtistsCommand,
   listArtistsCommand: () => listArtistsCommand,
+  listArtistRulesCommand: () => listArtistRulesCommand,
   draftArtistBioCommand: () => draftArtistBioCommand,
   describeArtistCommand: () => describeArtistCommand,
   buildBioBody: () => buildBioBody,
   backfillArtistsCommand: () => backfillArtistsCommand,
   backfillArtistImagesCommand: () => backfillArtistImagesCommand,
-  artistsBioQueueCommand: () => artistsBioQueueCommand
+  artistsBioQueueCommand: () => artistsBioQueueCommand,
+  artistRuleInput: () => artistRuleInput,
+  addArtistRuleCommand: () => addArtistRuleCommand
 });
+function artistRuleInput(artistMbid, verdict, artistName) {
+  const cleanMbid = artistMbid.trim();
+  if (!MBID_PATTERN.test(cleanMbid)) {
+    throw new Error("Artist MBID must be a MusicBrainz artist MBID");
+  }
+  if (verdict !== "allow" && verdict !== "block") {
+    throw new Error("Pass --verdict allow|block");
+  }
+  const cleanName = artistName?.trim();
+  if (artistName !== undefined && !cleanName) {
+    throw new Error("--name must be a non-empty artist name");
+  }
+  return {
+    artistMbid: cleanMbid.toLowerCase(),
+    ...cleanName ? { artistName: cleanName } : {},
+    verdict
+  };
+}
+async function listArtistRulesCommand() {
+  const response = await adminApiGet("/api/v1/admin/artist-rules");
+  return response.rules;
+}
+async function addArtistRuleCommand(input) {
+  const response = await adminApiPost("/api/v1/admin/artist-rules", input);
+  return response.rule;
+}
+async function removeArtistRuleCommand(id) {
+  return adminApiDelete(`/api/v1/admin/artist-rules/${encodeURIComponent(id)}`);
+}
 function buildBioBody(options) {
   const body = { bio: options.bio };
   if (options.dryRun) {
@@ -7077,8 +7110,10 @@ async function backfillArtistsCommand(limit, dryRun, cursor) {
   }
   return adminApiPost(`/api/v1/admin/backfill/artists?${params.toString()}`);
 }
+var MBID_PATTERN;
 var init_admin_artists = __esm(() => {
   init_api();
+  MBID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 });
 
 // src/commands/admin-artists.ts
@@ -7103,24 +7138,88 @@ var init_admin_artists2 = __esm(() => {
 var exports_admin_labels = {};
 __export(exports_admin_labels, {
   updateLabelCommand: () => updateLabelCommand,
+  replaceLabelArtistRulesCommand: () => replaceLabelArtistRulesCommand,
+  parseLabelArtistRulesJson: () => parseLabelArtistRulesJson,
   mergeLabelCommand: () => mergeLabelCommand,
+  listLabelArtistRulesCommand: () => listLabelArtistRulesCommand,
   labelsBioQueueCommand: () => labelsBioQueueCommand,
   draftLabelBioCommand: () => draftLabelBioCommand,
   describeLabelCommand: () => describeLabelCommand,
   backfillLabelLineageCommand: () => backfillLabelLineageCommand,
   backfillLabelImagesCommand: () => backfillLabelImagesCommand
 });
-async function mergeLabelCommand(losingSlug, canonicalSlug) {
-  const response = await adminApiPost(`/api/v1/admin/labels/${encodeURIComponent(losingSlug)}/merge`, { canonicalSlug });
-  return response.result;
+function requireArtistMbid(value, at) {
+  if (typeof value !== "string" || !MBID_PATTERN2.test(value.trim())) {
+    throw new Error(`${at}.artistMbid must be a MusicBrainz artist MBID`);
+  }
+  return value.trim().toLowerCase();
+}
+function requireArtistName(value, at) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`${at}.artistName must be a non-empty string`);
+  }
+  return value.trim();
+}
+function requireArtistVerdict(value, at) {
+  if (value === "allow" || value === "block") {
+    return value;
+  }
+  throw new Error(`${at}.verdict must be 'allow' or 'block'`);
 }
-async function updateLabelCommand(slugOrId, seedState) {
+function parseLabelArtistRulesJson(source) {
+  let parsed;
+  try {
+    parsed = JSON.parse(source);
+  } catch {
+    throw new Error("Rules file must contain valid JSON");
+  }
+  if (!Array.isArray(parsed)) {
+    throw new Error("Rules file must contain a JSON array");
+  }
+  if (parsed.length > 100) {
+    throw new Error("Rules file may contain at most 100 artist rules");
+  }
+  return parsed.map((entry, index) => {
+    const at = `Rules file entry ${index + 1}`;
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+      throw new Error(`${at} must be an object`);
+    }
+    const value = entry;
+    return {
+      artistMbid: requireArtistMbid(value.artistMbid, at),
+      artistName: requireArtistName(value.artistName, at),
+      verdict: requireArtistVerdict(value.verdict, at)
+    };
+  });
+}
+async function resolveLabel(slugOrId) {
   const { labels } = await adminApiGet("/api/v1/admin/labels");
   const match = labels.find((label) => label.slug === slugOrId || label.id === slugOrId);
   if (!match) {
     throw new Error(`No label with slug or id '${slugOrId}' — check \`fluncle labels\``);
   }
-  const response = await adminApiPatch(`/api/v1/admin/labels/${encodeURIComponent(match.id)}`, { seedState });
+  return match;
+}
+async function listLabelArtistRulesCommand(slugOrId) {
+  const label = await resolveLabel(slugOrId);
+  const response = await adminApiGet(`/api/v1/admin/labels/${encodeURIComponent(label.id)}/artists`);
+  return { label, rules: response.rules };
+}
+async function replaceLabelArtistRulesCommand(slugOrId, rules) {
+  const label = await resolveLabel(slugOrId);
+  const response = await adminApiPut(`/api/v1/admin/labels/${encodeURIComponent(label.id)}/artists`, { rules });
+  return { label, rules: response.rules };
+}
+async function mergeLabelCommand(losingSlug, canonicalSlug) {
+  const response = await adminApiPost(`/api/v1/admin/labels/${encodeURIComponent(losingSlug)}/merge`, { canonicalSlug });
+  return response.result;
+}
+async function updateLabelCommand(slugOrId, seedState, rewalk = false) {
+  const match = await resolveLabel(slugOrId);
+  const response = await adminApiPatch(`/api/v1/admin/labels/${encodeURIComponent(match.id)}`, {
+    ...rewalk ? { rewalk: true } : {},
+    ...seedState === undefined ? {} : { seedState }
+  });
   return response.label;
 }
 async function describeLabelCommand(slug, options) {
@@ -7147,9 +7246,11 @@ async function backfillLabelLineageCommand(limit, dryRun, cursor) {
   }
   return adminApiPost(`/api/v1/admin/backfill/label-lineage?${params.toString()}`);
 }
+var MBID_PATTERN2;
 var init_admin_labels = __esm(() => {
   init_api();
   init_admin_artists2();
+  MBID_PATTERN2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 });
 
 // src/commands/admin-covers.ts
@@ -9678,6 +9779,38 @@ function toJsonFailure(error) {
 init_util();
 
 // src/cli.ts
+function labelUpdateLines(label, options) {
+  const lines = [];
+  if (options.seedState !== undefined) {
+    lines.push(`${label.name} (${label.slug}) \u2192 ${label.seedState}.`);
+    lines.push(label.seedState === "enabled" ? "  The next crawl seeds from it and stores its releases." : "  The next crawl will not seed from it; nothing already stored is touched.");
+  }
+  if (options.rewalk) {
+    lines.push(`${label.name} (${label.slug}) \u2192 scoped re-walk armed.`);
+    lines.push("  The next crawl rechecks its MusicBrainz releases.");
+  }
+  return lines;
+}
+var ARTIST_RULE_BOUNDARY = "Rules change what the next crawl takes. Everything already here stays.";
+function artistRuleWriteLine(prefix) {
+  return `${prefix} \u2014 ${ARTIST_RULE_BOUNDARY.replace(/^R/, "r")}`;
+}
+function artistRuleLines(rules) {
+  if (rules.length === 0) {
+    return ["No artist rules."];
+  }
+  const rows = rules.map((rule) => [
+    rule.id,
+    rule.verdict,
+    rule.resolvedName ?? rule.artistName,
+    rule.resolvedMbid ?? rule.artistMbid,
+    rule.artistSpotifyId ?? "unresolved"
+  ]);
+  const headings = ["ID", "VERDICT", "ARTIST", "MUSICBRAINZ", "SPOTIFY"];
+  const widths = headings.map((heading, index) => Math.max(heading.length, ...rows.map((row) => row[index]?.length ?? 0)));
+  const line = (row) => row.map((value, index) => value.padEnd(widths[index] ?? value.length)).join("  ").trimEnd();
+  return [line(headings), line(widths.map((width) => "-".repeat(width))), ...rows.map(line)];
+}
 function createProgram() {
   const program2 = configureCommand(new Command);
   program2.name("fluncle").description(fluncleTagline.toLowerCase()).option("--env <local|production>", "Config profile to load (default: production)").showSuggestionAfterError(false).addHelpCommand("help [command]", "display help for command").hook("preAction", (_thisCommand, actionCommand) => {
@@ -10571,6 +10704,34 @@ JSON field reference:
     const { rankArtistsCommand: rankArtistsCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runArtistsRank(options, rankArtistsCommand2);
   });
+  artists.command("rule").description("Always or never take one MusicBrainz artist's records (operator)").argument("<artist-mbid>", "The MusicBrainz artist MBID").requiredOption("--verdict <verdict>", "The ruling: allow or block").option("--name <name>", "Artist name (optional; the server resolves it when omitted)").option("--json", "Print JSON", false).action(async (artistMbid, options) => {
+    const { addArtistRuleCommand: addArtistRuleCommand2, artistRuleInput: artistRuleInput2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
+    const rule = await addArtistRuleCommand2(artistRuleInput2(artistMbid, options.verdict, options.name));
+    if (options.json) {
+      printJson({ ok: true, rule });
+      return;
+    }
+    console.log(artistRuleWriteLine(`Rule set for ${rule.resolvedName ?? rule.artistName}: ${rule.verdict.toUpperCase()}`));
+  });
+  artists.command("rules").description("List the global artist crawl rules").option("--json", "Print JSON", false).action(async (options) => {
+    const { listArtistRulesCommand: listArtistRulesCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
+    const rules = await listArtistRulesCommand2();
+    if (options.json) {
+      printJson({ ok: true, rules });
+      return;
+    }
+    console.log(artistRuleLines(rules).join(`
+`));
+  });
+  artists.command("unrule").description("Remove one global artist crawl rule (operator)").argument("<id>", "The artist rule id").option("--json", "Print JSON", false).action(async (id, options) => {
+    const { removeArtistRuleCommand: removeArtistRuleCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
+    const result = await removeArtistRuleCommand2(id);
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    console.log(artistRuleWriteLine(`Rule removed: ${id}`));
+  });
   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);
@@ -10592,19 +10753,48 @@ JSON field reference:
     const { draftLabelBioCommand: draftLabelBioCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
     await runEntityBioDraft("label", slug, options, draftLabelBioCommand2);
   });
-  labels.command("update").description("Rule on a label's crawl-seed state (operator; next crawl only, never storage)").argument("<slug>", "The label's slug (an exact lbl_\u2026 id also works)").option("--seed-state <state>", "The ruling: enabled, disabled, or undecided").option("--json", "Print JSON", false).action(async (slug, options) => {
+  labels.command("artists").description("List or replace one label's artist crawl rules").argument("<slug>", "The label's slug (an exact lbl_\u2026 id also works)").option("--replace", "Replace the complete rule set from --rules-file", false).option("--rules-file <file>", "JSON array of { artistMbid, artistName, verdict } rules").option("--json", "Print JSON", false).action(async (slug, options) => {
+    const {
+      listLabelArtistRulesCommand: listLabelArtistRulesCommand2,
+      parseLabelArtistRulesJson: parseLabelArtistRulesJson2,
+      replaceLabelArtistRulesCommand: replaceLabelArtistRulesCommand2
+    } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
+    if (!options.replace && options.rulesFile !== undefined) {
+      throw new Error("Pass --replace with --rules-file");
+    }
+    if (options.replace && options.rulesFile === undefined) {
+      throw new Error("Pass --rules-file <json> with --replace");
+    }
+    const result = options.replace ? await replaceLabelArtistRulesCommand2(slug, parseLabelArtistRulesJson2(readFileSync7(options.rulesFile ?? "", "utf8"))) : await listLabelArtistRulesCommand2(slug);
+    if (options.json) {
+      printJson({ ok: true, rules: result.rules });
+      return;
+    }
+    if (options.replace) {
+      const noun = result.rules.length === 1 ? "rule" : "rules";
+      console.log(artistRuleWriteLine(`${result.rules.length} ${noun} set`));
+      return;
+    }
+    console.log(artistRuleLines(result.rules).join(`
+`));
+  });
+  labels.command("update").description("Rule on a label's crawl scope or arm a scoped re-walk (operator)").argument("<slug>", "The label's slug (an exact lbl_\u2026 id also works)").option("--seed-state <state>", "The ruling: enabled, disabled, or undecided").option("--rewalk", "Arm a scoped re-walk without changing the ruling", false).option("--json", "Print JSON", false).action(async (slug, options) => {
     const seedState = options.seedState;
-    if (seedState !== "enabled" && seedState !== "disabled" && seedState !== "undecided") {
+    if (seedState !== undefined && seedState !== "enabled" && seedState !== "disabled" && seedState !== "undecided") {
       throw new Error("Pass --seed-state enabled|disabled|undecided");
     }
+    if (seedState === undefined && !options.rewalk) {
+      throw new Error("Pass --seed-state enabled|disabled|undecided or --rewalk");
+    }
     const { updateLabelCommand: updateLabelCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
-    const label = await updateLabelCommand2(slug, seedState);
+    const label = await updateLabelCommand2(slug, seedState, options.rewalk);
     if (options.json) {
       printJson({ label, ok: true });
       return;
     }
-    console.log(`${label.name} (${label.slug}) \u2192 ${label.seedState}.`);
-    console.log(label.seedState === "enabled" ? "  The next crawl seeds from it and stores its releases." : "  The next crawl will not seed from it; nothing already stored is touched.");
+    for (const line of labelUpdateLines(label, options)) {
+      console.log(line);
+    }
   });
   labels.command("merge").description("Merge a slug-split label into its canonical row (operator; re-points + redirects)").argument("<losingSlug>", "The duplicate label to fold away").argument("<canonicalSlug>", "The label to keep \u2014 everything re-points onto it").option("--json", "Print JSON", false).action(async (losingSlug, canonicalSlug, options) => {
     const { mergeLabelCommand: mergeLabelCommand2 } = await Promise.resolve().then(() => (init_admin_labels(), exports_admin_labels));
@@ -10616,12 +10806,14 @@ JSON field reference:
     const {
       aliasWritten,
       canonicalSlug: canon,
+      droppedRules,
       losingSlug: loser,
       reconciled,
       repointed
     } = result;
     console.log(`Merged ${loser} \u2192 ${canon}.`);
     console.log(`  Re-pointed: ${repointed.tracks} track(s), ${repointed.childLabels} sublabel(s), ${repointed.aliases} alias(es).`);
+    console.log(`  Dropped: ${droppedRules} loser-scoped artist rule(s).`);
     console.log(reconciled.length > 0 ? `  Filled onto ${canon} (was empty): ${reconciled.join(", ")}.` : `  Nothing to fill \u2014 ${canon} already carried every fact.`);
     console.log(`  Seed state resolved to: ${result.seedState}.`);
     console.log(`  Alias written: "${aliasWritten.alias}" (${aliasWritten.aliasSlug}) \u2192 confirmed, so it can never re-mint.`);
@@ -13534,6 +13726,7 @@ var stringOptions = new Set([
   "--mime",
   "--min-phrase-words",
   "--model",
+  "--name",
   "--note",
   "--ok",
   "--order",
@@ -13549,6 +13742,7 @@ var stringOptions = new Set([
   "--reasoning",
   "--recorded-at",
   "--recording",
+  "--rules-file",
   "--render",
   "--scene",
   "--scheduled-for",
@@ -13615,5 +13809,8 @@ if (__require.main == __require.module) {
 }
 export {
   parseTelemetryTimestamp,
-  createProgram
+  labelUpdateLines,
+  createProgram,
+  artistRuleLines,
+  ARTIST_RULE_BOUNDARY
 };

package/package.json

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