fluncle 0.245.0 → 0.247.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.245.0".trim() ? "0.245.0".trim() : "0.1.0";
+  currentVersion = "0.247.0".trim() ? "0.247.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.245.0".trim() ? "0.245.0".trim() : "0.1.0";
+  currentVersion2 = "0.247.0".trim() ? "0.247.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -12341,7 +12341,7 @@ var init_admin_prompts = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-projections.ts
-var PROJECTION_STEP_LIMIT_MAX = 500, ProjectionTargetSchema, ProjectionCutoverSchema, ProjectionStepActionSchema, CountSchema, BoundedCountSchema, DigestSchema2, RebuildSchema, BacklogSchema, RepairSchema, OldestOutstandingMarkerAgeSchema, ConvergenceSchema, ProjectionFamilyStatusSchema, ProjectionStatusSchema, getProjectionStatus, advanceProjection, setProjectionCutover, adminProjectionsContract;
+var PROJECTION_STEP_LIMIT_MAX = 500, ProjectionTargetSchema, ProjectionCutoverSchema, ProjectionStepActionSchema, CountSchema, BoundedCountSchema, DigestSchema2, RebuildSchema, BacklogSchema, RepairSchema, OldestOutstandingMarkerAgeSchema, ConvergenceSchema, ProjectionFamilyStatusSchema, ProjectionStatusSchema, getProjectionStatus, advanceProjection, setProjectionCutover, DUE_WORK_REKEY_LIMIT_MAX = 500, rekeyDueWorkQueue, adminProjectionsContract;
 var init_admin_projections = __esm(() => {
   init_dist3();
   init_zod();
@@ -12433,6 +12433,8 @@ var init_admin_projections = __esm(() => {
     complete: boolean2(),
     ok: literal(true),
     processed: CountSchema,
+    rebuildRowsWalked: CountSchema.optional(),
+    rebuildStaleFamilies: CountSchema.optional(),
     scheduled: CountSchema,
     status: ProjectionStatusSchema.optional(),
     target: ProjectionTargetSchema,
@@ -12450,9 +12452,33 @@ var init_admin_projections = __esm(() => {
     status: ProjectionStatusSchema,
     target: ProjectionCutoverSchema
   }));
+  rekeyDueWorkQueue = oc.route({
+    method: "POST",
+    operationId: "rekeyDueWorkQueue",
+    path: "/admin/projections/due-work/{workKind}/rekey",
+    summary: "Mark one due-work queue for re-keying under today's order definition",
+    tags: ["Admin"]
+  }).input(object({
+    apply: boolean2().default(false),
+    cursor: string2().max(200).nullable().default(null),
+    limit: number2().int().min(1).max(DUE_WORK_REKEY_LIMIT_MAX).default(DUE_WORK_REKEY_LIMIT_MAX),
+    workKind: string2().min(1).max(64)
+  })).output(object({
+    applied: boolean2(),
+    cursor: string2().nullable(),
+    definitionVersion: string2(),
+    hasMore: boolean2(),
+    marked: CountSchema,
+    matched: CountSchema,
+    ok: literal(true),
+    remaining: BoundedCountSchema,
+    subjectType: string2(),
+    workKind: string2()
+  }));
   adminProjectionsContract = {
     advance_projection: advanceProjection,
     get_projection_status: getProjectionStatus,
+    rekey_due_work_queue: rekeyDueWorkQueue,
     set_projection_cutover: setProjectionCutover
   };
 });
@@ -13468,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, mintLabel, LabelAliasSourceSchema, LabelAliasKindSchema, LabelAliasCandidateSchema, listLabelAliases, confirmLabelAlias, rejectLabelAlias, DescribeLabelBodySchema, describeLabel, draftLabelBio, LabelBioWorkItemSchema, listLabelsMissingBio, adminLabelsContract;
 var init_admin_labels = __esm(() => {
   init_dist3();
   init_zod();
@@ -13562,6 +13588,24 @@ 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"]).meta({ id: "MintLabelOutcome" });
+  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()
+  })).output(object({
+    label: LabelAdminItemSchema,
+    ok: literal(true),
+    outcome: MintLabelOutcomeSchema
+  }));
   LabelAliasSourceSchema = _enum(["operator", "apple", "musicbrainz", "discogs", "spotify"]).meta({ id: "LabelAliasSource" });
   LabelAliasKindSchema = _enum(["name", "hint"]).meta({ id: "LabelAliasKind" });
   LabelAliasCandidateSchema = object({
@@ -13648,6 +13692,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
@@ -16862,6 +16907,7 @@ async function advanceProjectionCommand(input) {
   let processed = response.processed;
   let scheduled = response.scheduled;
   let wallStopped = false;
+  let rebuildRowsWalked = response.rebuildRowsWalked ?? 0;
   while (!response.complete && steps < maxSteps) {
     if (wallMs !== undefined && now() - startedAt >= wallMs) {
       wallStopped = true;
@@ -16871,18 +16917,56 @@ async function advanceProjectionCommand(input) {
     steps += 1;
     processed += response.processed;
     scheduled += response.scheduled;
+    rebuildRowsWalked += response.rebuildRowsWalked ?? 0;
   }
+  const rebuild = response.rebuildStaleFamilies === undefined ? {} : { rebuildRowsWalked, rebuildStaleFamilies: response.rebuildStaleFamilies };
   if (!includeTerminalStatus) {
     const { status: _status, ...withoutStatus } = response;
-    return { ...withoutStatus, processed, scheduled, steps, wallStopped };
+    return { ...withoutStatus, ...rebuild, processed, scheduled, steps, wallStopped };
   }
   const status = response.status ?? (await getProjectionStatusCommand()).status;
-  return { ...response, processed, scheduled, status, steps, wallStopped };
+  return { ...response, ...rebuild, processed, scheduled, status, steps, wallStopped };
 }
 async function setProjectionCutoverCommand(input) {
   const { enabled, target } = input;
   return adminApiPut(`/api/v1/admin/projections/${target}/cutover`, { enabled });
 }
+async function rekeyDueWorkQueueCommand(input) {
+  const { apply, limit, maxPages, workKind } = input;
+  let cursor = input.cursor;
+  let response = await adminApiPost(`/api/v1/admin/projections/due-work/${encodeURIComponent(workKind)}/rekey`, { apply, cursor, limit });
+  let pages = 1;
+  let marked = response.marked;
+  let matched = response.matched;
+  cursor = response.cursor;
+  while (apply && response.hasMore && response.cursor !== null && pages < maxPages) {
+    response = await adminApiPost(`/api/v1/admin/projections/due-work/${encodeURIComponent(workKind)}/rekey`, { apply, cursor, limit });
+    pages += 1;
+    marked += response.marked;
+    matched += response.matched;
+    cursor = response.cursor;
+  }
+  return { ...response, cursor, marked, matched, pages };
+}
+function parseDueWorkRekeyLimit(value) {
+  const limit = Number(value);
+  if (!Number.isSafeInteger(limit) || limit < 1 || limit > DUE_WORK_REKEY_LIMIT_MAX) {
+    throw new Error(`--limit must be a whole number from 1 through ${DUE_WORK_REKEY_LIMIT_MAX}`);
+  }
+  return limit;
+}
+function parseDueWorkRekeyMaxPages(value) {
+  const pages = Number(value);
+  if (!Number.isSafeInteger(pages) || pages < 1 || pages > DUE_WORK_REKEY_MAX_PAGES) {
+    throw new Error(`--max-pages must be a whole number from 1 through ${DUE_WORK_REKEY_MAX_PAGES}`);
+  }
+  return pages;
+}
+function dueWorkRekeyLine(result) {
+  const remaining = `${result.remaining.count}${result.remaining.truncated ? "+" : ""}`;
+  const verb = result.applied ? `marked ${result.marked}` : `would mark ${result.matched}`;
+  return `${result.workKind} re-key — ${verb} over ${result.pages} page(s); ${remaining} still on the old key; cursor ${result.cursor ?? "start"}; definition ${result.definitionVersion}.`;
+}
 function parseProjectionEnabled(value) {
   if (value !== "true" && value !== "false") {
     throw new Error("--enabled must be true or false");
@@ -16937,7 +17021,7 @@ function projectionStatusLines(status) {
     row("Artist qualification", status.projections.artistQualification, status.cutovers.publicProjections)
   ];
 }
-var PROJECTION_MAX_STEPS = 100, PROJECTION_WALL_MS_MIN = 1000, PROJECTION_WALL_MS_MAX = 600000;
+var PROJECTION_MAX_STEPS = 100, DUE_WORK_REKEY_MAX_PAGES = 200, PROJECTION_WALL_MS_MIN = 1000, PROJECTION_WALL_MS_MAX = 600000;
 var init_admin_projections2 = __esm(() => {
   init_orpc();
   init_api();
@@ -19049,6 +19133,17 @@ async function updateLabelCommand(slugOrId, seedState, rewalk = false) {
   });
   return response.label;
 }
+async function mintLabelCommand(mbLabelId, seedState) {
+  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 }
+  });
+  return { label: response.label, outcome: response.outcome };
+}
 async function describeLabelCommand(slug, options) {
   return adminApiPost(`/api/v1/admin/labels/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
 }
@@ -21502,6 +21597,15 @@ function labelUpdateLines(label, options) {
   }
   return lines;
 }
+var LABEL_MINT_WORDS = {
+  adopted: "ADOPTED",
+  known: "ALREADY KNOWN",
+  minted: "MINTED"
+};
+function labelMintLine(label, outcome, requestedMbid) {
+  const word = LABEL_MINT_WORDS[outcome] ?? outcome.toUpperCase();
+  return `${word} \u2014 ${label.name} (${label.slug}), MusicBrainz ${label.mbLabelId ?? requestedMbid}, seed state ${label.seedState.toUpperCase()}.`;
+}
 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) {
@@ -21786,6 +21890,21 @@ JSON field reference:
     }
     console.log(`${result.target} ${result.action}: steps ${result.steps}, processed ${result.processed}, scheduled ${result.scheduled}, ${result.complete ? "complete" : result.wallStopped ? "wall budget spent, more work remains" : "more work remains"}.`);
   });
+  adminProjections.command("rekey").description("Mark one due-work queue for re-keying under today's order definition").requiredOption("--work-kind <kind>", "Physical queue, e.g. capture-catalogue").option("--cursor <subjectId>", "Resume after this subject id").option("--limit <limit>", "Rows per page (1-500)", "500").option("--max-pages <pages>", "Maximum pages to mark in one run (1-200)", "1").option("--apply", "Write the repair markers; omit for a dry run", false).option("--json", "Print the page result as JSON", false).action(async (options) => {
+    const projections = await Promise.resolve().then(() => (init_admin_projections2(), {}));
+    const result = await rekeyDueWorkQueueCommand({
+      apply: options.apply,
+      cursor: options.cursor ?? null,
+      limit: parseDueWorkRekeyLimit(options.limit),
+      maxPages: parseDueWorkRekeyMaxPages(options.maxPages),
+      workKind: options.workKind
+    });
+    if (options.json) {
+      printJson(result);
+      return;
+    }
+    console.log(dueWorkRekeyLine(result));
+  });
   adminProjections.command("set").description("Open or close one readiness-gated projection cutover").requiredOption("--target <target>", "track_due_work, crawl_due_work, or public_projections").requiredOption("--enabled <boolean>", "true opens; false closes unconditionally").option("--json", "Print the stored flag and current readiness as JSON", false).action(async (options) => {
     const projections = await Promise.resolve().then(() => (init_admin_projections2(), {}));
     const result = await setProjectionCutoverCommand({
@@ -22814,6 +22933,19 @@ 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("--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");
+    }
+    await Promise.resolve().then(() => init_admin_labels2());
+    const { label, outcome } = await mintLabelCommand(mbid, seedState);
+    if (options.json) {
+      printJson({ label, ok: true, outcome });
+      return;
+    }
+    console.log(labelMintLine(label, outcome, mbid));
+  });
   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);
@@ -25785,6 +25917,7 @@ var stringOptions = new Set([
   "--lens",
   "--limit",
   "--max-hop",
+  "--max-pages",
   "--max-steps",
   "--max-overlap",
   "--metrics",
@@ -25845,7 +25978,8 @@ var stringOptions = new Set([
   "--voice-id",
   "--wall-ms",
   "--window-since",
-  "--window-until"
+  "--window-until",
+  "--work-kind"
 ]);
 var rootHelpSections = `
 
@@ -25887,6 +26021,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.245.0"
+  "version": "0.247.0"
 }