fluncle 0.258.0 → 0.260.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.258.0".trim() ? "0.258.0".trim() : "0.1.0";
+  currentVersion = "0.260.0".trim() ? "0.260.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2258,7 +2258,7 @@ var init_about = __esm(() => {
       heading: "For the nerds",
       links: [
         { label: "The Galaxy (game)", url: "https://galaxy.fluncle.com" },
-        { label: "SSH (this terminal)", url: "ssh rave.fluncle.com" },
+        { label: "SSH (the rave terminal)", url: "ssh rave.fluncle.com" },
         { label: "Source", url: "https://github.com/mauricekleine/fluncle" }
       ]
     }
@@ -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.258.0".trim() ? "0.258.0".trim() : "0.1.0";
+  currentVersion2 = "0.260.0".trim() ? "0.260.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3293,7 +3293,7 @@ var init_src = __esm(() => {
     },
     {
       command: "fluncle random",
-      exposedContent: ["the archive throws one back"],
+      exposedContent: ["the archive throws a banger back"],
       kind: "cli",
       name: "cli.random",
       weights: { cli: "secondary" }
@@ -3879,6 +3879,24 @@ var init_src = __esm(() => {
       title: "Healthcheck prober",
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin digests send",
+      exposedContent: [
+        "send new releases from followed artists and labels to signed-in crew each Friday"
+      ],
+      kind: "cron",
+      name: "cron.follow-digest",
+      operatorNotes: "Friday 17:00 Amsterdam, a template-only host-timer sweep. The Worker owns recipient selection, the enabled-by-default kill switch, Resend idempotency keys, and per-call send cap. The box uses only its agent token. Source: docs/agents/hermes/scripts/follow-digest-sweep.*.",
+      probeConfig: {
+        cadenceMs: 7 * 24 * 60 * MINUTE_MS,
+        cronName: "fluncle-follow-digest",
+        kind: "cron",
+        schedule: { time: "17:00", tz: "Europe/Amsterdam", weekday: 5 }
+      },
+      statusDescription: "sends new releases from the artists and labels you follow",
+      title: "Your follows",
+      weights: { status: "secondary" }
+    },
     {
       command: "fluncle admin newsletter draft",
       exposedContent: [
@@ -10776,6 +10794,7 @@ var init_admin_catalogue = __esm(() => {
     gateReason: _enum([
       "friday_window",
       "flag_off",
+      "quota_hold",
       "breaker_quota",
       "breaker_throttle",
       "shared_meter",
@@ -15742,6 +15761,113 @@ var init_editions = __esm(() => {
   };
 });
 
+// ../../packages/contracts/src/orpc/follow-digest.ts
+var TokenSchema, sendFollowDigests, getFollowDigestState, setFollowDigestState, unsubscribeFollowDigest, subscribeFollowDigest, listDigestFollows, deleteDigestFollow, followDigestContract;
+var init_follow_digest = __esm(() => {
+  init_dist3();
+  init_zod();
+  TokenSchema = string2().min(10).max(1024);
+  sendFollowDigests = oc.route({
+    method: "POST",
+    operationId: "sendFollowDigests",
+    path: "/admin/follow-digests/send",
+    summary: "Send the weekly digest to eligible followers in a bounded batch",
+    tags: ["Admin"]
+  }).input(object({
+    cursor: string2().optional(),
+    dryRun: boolean2().optional(),
+    limit: number2().int().min(1).max(50).optional()
+  })).output(object({
+    capped: boolean2(),
+    considered: number2(),
+    dryRun: boolean2(),
+    empty: number2(),
+    failed: number2(),
+    nextCursor: string2().optional(),
+    ok: literal(true),
+    paused: boolean2(),
+    sent: number2(),
+    skipped: number2(),
+    unknown: number2(),
+    weekKey: string2()
+  }));
+  getFollowDigestState = oc.route({
+    method: "GET",
+    operationId: "getFollowDigestState",
+    path: "/admin/follow-digests/state",
+    summary: "Read the follow digest kill switch",
+    tags: ["Admin"]
+  }).output(object({ ok: literal(true), paused: boolean2() }));
+  setFollowDigestState = oc.route({
+    method: "PUT",
+    operationId: "setFollowDigestState",
+    path: "/admin/follow-digests/state",
+    summary: "Pause or resume weekly follow digests",
+    tags: ["Admin"]
+  }).input(object({ paused: boolean2() })).output(object({ ok: literal(true), paused: boolean2() }));
+  unsubscribeFollowDigest = oc.route({
+    inputStructure: "detailed",
+    method: "POST",
+    operationId: "unsubscribeFollowDigest",
+    path: "/follow-digest/unsubscribe",
+    summary: "Unsubscribe a signed follow digest recipient",
+    tags: ["Follow digest"]
+  }).input(object({
+    body: object({
+      "List-Unsubscribe": literal("One-Click").optional(),
+      token: TokenSchema.optional()
+    }).optional(),
+    query: object({ token: TokenSchema.optional() })
+  })).output(object({ ok: literal(true), subscribed: literal(false) }));
+  subscribeFollowDigest = oc.route({
+    inputStructure: "detailed",
+    method: "POST",
+    operationId: "subscribeFollowDigest",
+    path: "/follow-digest/subscribe",
+    summary: "Subscribe a signed follow digest recipient",
+    tags: ["Follow digest"]
+  }).input(object({
+    body: object({ token: TokenSchema.optional() }).optional(),
+    query: object({ token: TokenSchema.optional() })
+  })).output(object({ ok: literal(true), subscribed: literal(true) }));
+  listDigestFollows = oc.route({
+    method: "GET",
+    operationId: "listDigestFollows",
+    path: "/follow-digest/follows",
+    summary: "List follows for a signed digest recipient",
+    tags: ["Follow digest"]
+  }).input(object({ token: TokenSchema })).output(object({
+    follows: array(object({
+      id: string2(),
+      kind: _enum(["artist", "label"]),
+      name: string2(),
+      slug: string2()
+    })),
+    ok: literal(true),
+    subscribed: boolean2()
+  }));
+  deleteDigestFollow = oc.route({
+    inputStructure: "detailed",
+    method: "DELETE",
+    operationId: "deleteDigestFollow",
+    path: "/follow-digest/follows/{id}",
+    summary: "Remove one follow for a signed digest recipient",
+    tags: ["Follow digest"]
+  }).input(object({
+    params: object({ id: string2().min(1) }),
+    query: object({ token: TokenSchema })
+  })).output(object({ ok: literal(true) }));
+  followDigestContract = {
+    delete_digest_follow: deleteDigestFollow,
+    get_follow_digest_state: getFollowDigestState,
+    list_digest_follows: listDigestFollows,
+    send_follow_digests: sendFollowDigests,
+    set_follow_digest_state: setFollowDigestState,
+    subscribe_follow_digest: subscribeFollowDigest,
+    unsubscribe_follow_digest: unsubscribeFollowDigest
+  };
+});
+
 // ../../packages/contracts/src/orpc/health.ts
 var getHealth, healthContract;
 var init_health = __esm(() => {
@@ -15759,6 +15885,74 @@ var init_health = __esm(() => {
   };
 });
 
+// ../../packages/contracts/src/orpc/me-follows.ts
+var FollowKindSchema, FollowSchema, SaveFollowBodySchema, listPrivateFollows, savePrivateFollow, deletePrivateFollow, revokePrivateFollowLinkAccess, meFollowsContract;
+var init_me_follows = __esm(() => {
+  init_dist3();
+  init_zod();
+  FollowKindSchema = _enum(["artist", "label"]).meta({ id: "FollowKind" });
+  FollowSchema = object({
+    createdAt: string2(),
+    entityId: string2(),
+    id: string2(),
+    includeSimilar: boolean2(),
+    kind: FollowKindSchema,
+    name: string2(),
+    slug: string2()
+  }).meta({ id: "Follow" });
+  SaveFollowBodySchema = looseObject({
+    entityId: unknown().optional(),
+    intent: unknown().optional(),
+    kind: unknown().optional()
+  });
+  listPrivateFollows = oc.route({
+    method: "GET",
+    operationId: "listPrivateFollows",
+    path: "/me/follows",
+    summary: "List the artists and labels the signed-in user follows",
+    tags: ["Me"]
+  }).output(object({ follows: array(FollowSchema), ok: literal(true) }));
+  savePrivateFollow = oc.route({
+    method: "POST",
+    operationId: "savePrivateFollow",
+    path: "/me/follows",
+    summary: "Follow an artist or label for the signed-in user",
+    tags: ["Me"]
+  }).input(SaveFollowBodySchema).output(object({
+    follow: object({
+      createdAt: string2(),
+      entityId: string2(),
+      id: string2(),
+      includeSimilar: boolean2(),
+      kind: FollowKindSchema,
+      name: string2(),
+      slug: string2()
+    }),
+    followsEmail: boolean2(),
+    ok: literal(true)
+  }));
+  deletePrivateFollow = oc.route({
+    method: "DELETE",
+    operationId: "deletePrivateFollow",
+    path: "/me/follows/{id}",
+    summary: "Unfollow an artist or label for the signed-in user",
+    tags: ["Me"]
+  }).input(object({ id: string2() })).output(object({ ok: literal(true) }));
+  revokePrivateFollowLinkAccess = oc.route({
+    method: "POST",
+    operationId: "revokePrivateFollowLinkAccess",
+    path: "/me/follow-link-access/revoke",
+    summary: "Revoke emailed follows management links for the signed-in user",
+    tags: ["Me"]
+  }).output(object({ ok: literal(true), token: string2() }));
+  meFollowsContract = {
+    delete_private_follow: deletePrivateFollow,
+    list_private_follows: listPrivateFollows,
+    revoke_private_follow_link_access: revokePrivateFollowLinkAccess,
+    save_private_follow: savePrivateFollow
+  };
+});
+
 // ../../packages/contracts/src/orpc/me-galaxy.ts
 var GalaxyProgressSchema, GalaxyMergeBodySchema, GalaxyLogBodySchema, getPrivateGalaxyProgress, mergePrivateGalaxyProgress, collectPrivateGalaxyLog, GalaxyCollectionItemSchema, GalaxyCompletionSchema, listPrivateGalaxyCollection, meGalaxyContract;
 var init_me_galaxy = __esm(() => {
@@ -15971,6 +16165,7 @@ var init_me_saved = __esm(() => {
   init_zod();
   SavedFindingSchema = object({
     artists: array(string2()),
+    href: string2().optional(),
     imageUrl: string2().optional(),
     logId: string2().optional(),
     note: string2().optional(),
@@ -16078,6 +16273,7 @@ var PrivateSubmissionSchema, ProfileBodySchema, getCurrentPrivateUser, getPrivat
 var init_me2 = __esm(() => {
   init_dist3();
   init_zod();
+  init_me_follows();
   init_me_galaxy();
   init_me_preferences();
   init_me_recs();
@@ -16135,6 +16331,8 @@ var init_me2 = __esm(() => {
     ok: literal(true),
     summary: object({
       credentials: string2(),
+      followDigest: string2().optional(),
+      follows: string2().optional(),
       galaxyProgress: string2(),
       preferences: string2().optional(),
       recSeeds: string2().optional(),
@@ -16155,6 +16353,23 @@ var init_me2 = __esm(() => {
   }).output(object({
     export: object({
       account: PublicUserSchema,
+      followDigest: object({
+        lastReleaseCount: number2().nullable(),
+        lastSentAt: string2().nullable(),
+        lastWeekKey: string2().nullable(),
+        unsubscribedAt: string2().nullable(),
+        updatedAt: string2()
+      }).nullable().optional(),
+      followDigestDeliveries: array(object({
+        attempts: number2(),
+        claimedAt: string2(),
+        id: string2(),
+        payloadJson: string2(),
+        sentAt: string2().nullable(),
+        status: string2(),
+        weekKey: string2()
+      })).optional(),
+      follows: array(FollowSchema).optional(),
       generatedAt: string2(),
       id: string2(),
       preferences: UserPreferencesSchema,
@@ -16298,6 +16513,7 @@ var init_me_watches = __esm(() => {
     kind: unknown().optional()
   });
   listPrivateWatches = oc.route({
+    deprecated: true,
     method: "GET",
     operationId: "listPrivateWatches",
     path: "/me/watches",
@@ -16305,6 +16521,7 @@ var init_me_watches = __esm(() => {
     tags: ["Me"]
   }).output(object({ ok: literal(true), watches: array(WatchSchema) }));
   savePrivateWatch = oc.route({
+    deprecated: true,
     method: "POST",
     operationId: "savePrivateWatch",
     path: "/me/watches",
@@ -16321,6 +16538,7 @@ var init_me_watches = __esm(() => {
     })
   }));
   deletePrivateWatch = oc.route({
+    deprecated: true,
     method: "DELETE",
     operationId: "deletePrivateWatch",
     path: "/me/watches/{id}",
@@ -16838,6 +17056,7 @@ var init_orpc = __esm(() => {
   init_admin_users();
   init_devices();
   init_editions();
+  init_follow_digest();
   init_health();
   init_me2();
   init_me_frontier();
@@ -16846,6 +17065,7 @@ var init_orpc = __esm(() => {
   init_me_recs();
   init_me_saved();
   init_me_sets();
+  init_me_follows();
   init_me_watches();
   init_mix();
   init_mixtapes2();
@@ -16858,6 +17078,7 @@ var init_orpc = __esm(() => {
   init_submissions();
   init_tracks();
   init_albums2();
+  init_follow_digest();
   init_artists2();
   init_labels2();
   init_mix();
@@ -16908,6 +17129,7 @@ var init_orpc = __esm(() => {
   init_me_recs();
   init_me_saved();
   init_me_sets();
+  init_me_follows();
   init_me_watches();
   init_mixtapes2();
   init_newsletter();
@@ -16946,6 +17168,7 @@ var init_orpc = __esm(() => {
     ...adminFunnelContract,
     ...adminHealthContract,
     ...adminHubCountsContract,
+    ...followDigestContract,
     ...adminLabelsContract,
     ...adminLogbookContract,
     ...adminMigrationsContract,
@@ -16972,6 +17195,7 @@ var init_orpc = __esm(() => {
     ...meRecsContract,
     ...meSavedContract,
     ...meSetsContract,
+    ...meFollowsContract,
     ...meWatchesContract,
     ...mixContract,
     ...mixtapesContract,
@@ -17883,6 +18107,22 @@ var init_publish = __esm(() => {
   init_api();
 });
 
+// src/commands/digests.ts
+async function sendFollowDigestsCommand(options) {
+  return adminApiPost("/api/v1/admin/follow-digests/send", options);
+}
+async function getFollowDigestStateCommand() {
+  const result = await adminApiGet("/api/v1/admin/follow-digests/state");
+  return result.paused;
+}
+async function setFollowDigestStateCommand(paused) {
+  const result = await adminApiPut("/api/v1/admin/follow-digests/state", { paused });
+  return result.paused;
+}
+var init_digests = __esm(() => {
+  init_api();
+});
+
 // src/commands/capture.ts
 async function captureBudgetCommand() {
   return adminApiGet("/api/v1/admin/catalogue/capture-budget");
@@ -21816,7 +22056,7 @@ function artistRuleLines(rules) {
 }
 function createProgram() {
   const program = configureCommand(new Command);
-  program.name("fluncle").description(fluncleTagline.toLowerCase()).option("--env <local|production>", "Config profile to load (default: production)").showSuggestionAfterError(false).addHelpCommand("help [command]", "display help for command").hook("preAction", (_thisCommand, actionCommand) => {
+  program.name("fluncle").description(fluncleTagline).option("--env <local|production>", "Config profile to load (default: production)").showSuggestionAfterError(false).addHelpCommand("help [command]", "Display help for command").hook("preAction", (_thisCommand, actionCommand) => {
     const options = actionCommand.optsWithGlobals();
     setEnvProfile(options.env);
   }).addHelpText("before", `
@@ -21857,7 +22097,7 @@ async function main(args = process.argv.slice(2)) {
   await notifyIfUpdateAvailable(args);
 }
 function configureCommand(command) {
-  return command.exitOverride().addHelpCommand(false).configureOutput({
+  return command.exitOverride().helpOption("-h, --help", "Display help for command").addHelpCommand(false).configureOutput({
     writeErr: () => {}
   });
 }
@@ -21906,7 +22146,7 @@ function addListenCommands(program) {
     const openCommands = await Promise.resolve().then(() => (init_open(), exports_open));
     await runOpen(target, [], options, openCommands);
   });
-  program.command("random").description("The archive throws one back").option("--json", "Print JSON", false).action(async (options) => {
+  program.command("random").description("The archive throws a banger back").option("--json", "Print JSON", false).action(async (options) => {
     await Promise.resolve().then(() => init_random());
     await runRandom(options, randomCommand);
   });
@@ -21968,7 +22208,7 @@ function addAdminCommands(program) {
   admin.action(() => {
     admin.outputHelp();
   });
-  admin.command("help", { hidden: true }).description("display help for command").action(() => {
+  admin.command("help", { hidden: true }).description("Display help for command").action(() => {
     admin.outputHelp();
   });
   admin.command("queue").description("The attention queue: what's waiting, and the day's dispatch").option("--json", "Print JSON", false).action(async (options) => {
@@ -22441,6 +22681,44 @@ JSON field reference:
     await Promise.resolve().then(() => init_publish());
     await runPublishAdvancePause(false, options, publishAdvancePauseCommand);
   });
+  const adminFollowDigests = configureCommand(admin.command("digests").description("Weekly email digest for followed artists and labels"));
+  adminFollowDigests.action(() => adminFollowDigests.outputHelp());
+  adminFollowDigests.command("status").description("Read the follow digest kill switch").option("--json", "Print JSON", false).action(async (options) => {
+    await Promise.resolve().then(() => init_digests());
+    const paused = await getFollowDigestStateCommand();
+    if (options.json) {
+      printJson({ ok: true, paused });
+    } else {
+      console.log(paused ? "Follow digests are paused." : "Follow digests are running.");
+    }
+  });
+  for (const [verb, paused] of [
+    ["pause", true],
+    ["resume", false]
+  ]) {
+    adminFollowDigests.command(verb).description(paused ? "Pause follow digests" : "Resume follow digests").option("--json", "Print JSON", false).action(async (options) => {
+      await Promise.resolve().then(() => init_digests());
+      const result = await setFollowDigestStateCommand(paused);
+      if (options.json) {
+        printJson({ ok: true, paused: result });
+      } else {
+        console.log(result ? "Follow digests are paused." : "Follow digests are running.");
+      }
+    });
+  }
+  adminFollowDigests.command("send").description("Send one bounded follow digest batch").option("--cursor <id>", "Continue after this user id").option("--limit <number>", "Maximum users to consider").option("--dry-run", "Count eligible emails without sending").option("--json", "Print JSON", false).action(async (options) => {
+    await Promise.resolve().then(() => init_digests());
+    const result = await sendFollowDigestsCommand({
+      cursor: options.cursor,
+      dryRun: options.dryRun,
+      limit: options.limit === undefined ? undefined : Number(options.limit)
+    });
+    if (options.json) {
+      printJson(result);
+    } else {
+      console.log(`Considered ${result.considered}; sent ${result.sent}; empty ${result.empty}; next ${result.nextCursor ?? "done"}.`);
+    }
+  });
   const adminCapture = configureCommand(admin.command("capture").description("The metered audio-capture budget and its kill switch"));
   adminCapture.action(() => {
     adminCapture.outputHelp();
@@ -26243,7 +26521,7 @@ Listen:
   fluncle open [--limit 20] [--browser|--app]   Pick a track, open it in Spotify
   fluncle open playlist [--browser|--app]       Open Fluncle's Findings in Spotify
   fluncle open telegram [--browser|--app]       Open the Telegram feed
-  fluncle random [--json]                       The archive throws one back
+  fluncle random [--json]                       The archive throws a banger back
   fluncle subscribe [email]                     Fresh bangers, every Friday
 
 Browse:

package/package.json

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