fluncle 0.246.0 → 0.248.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.246.0".trim() ? "0.246.0".trim() : "0.1.0";
+  currentVersion = "0.248.0".trim() ? "0.248.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2335,7 +2335,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.246.0".trim() ? "0.246.0".trim() : "0.1.0";
+  currentVersion2 = "0.248.0".trim() ? "0.248.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -13494,7 +13494,7 @@ var init_admin_hub_counts = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-labels.ts
-var LabelSeedStateSchema, LabelAdminItemSchema, listLabelsAdmin, updateLabel, listLabelArtistRules, replaceLabelArtistRules, MergeLabelResultSchema, mergeLabel, LabelAliasSourceSchema, LabelAliasKindSchema, LabelAliasCandidateSchema, listLabelAliases, confirmLabelAlias, rejectLabelAlias, DescribeLabelBodySchema, describeLabel, draftLabelBio, LabelBioWorkItemSchema, listLabelsMissingBio, adminLabelsContract;
+var LabelSeedStateSchema, LabelAdminItemSchema, listLabelsAdmin, updateLabel, listLabelArtistRules, replaceLabelArtistRules, MergeLabelResultSchema, mergeLabel, MB_LABEL_MBID_PATTERN, MintLabelOutcomeSchema, LabelTakeOverResultSchema, mintLabel, LabelAliasSourceSchema, LabelAliasKindSchema, LabelAliasCandidateSchema, listLabelAliases, confirmLabelAlias, rejectLabelAlias, DescribeLabelBodySchema, describeLabel, draftLabelBio, LabelBioWorkItemSchema, listLabelsMissingBio, adminLabelsContract;
 var init_admin_labels = __esm(() => {
   init_dist3();
   init_zod();
@@ -13588,6 +13588,34 @@ var init_admin_labels = __esm(() => {
     summary: "Merge a slug-split label into its canonical row (operator; re-points + redirects)",
     tags: ["Admin"]
   }).input(object({ canonicalSlug: string2(), slug: string2() })).output(object({ ok: literal(true), result: MergeLabelResultSchema }));
+  MB_LABEL_MBID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+  MintLabelOutcomeSchema = _enum(["minted", "adopted", "known", "taken_over"]).meta({ id: "MintLabelOutcome" });
+  LabelTakeOverResultSchema = object({
+    clearedFacts: array(string2()),
+    droppedRules: number2(),
+    previousMbLabelId: string2().nullable(),
+    rearmedSeedNode: boolean2(),
+    retiredFrontierNodes: number2(),
+    slug: string2()
+  }).meta({ id: "LabelTakeOverResult" });
+  mintLabel = oc.route({
+    method: "POST",
+    operationId: "mintLabel",
+    path: "/admin/labels",
+    summary: "Mint a label from its MusicBrainz identity (operator; connect-or-create, idempotent)",
+    tags: ["Admin"]
+  }).input(object({
+    mbLabelId: string2().regex(MB_LABEL_MBID_PATTERN, {
+      error: "mbLabelId must be a MusicBrainz label MBID"
+    }),
+    seedState: LabelSeedStateSchema.optional(),
+    takeOverSlug: string2().min(1).optional()
+  })).output(object({
+    label: LabelAdminItemSchema,
+    ok: literal(true),
+    outcome: MintLabelOutcomeSchema,
+    takenOver: LabelTakeOverResultSchema.optional()
+  }));
   LabelAliasSourceSchema = _enum(["operator", "apple", "musicbrainz", "discogs", "spotify"]).meta({ id: "LabelAliasSource" });
   LabelAliasKindSchema = _enum(["name", "hint"]).meta({ id: "LabelAliasKind" });
   LabelAliasCandidateSchema = object({
@@ -13674,6 +13702,7 @@ var init_admin_labels = __esm(() => {
     list_labels_admin: listLabelsAdmin,
     list_labels_missing_bio: listLabelsMissingBio,
     merge_label: mergeLabel,
+    mint_label: mintLabel,
     reject_label_alias: rejectLabelAlias,
     replace_label_artist_rules: replaceLabelArtistRules,
     update_label: updateLabel
@@ -19114,6 +19143,18 @@ async function updateLabelCommand(slugOrId, seedState, rewalk = false) {
   });
   return response.label;
 }
+async function mintLabelCommand(mbLabelId, seedState, takeOverSlug) {
+  const mbid = mbLabelId.trim().toLowerCase();
+  if (!MBID_PATTERN2.test(mbid)) {
+    throw new Error(`'${mbLabelId}' is not a MusicBrainz label MBID`);
+  }
+  const response = await adminApiPost("/api/v1/admin/labels", {
+    mbLabelId: mbid,
+    ...seedState === undefined ? {} : { seedState },
+    ...takeOverSlug === undefined ? {} : { takeOverSlug: takeOverSlug.trim().toLowerCase() }
+  });
+  return { label: response.label, outcome: response.outcome, takenOver: response.takenOver };
+}
 async function describeLabelCommand(slug, options) {
   return adminApiPost(`/api/v1/admin/labels/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
 }
@@ -21567,6 +21608,28 @@ function labelUpdateLines(label, options) {
   }
   return lines;
 }
+var LABEL_MINT_WORDS = {
+  adopted: "ADOPTED",
+  known: "ALREADY KNOWN",
+  minted: "MINTED",
+  taken_over: "TAKEN OVER"
+};
+function labelMintLine(label, outcome, requestedMbid, takenOver) {
+  const word = LABEL_MINT_WORDS[outcome] ?? outcome.toUpperCase();
+  const line = `${word} \u2014 ${label.name} (${label.slug}), MusicBrainz ${label.mbLabelId ?? requestedMbid}, seed state ${label.seedState.toUpperCase()}.`;
+  if (!takenOver) {
+    return line;
+  }
+  const dropped = [
+    `replaced MusicBrainz ${takenOver.previousMbLabelId ?? "none"}`,
+    `${takenOver.droppedRules} artist ${takenOver.droppedRules === 1 ? "rule" : "rules"} dropped`,
+    ...takenOver.clearedFacts.length === 0 ? [] : [`cleared ${takenOver.clearedFacts.join(", ")}`],
+    ...takenOver.retiredFrontierNodes === 0 ? [] : ["retired the old crawl node"],
+    ...takenOver.rearmedSeedNode ? ["re-armed the seed"] : []
+  ].join(" \xB7 ");
+  return `${line}
+  ${dropped}.`;
+}
 var ARTIST_RULE_BOUNDARY = "Rules change what the next crawl takes. Everything already here stays.";
 var UNLISTED_RULE_BOUNDARY = "Unlisted takes the artist page down. The crawl and everything already here stay.";
 function artistRuleWriteLine(prefix, boundary = ARTIST_RULE_BOUNDARY) {
@@ -22894,6 +22957,23 @@ JSON field reference:
       console.log(line);
     }
   });
+  labels.command("mint").description("Mint a label from its MusicBrainz MBID (operator; idempotent)").argument("<mbid>", "The MusicBrainz label MBID").option("--seed-state <state>", "Rule it on arrival: enabled, disabled, or undecided").option("--take-over <slug>", "Re-point this trackless row's identity onto the minted entity").option("--json", "Print JSON", false).action(async (mbid, options) => {
+    const seedState = options.seedState;
+    if (seedState !== undefined && seedState !== "enabled" && seedState !== "disabled" && seedState !== "undecided") {
+      throw new Error("Pass --seed-state enabled|disabled|undecided");
+    }
+    const takeOver = options.takeOver?.trim();
+    if (options.takeOver !== undefined && !takeOver) {
+      throw new Error("Pass --take-over <slug>");
+    }
+    await Promise.resolve().then(() => init_admin_labels2());
+    const { label, outcome, takenOver } = await mintLabelCommand(mbid, seedState, takeOver);
+    if (options.json) {
+      printJson({ label, ok: true, outcome, ...takenOver ? { takenOver } : {} });
+      return;
+    }
+    console.log(labelMintLine(label, outcome, mbid, takenOver));
+  });
   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) => {
     await Promise.resolve().then(() => init_admin_labels2());
     const result = await mergeLabelCommand(losingSlug, canonicalSlug);
@@ -25909,6 +25989,7 @@ var stringOptions = new Set([
   "--stream",
   "--stream-version",
   "--subject",
+  "--take-over",
   "--target",
   "--title",
   "--through-seq",
@@ -25969,6 +26050,7 @@ export {
   UNLISTED_RULE_BOUNDARY,
   artistRuleLines,
   createProgram,
+  labelMintLine,
   labelUpdateLines,
   parseTelemetryTimestamp,
   unmatchedRowLine

package/package.json

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