fluncle 0.257.0 → 0.258.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.257.0".trim() ? "0.257.0".trim() : "0.1.0";
+  currentVersion = "0.258.0".trim() ? "0.258.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.257.0".trim() ? "0.257.0".trim() : "0.1.0";
+  currentVersion2 = "0.258.0".trim() ? "0.258.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3711,6 +3711,17 @@ var init_src = __esm(() => {
       title: "Label bios",
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin labels list --seed-state undecided",
+      exposedContent: ["read the undecided crawl-seed pile and report whether a triage round is due"],
+      kind: "cron",
+      name: "cron.label-triage",
+      operatorNotes: "daily. A PURE trigger — zero model tokens, one countless admin read and a sort. Fires only when 40+ NEVER-LOOKED labels have accumulated; stale ones ride along but never trigger a round. It cannot rule: recording a finding is record_label_triage (agent tier) and ruling is update_label (operator tier), which 403s the box token. The batched research leg is deliberately unwired until the gate proves it reports honestly. Source: docs/agents/hermes/scripts/{label-triage-sweep.ts,label-triage-sweep.sh}.",
+      probeConfig: { cadenceMs: 24 * 60 * MINUTE_MS, cronName: "fluncle-label-triage", kind: "cron" },
+      statusDescription: "reports when the label pile needs a round",
+      title: "Label triage gate",
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin albums describe --queue",
       exposedContent: [
@@ -12796,6 +12807,7 @@ var init__shared = __esm(() => {
     postedToTelegram: boolean2(),
     previewUrl: string2().optional(),
     releaseDate: string2().optional(),
+    similar: boolean2().optional(),
     sourceAudioFailures: number2().optional(),
     sourceAudioKey: string2().optional(),
     spotifyUrl: string2(),
@@ -13519,7 +13531,8 @@ var init_admin_hub_counts = __esm(() => {
   init_zod();
   HubCountsTableResultSchema = object({
     corrected: number2(),
-    deferred: number2()
+    deferred: number2(),
+    latestCorrected: number2()
   }).meta({ id: "HubCountsTableResult" });
   HubCountsReconcileCursorSchema = object({
     afterId: string2().min(1).max(512).nullable(),
@@ -13549,12 +13562,13 @@ var init_admin_hub_counts = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-labels.ts
-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 LabelSeedStateSchema, LabelTriageVerdictSchema, 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, TriageRuleProposalSchema, RecordLabelTriageBodySchema, recordLabelTriage, adminLabelsContract;
 var init_admin_labels = __esm(() => {
   init_dist3();
   init_zod();
   init_admin_artist_rules();
   LabelSeedStateSchema = _enum(["disabled", "enabled", "undecided"]).meta({ id: "LabelSeedState" });
+  LabelTriageVerdictSchema = _enum(["dnb", "dnb_partial", "not_dnb", "unclear"]).meta({ id: "LabelTriageVerdict" });
   LabelAdminItemSchema = object({
     createdAt: string2(),
     disambiguation: string2().nullable().optional(),
@@ -13569,6 +13583,9 @@ var init_admin_labels = __esm(() => {
     scopeChangedAt: string2().nullable().optional(),
     seedState: LabelSeedStateSchema,
     slug: string2(),
+    triageCheckedAt: string2().nullable().optional(),
+    triageReason: string2().nullable().optional(),
+    triageVerdict: LabelTriageVerdictSchema.nullable().optional(),
     updatedAt: string2()
   }).meta({ id: "LabelAdminItem" });
   listLabelsAdmin = oc.route({
@@ -13748,6 +13765,38 @@ var init_admin_labels = __esm(() => {
     summary: "List labels with findings but no bio yet, oldest first (the bio worklist)",
     tags: ["Admin"]
   }).input(object({ limit: string2().optional() })).output(object({ labels: array(LabelBioWorkItemSchema), ok: literal(true) }));
+  TriageRuleProposalSchema = object({
+    artistMbid: string2(),
+    artistName: string2(),
+    evidence: string2().optional(),
+    firstCreditCount: number2().int().min(0),
+    verdict: _enum(["allow", "block"])
+  });
+  RecordLabelTriageBodySchema = object({
+    censusSummary: string2().optional(),
+    confidence: _enum(["high", "medium", "low"]),
+    evidence: string2(),
+    offLaneShare: number2().min(0).max(1).optional(),
+    reason: string2().optional(),
+    residualOffLaneShare: number2().min(0).max(1).optional(),
+    roundId: string2(),
+    rules: array(TriageRuleProposalSchema).optional(),
+    verdict: LabelTriageVerdictSchema,
+    verifyAgrees: boolean2().optional(),
+    verifyEvidence: string2().optional()
+  }).meta({ id: "RecordLabelTriageBody" });
+  recordLabelTriage = oc.route({
+    method: "POST",
+    operationId: "recordLabelTriage",
+    path: "/admin/labels/{slug}/triage",
+    summary: "Record what a triage round found (stamps the cursor; never rules)",
+    tags: ["Admin"]
+  }).input(RecordLabelTriageBodySchema.extend({ slug: string2() })).output(object({
+    droppedInertRules: number2().int(),
+    ok: literal(true),
+    superseded: boolean2(),
+    triageCheckedAt: string2()
+  }));
   adminLabelsContract = {
     confirm_label_alias: confirmLabelAlias,
     describe_label: describeLabel,
@@ -13758,6 +13807,7 @@ var init_admin_labels = __esm(() => {
     list_labels_missing_bio: listLabelsMissingBio,
     merge_label: mergeLabel,
     mint_label: mintLabel,
+    record_label_triage: recordLabelTriage,
     reject_label_alias: rejectLabelAlias,
     replace_label_artist_rules: replaceLabelArtistRules,
     update_label: updateLabel
@@ -19255,6 +19305,19 @@ async function mintLabelCommand(mbLabelId, seedState, takeOverSlug) {
   });
   return { label: response.label, outcome: response.outcome, takenOver: response.takenOver };
 }
+async function listLabelsAdminCommand(seedState) {
+  const query = seedState === undefined ? "" : `?seedState=${encodeURIComponent(seedState)}`;
+  const response = await adminApiGet(`/api/v1/admin/labels${query}`);
+  return response.labels;
+}
+async function recordLabelTriageCommand(slug, payload) {
+  const response = await adminApiPost(`/api/v1/admin/labels/${encodeURIComponent(slug.trim().toLowerCase())}/triage`, payload);
+  return {
+    droppedInertRules: response.droppedInertRules,
+    superseded: response.superseded,
+    triageCheckedAt: response.triageCheckedAt
+  };
+}
 async function describeLabelCommand(slug, options) {
   return adminApiPost(`/api/v1/admin/labels/${encodeURIComponent(slug)}/bio`, buildBioBody2(options));
 }
@@ -23064,6 +23127,33 @@ JSON field reference:
       console.log(line);
     }
   });
+  labels.command("list").description("List labels with their crawl-seed state and triage cursor").option("--seed-state <state>", "Only this state: enabled, disabled, or undecided").option("--json", "Print JSON", false).action(async (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 labels = await listLabelsAdminCommand(seedState);
+    if (options.json) {
+      console.log(JSON.stringify({ labels }, null, 2));
+      return;
+    }
+    for (const label of labels) {
+      const looked = label.triageCheckedAt ? label.triageVerdict : "never looked";
+      console.log(`${label.slug}  ${label.seedState}  ${looked ?? ""}`.trimEnd());
+    }
+  });
+  labels.command("triage").description("Record what a triage round found for a label (agent; never rules)").argument("<slug>", "The label slug").requiredOption("--payload <file>", "JSON file holding the round's finding for this label").option("--json", "Print JSON", false).action(async (slug, options) => {
+    const payload = JSON.parse(readFileSync6(options.payload, "utf8"));
+    await Promise.resolve().then(() => init_admin_labels2());
+    const result = await recordLabelTriageCommand(slug, payload);
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    const dropped = result.droppedInertRules > 0 ? ` \u2014 dropped ${result.droppedInertRules} inert` : "";
+    console.log(`${slug} \u2192 ${payload.verdict}${dropped}${result.superseded ? " (superseded)" : ""}`);
+  });
   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") {
@@ -26094,6 +26184,7 @@ var stringOptions = new Set([
   "--page-digest",
   "--page-limit",
   "--parent-id",
+  "--payload",
   "--plate",
   "--plate-background",
   "--platform",

package/package.json

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