fluncle 0.152.0 → 0.154.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.152.0".trim() ? "0.152.0".trim() : "0.1.0";
+  currentVersion = "0.154.0".trim() ? "0.154.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.152.0".trim() ? "0.152.0".trim() : "0.1.0";
+  currentVersion2 = "0.154.0".trim() ? "0.154.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3626,6 +3626,7 @@ var init_admin_attention = __esm(() => {
     "label-review": "label",
     newsletter: "newsletter",
     "note-rejected": "held note",
+    "observation-rejected": "held observation",
     "post-tiktok": "tiktok",
     "post-youtube": "youtube",
     submission: "submission",
@@ -5761,6 +5762,35 @@ var init_admin_notes = __esm(() => {
   init_api();
 });
 
+// src/commands/admin-observations.ts
+var exports_admin_observations = {};
+__export(exports_admin_observations, {
+  observationHeldCommand: () => observationHeldCommand,
+  observationGateCommand: () => observationGateCommand
+});
+async function observationHeldCommand(options) {
+  const query = options.settled ? "?open=false" : "";
+  return adminApiGet(`/api/admin/observation-rejections${query}`);
+}
+async function observationGateCommand(options) {
+  const patch = {};
+  if (options.minPhraseWords !== undefined) {
+    patch.minPhraseWords = options.minPhraseWords;
+  }
+  if (options.maxOverlap !== undefined) {
+    patch.maxOverlap = options.maxOverlap;
+  }
+  if (Object.keys(patch).length === 0) {
+    const response2 = await adminApiGet("/api/admin/observation-rejections");
+    return response2.gate;
+  }
+  const response = await adminApiPatch("/api/admin/observation-gate", patch);
+  return response.gate;
+}
+var init_admin_observations = __esm(() => {
+  init_api();
+});
+
 // src/commands/admin-catalogue.ts
 var exports_admin_catalogue = {};
 __export(exports_admin_catalogue, {
@@ -8901,6 +8931,18 @@ function addAdminCommands(program2) {
     const { noteGateCommand: noteGateCommand2 } = await Promise.resolve().then(() => (init_admin_notes(), exports_admin_notes));
     await runNoteGate(options, noteGateCommand2);
   });
+  const observations = configureCommand(admin.command("observations").description("The observation echo gate: held scripts + dials"));
+  observations.action(() => {
+    observations.outputHelp();
+  });
+  observations.command("held").description("The observation scripts the echo gate held back (and why)").option("--settled", "Read the ones already ruled on instead (the retune evidence)", false).option("--json", "Print JSON", false).action(async (options) => {
+    const { observationHeldCommand: observationHeldCommand2 } = await Promise.resolve().then(() => (init_admin_observations(), exports_admin_observations));
+    await runObservationHeld(options, observationHeldCommand2);
+  });
+  observations.command("gate").description("Read or retune the observation echo gate's thresholds (a flip, not a deploy)").option("--min-phrase-words <n>", "A shared run this long is a lift (2-20; default 4)").option("--max-overlap <x>", "Content-word overlap at/above this is an echo (0.05-1; default 0.3)").option("--json", "Print JSON", false).action(async (options) => {
+    const { observationGateCommand: observationGateCommand2 } = await Promise.resolve().then(() => (init_admin_observations(), exports_admin_observations));
+    await runObservationGate(options, observationGateCommand2);
+  });
   const catalogue = configureCommand(admin.command("catalogue").description("The catalogue (uncertified tracks): the crawler + its ranking"));
   catalogue.action(() => {
     catalogue.outputHelp();
@@ -9385,6 +9427,18 @@ async function runBackfillLastfm(options, backfillLastfmCommand2) {
     process.exitCode = 1;
   }
 }
+function anchorOutcomeSuffix(outcome) {
+  switch (outcome) {
+    case "throttled":
+      return " (Spotify throttled the fill; the anchor breaker is pacing it)";
+    case "unauthorized":
+      return " (Spotify grant is gone \u2014 reconnect Spotify from /admin to resume anchoring)";
+    case "breaker_open":
+      return " (anchor fill PAUSED on its breaker; it resumes after the cooldown)";
+    default:
+      return "";
+  }
+}
 async function runCrawlCatalogue(options, crawlCatalogueCommand2) {
   const limit = parseListLimit(options.limit);
   const maxHop = Number.parseInt(options.maxHop ?? "2", 10);
@@ -9396,7 +9450,7 @@ async function runCrawlCatalogue(options, crawlCatalogueCommand2) {
   } else {
     console.log(`Expanded ${result.expanded} node(s) at hop \u2264 ${result.maxHop}: ${result.tracksFound} track(s) found, ${result.tracksWritten} written, ${result.tracksSkipped} already held.`);
     console.log(`  +${result.seeded} seed(s), +${result.nodesEnqueued} node(s) enqueued, ${result.frontierPending} pending, ${result.failed} failed.`);
-    console.log(`  ${result.anchorsFilled} Spotify anchor(s) filled.`);
+    console.log(`  ${result.anchorsFilled} Spotify anchor(s) filled${anchorOutcomeSuffix(result.anchorOutcome)}.`);
     if (result.labelsDiscovered.length > 0) {
       console.log(`  New labels to rule on: ${result.labelsDiscovered.join(", ")} (they are NOT crawled until enabled).`);
     }
@@ -9416,6 +9470,14 @@ async function runCrawlStatus(options, crawlStatusCommand2) {
   }
   const { frontier, frontierByKind } = result;
   console.log(`Catalogue: ${result.catalogueTracks} uncertified track(s); ${result.anchorsPending} awaiting a Spotify anchor.`);
+  const { spotifyAnchor } = result;
+  if (spotifyAnchor.tripped) {
+    const mins = Math.ceil(spotifyAnchor.cooldownRemainingMs / 60000);
+    const why = spotifyAnchor.reason === "unauthorized" ? "the Spotify grant is gone \u2014 reconnect Spotify from /admin to resume anchoring" : "Spotify is throttling the app \u2014 it self-heals when the throttle lifts";
+    console.log(`  Spotify anchor PAUSED (${why}); breaker cools in ~${mins} min.`);
+  } else if (spotifyAnchor.consecutiveFailures > 0) {
+    console.log(`  Spotify anchor wobbling (${spotifyAnchor.consecutiveFailures} failing pass(es); reason: ${spotifyAnchor.reason ?? "unknown"}).`);
+  }
   console.log(`Frontier: ${frontier.pending} pending, ${frontier.done} done, ${frontier.failed} failed, ${frontier.skipped} skipped (${frontierByKind.label} label, ${frontierByKind.artist} artist, ${frontierByKind.release} release).`);
   console.log(`Seeds (${result.seedLabels.length}): ${result.seedLabels.join(", ") || "none enabled"}.`);
   console.log(`Awaiting your ruling: ${result.labelsUndecided} label(s).`);
@@ -10751,6 +10813,44 @@ async function runNoteGate(options, noteGateCommand2) {
   }
   console.log(`The echo gate: a lift is ${gate.minPhraseWords}+ shared words; an echo is ${Math.round(gate.maxOverlap * 100)}%+ of a neighbour's words.`);
 }
+async function runObservationHeld(options, observationHeldCommand2) {
+  const { gate, rejections } = await observationHeldCommand2({ settled: options.settled === true });
+  if (options.json) {
+    printJson({ gate, ok: true, rejections });
+    return;
+  }
+  if (rejections.length === 0) {
+    console.log(options.settled ? "Nothing ruled on yet." : "Nothing held back. The gate is quiet.");
+    return;
+  }
+  console.log(`The gate sits at ${gate.minPhraseWords} lifted words / ${Math.round(gate.maxOverlap * 100)}% overlap.`);
+  for (const held of rejections) {
+    const ruled = held.resolution ? ` [${held.resolution}]` : "";
+    const bounced = held.attempts > 1 ? ` (bounced ${held.attempts}x)` : "";
+    console.log("");
+    console.log(`${held.logId ?? held.trackId}  ${held.title}${bounced}${ruled}`);
+    console.log(`  wrote:  ${held.script}`);
+    if (held.phrase) {
+      console.log(`  lifted: "${held.phrase}" from ${held.neighborLogId ?? "a neighbour"}`);
+    } else {
+      console.log(`  reuses: ${Math.round(held.overlap * 100)}% of ${held.neighborLogId ?? "a neighbour"}'s words`);
+    }
+    console.log(`  judged at: ${held.minPhraseWords} words / ${Math.round(held.maxOverlap * 100)}%`);
+  }
+}
+async function runObservationGate(options, observationGateCommand2) {
+  const minPhraseWords = options.minPhraseWords === undefined ? undefined : Number(options.minPhraseWords);
+  const maxOverlap = options.maxOverlap === undefined ? undefined : Number(options.maxOverlap);
+  const gate = await observationGateCommand2({
+    ...maxOverlap === undefined ? {} : { maxOverlap },
+    ...minPhraseWords === undefined ? {} : { minPhraseWords }
+  });
+  if (options.json) {
+    printJson({ gate, ok: true });
+    return;
+  }
+  console.log(`The observation echo gate: a lift is ${gate.minPhraseWords}+ shared words; an echo is ${Math.round(gate.maxOverlap * 100)}%+ of a neighbour's words.`);
+}
 async function runGalaxyMapRead(options, galaxyMapReadCommand2) {
   const galaxies = await galaxyMapReadCommand2();
   if (options.json) {

package/package.json

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