fluncle 0.179.0 → 0.181.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.179.0".trim() ? "0.179.0".trim() : "0.1.0";
+  currentVersion = "0.181.0".trim() ? "0.181.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2260,7 +2260,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.179.0".trim() ? "0.179.0".trim() : "0.1.0";
+  currentVersion2 = "0.181.0".trim() ? "0.181.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2504,6 +2504,14 @@ var init_src = __esm(() => {
       url: `${SITE}/privacy`,
       weights: { web: "tertiary" }
     },
+    {
+      exposedContent: ["the terms of use"],
+      kind: "web_route",
+      name: "web.terms",
+      route: "/terms",
+      url: `${SITE}/terms`,
+      weights: { web: "tertiary" }
+    },
     {
       exposedContent: ["the Galaxy game's front door (root rewrites to /galaxy)"],
       kind: "subdomain",
@@ -3121,13 +3129,12 @@ var init_src = __esm(() => {
       weights: { status: "hidden" }
     },
     {
-      command: "fluncle admin backfills label-releases",
       exposedContent: [
-        "tap Spotify's fresh releases for the operator's enabled seed labels → day-one uncertified catalogue rows"
+        "tap day-one fresh releases for the operator's enabled seed labels → uncertified catalogue rows"
       ],
       kind: "cron",
       name: "cron.label-releases",
-      operatorNotes: "every 24h, run by a rave-02 HOST systemd timer (docs/agents/hermes/label-releases-timer/). The FRESHNESS TAP (D8): MusicBrainz WALKS the graph (cron.crawl) but lags a release ~2 weeks; Spotify has it day one, so this searches each ENABLED seed label's fresh releases (`label:\"<name>\" tag:new`) and mints METADATA-ONLY catalogue rows (a `tracks` row with no `findings` row) with their real release dates — closing the /fresh lag cliff. The fuzzy `label:` search is gated on TWO signals before an album mints onto public /fresh: an album's Spotify artist must already be in our archive (`artists.spotify_artist_id` — the primary identity/genre anchor that stops cross-genre homonym junk) AND the album's ℗/© copyright must EXACTLY match the seed label (a brand-new artist's debut is skipped until the MB crawl backfills them). It certifies nothing, publishes nothing, and never widens the graph (no new labels, no artist hops). Deduped against the MB crawl from both directions (Spotify id/uri/ISRC + same-album title fold). Worker-paced, reusing the publish path's Spotify OAuth (no new secret; Apple was a measured 2/99 seed-label dead end). Zero LLM tokens. Source: docs/agents/hermes/scripts/label-releases-sweep.*. See docs/catalogue-crawler.md.",
+      operatorNotes: "every 24h, run by a rave-02 HOST systemd timer (docs/agents/hermes/label-releases-timer/). The FRESHNESS TAP (D8): MusicBrainz WALKS the graph (cron.crawl) but lags a release ~2 weeks; Spotify has it day one, so this mints METADATA-ONLY catalogue rows (a `tracks` row with no `findings` row) for each ENABLED seed label's fresh releases with their real dates — closing the /fresh lag cliff. Runs OFF the official (dev-mode) Spotify app, which is rate-limited to death at its tier and must stay for user paths: the box reads the due seed labels (`list_label_releases_work`), runs an Apify Spotify-scraper actor per label (`label:\"<name>\" tag:new`), maps each result album (inline tracks[] + ISRCs + artists[]) to a candidate, and POSTs them to the agent-tier `backfill_label_releases` op — where the WORKER re-runs the FULL gate (the box's verdict is never trusted) and mints. The gate: artist-grounding (an album's Spotify artist already in `artists.spotify_artist_id` — the PRIMARY anchor that stops cross-genre homonym junk, always required) AND, when the actor gives a label signal (album_label/copyright — both null in albums-search mode, so grounding-only there), an exact fold-match to the seed name. It certifies nothing, publishes nothing, never widens the graph (no new labels, no artist hops). Deduped against the MB crawl from both directions (Spotify id/uri/ISRC + same-album title fold). Reuses the anchor sweep's APIFY_API_TOKEN (no new secret). Calls the oRPC HTTP endpoints directly (no CLI command the pinned box CLI would lack). Zero LLM tokens. Source: docs/agents/hermes/scripts/label-releases-sweep.*. See docs/catalogue-crawler.md.",
       probeConfig: {
         cadenceMs: 24 * 60 * MINUTE_MS,
         cronName: "fluncle-label-releases",
@@ -4128,7 +4135,6 @@ __export(exports_admin_tracks, {
   captureQueueCommand: () => captureQueueCommand,
   backfillRecordingMbidsCommand: () => backfillRecordingMbidsCommand,
   backfillLastfmCommand: () => backfillLastfmCommand,
-  backfillLabelReleasesCommand: () => backfillLabelReleasesCommand,
   backfillDiscogsCommand: () => backfillDiscogsCommand,
   backfillAppleMusicCommand: () => backfillAppleMusicCommand,
   backfillAppleCatalogueCommand: () => backfillAppleCatalogueCommand
@@ -4315,10 +4321,6 @@ async function backfillAppleCatalogueCommand(limit, dryRun) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   return adminApiPost(`/api/admin/backfill/apple-catalogue?${params.toString()}`);
 }
-async function backfillLabelReleasesCommand(limit, dryRun) {
-  const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
-  return adminApiPost(`/api/admin/backfill/label-releases?${params.toString()}`);
-}
 async function backfillRecordingMbidsCommand(limit, dryRun, cursor) {
   const params = new URLSearchParams({ dryRun: String(dryRun), limit: String(limit) });
   if (cursor) {
@@ -6114,6 +6116,23 @@ var init_mixtape_mixcloud2 = __esm(() => {
   PICTURE_MAX_BYTES2 = 10 * 1024 * 1024;
 });
 
+// src/commands/auth-tiktok.ts
+var exports_auth_tiktok = {};
+__export(exports_auth_tiktok, {
+  authTikTokCommand: () => authTikTokCommand
+});
+async function authTikTokCommand() {
+  const response = await adminApiGet("/api/admin/tiktok/auth/start");
+  console.log(`Open this TikTok authorization URL:
+
+${response.authUrl}
+
+After approving access, TikTok returns to the Fluncle admin callback and stores the refresh token server-side.`);
+}
+var init_auth_tiktok = __esm(() => {
+  init_api();
+});
+
 // src/commands/auth-lastfm.ts
 var exports_auth_lastfm = {};
 __export(exports_auth_lastfm, {
@@ -9439,6 +9458,10 @@ function addAdminCommands(program2) {
     const { authMixcloudCommand: authMixcloudCommand3 } = await Promise.resolve().then(() => (init_mixtape_mixcloud2(), exports_mixtape_mixcloud2));
     await authMixcloudCommand3();
   });
+  auth.command("tiktok").description("Authorize TikTok access (Display API per-video metrics)").action(async () => {
+    const { authTikTokCommand: authTikTokCommand2 } = await Promise.resolve().then(() => (init_auth_tiktok(), exports_auth_tiktok));
+    await authTikTokCommand2();
+  });
   auth.command("lastfm").description("Authorize Last.fm access (love-on-add). Run once for the URL, then again with --token").option("--token <token>", "The approved request token, to mint the session key").action(async (options) => {
     const { authLastfmCommand: authLastfmCommand2 } = await Promise.resolve().then(() => (init_auth_lastfm(), exports_auth_lastfm));
     await authLastfmCommand2(options);
@@ -9698,10 +9721,6 @@ function addAdminCommands(program2) {
     const { backfillAppleCatalogueCommand: backfillAppleCatalogueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runBackfillAppleCatalogue(options, backfillAppleCatalogueCommand2);
   });
-  backfill.command("label-releases").description("Tap Spotify's fresh releases for enabled seed labels into catalogue rows").option("--dry-run", "Report the labels that would be probed without any Spotify call", false).option("--limit <limit>", "Max enabled seed labels to probe per pass", "5").option("--json", "Print JSON", false).action(async (options) => {
-    const { backfillLabelReleasesCommand: backfillLabelReleasesCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
-    await runBackfillLabelReleases(options, backfillLabelReleasesCommand2);
-  });
   backfill.command("artists").description("Back-fill the artist entity (artists + track_artists) for existing findings").option("--dry-run", "Report which findings would be upserted without touching the DB", false).option("--limit <limit>", "Max findings to process", "50").option("--json", "Print JSON", false).action(async (options) => {
     const { backfillArtistsCommand: backfillArtistsCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runBackfillArtists(options, backfillArtistsCommand2);
@@ -10395,89 +10414,6 @@ async function runBackfillAppleCatalogue(options, backfillAppleCatalogueCommand2
     process.exitCode = 1;
   }
 }
-async function runBackfillLabelReleases(options, backfillLabelReleasesCommand2) {
-  const perPass = parseListLimit(options.limit);
-  const newTrackIds = [];
-  const labelSlugs = [];
-  const failedLabels = [];
-  let dryRun = options.dryRun;
-  let throttled = false;
-  let configured = true;
-  let labelsProbed = 0;
-  let albumsSeen = 0;
-  let albumsMatched = 0;
-  let newRows = 0;
-  let skippedKnown = 0;
-  let skippedUngrounded = 0;
-  let failedFetches = 0;
-  let fetchCeilingHit = false;
-  const MAX_PASSES = 100;
-  for (let pass = 0;pass < MAX_PASSES; pass += 1) {
-    const result = await backfillLabelReleasesCommand2(perPass, options.dryRun);
-    dryRun = result.dryRun;
-    configured = result.configured;
-    labelsProbed += result.labelsProbed;
-    albumsSeen += result.albumsSeen;
-    albumsMatched += result.albumsMatched;
-    newRows += result.newRows;
-    skippedKnown += result.skippedKnown;
-    skippedUngrounded += result.skippedUngrounded;
-    failedFetches += result.failedFetches;
-    fetchCeilingHit = fetchCeilingHit || result.fetchCeilingHit;
-    newTrackIds.push(...result.newTrackIds);
-    labelSlugs.push(...result.labelSlugs);
-    failedLabels.push(...result.failedLabels);
-    if (!options.json) {
-      const verb2 = result.dryRun ? "would probe" : "probed";
-      console.log(`  \u2026${verb2} ${result.labelSlugs.length} label(s); ${result.albumsMatched} matched album(s); ${result.newRows} new; ${result.skippedKnown} known; ${result.skippedUngrounded} ungrounded; ${result.failedFetches} fetch-fail; ${result.failedLabels.length} search-fail`);
-    }
-    if (!result.configured) {
-      break;
-    }
-    if (result.rateLimited) {
-      throttled = true;
-      break;
-    }
-    if (result.dryRun) {
-      break;
-    }
-    if (result.labelsProbed === 0) {
-      break;
-    }
-  }
-  if (options.json) {
-    printSweepJson({
-      albumsMatched,
-      albumsSeen,
-      configured,
-      dryRun,
-      failedFetches,
-      failedLabels,
-      fetchCeilingHit,
-      labelSlugs,
-      labelsProbed,
-      newRows,
-      newTrackIds,
-      rateLimited: throttled,
-      skippedKnown,
-      skippedUngrounded
-    }, 0);
-    return;
-  }
-  if (!configured) {
-    console.log("Label-releases tap is a no-op \u2014 the Worker's Spotify grant is gone; reconnect Spotify.");
-    return;
-  }
-  const verb = dryRun ? "Would probe" : "Probed";
-  const probedCount = dryRun ? labelSlugs.length : labelsProbed;
-  console.log(`${verb} ${probedCount} enabled seed label(s); ${albumsMatched} matched album(s); ${newRows} new catalogue row(s); ${skippedKnown} already known; ${skippedUngrounded} dropped for no known artist; ${failedFetches} fetch-fail; ${failedLabels.length} search-fail.`);
-  if (fetchCeilingHit) {
-    console.log("  (a pass ended early on the single-fetch ceiling \u2014 resumes next tick)");
-  }
-  for (const slug of failedLabels) {
-    console.log(`  search error: ${slug}`);
-  }
-}
 async function runBackfillArtists(options, backfillArtistsCommand2) {
   const limit = parseListLimit(options.limit);
   const upserted = [];

package/package.json

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