fluncle 0.109.0 → 0.110.0

package/bin/fluncle.mjs

@@ -557,7 +557,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.109.0".trim() ? "0.109.0".trim() : "0.1.0";
+  currentVersion = "0.110.0".trim() ? "0.110.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2207,7 +2207,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.109.0".trim() ? "0.109.0".trim() : "0.1.0";
+  currentVersion2 = "0.110.0".trim() ? "0.110.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2679,7 +2679,7 @@ var init_src = __esm(() => {
     {
       command: "ssh rave.fluncle.com",
       exposedContent: [
-        "the rave terminal TUI: Enter the Galaxy, Latest bangers, Mixtape archive, Submit, Subscribe, Install CLI, About",
+        "the rave terminal TUI: Latest bangers, Mixtape archive, Submit, Subscribe, Install CLI, About",
         "deep-register one-shots: `ssh rave.fluncle.com latest|random`"
       ],
       kind: "ssh",
@@ -2797,7 +2797,7 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.embed",
-      operatorNotes: "every 5m. On-box MuQ (torch, ~16s/track), zero LLM tokens. Writes the vector via the agent-tier update_track. Source: docs/agents/hermes/scripts/embed-sweep.* + embed-track.py. See docs/rfcs/audio-embedding-rfc.md.",
+      operatorNotes: "every 5m. On-box MuQ (torch, ~16s/track), zero LLM tokens. Writes the vector via the agent-tier update_track. Source: docs/agents/hermes/scripts/embed-sweep.* + embed-track.py. See docs/track-lifecycle.md.",
       probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-embed", kind: "cron" },
       weights: { status: "hidden" }
     },
@@ -2808,7 +2808,7 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.capture",
-      operatorNotes: "every 5m, run by a rave-02 HOST systemd timer (docs/agents/hermes/capture-timer/) — NOT a gateway cron: a proxied yt-dlp fetch has an unbounded tail that would starve the 5-min enrich/context/note sweeps on the shared serial runner. A NON-BLOCKING side-channel (never gates enrich/embed). Runs yt-dlp through a residential proxy on a per-track sticky session, duration-guards the match, stores the full song in the PRIVATE fluncle-source-audio bucket (S3-direct), and writes back via the agent-tier update_track (with per-finding backoff). yt-dlp + ffprobe are a box deploy prereq. Newest-first so a fresh add jumps the backfill. Source: docs/agents/hermes/scripts/capture-sweep.*. See docs/rfcs/full-audio-rfc.md § Unit 1.",
+      operatorNotes: "every 5m, run by a rave-02 HOST systemd timer (docs/agents/hermes/capture-timer/) — NOT a gateway cron: a proxied yt-dlp fetch has an unbounded tail that would starve the 5-min enrich/context/note sweeps on the shared serial runner. A NON-BLOCKING side-channel (never gates enrich/embed). Runs yt-dlp through a residential proxy on a per-track sticky session, duration-guards the match, stores the full song in the PRIVATE fluncle-source-audio bucket (S3-direct), and writes back via the agent-tier update_track (with per-finding backoff). yt-dlp + ffprobe are a box deploy prereq. Newest-first so a fresh add jumps the backfill. Source: docs/agents/hermes/scripts/capture-sweep.*. See docs/track-lifecycle.md.",
       probeConfig: { cadenceMs: 5 * MINUTE_MS, cronName: "fluncle-capture", kind: "cron" },
       weights: { status: "hidden" }
     },
@@ -5013,6 +5013,26 @@ var init_admin_artists = __esm(() => {
   init_api();
 });
 
+// src/commands/preview-migration.ts
+var exports_preview_migration = {};
+__export(exports_preview_migration, {
+  migratePreviewArchiveCommand: () => migratePreviewArchiveCommand
+});
+async function migratePreviewArchiveCommand(args) {
+  const params = new URLSearchParams({
+    dryRun: String(args.dryRun),
+    limit: String(args.limit),
+    mode: args.mode
+  });
+  if (args.cursor) {
+    params.set("cursor", args.cursor);
+  }
+  return adminApiPost(`/api/admin/migrations/preview-archive?${params.toString()}`);
+}
+var init_preview_migration = __esm(() => {
+  init_api();
+});
+
 // src/interactive.ts
 var exports_interactive = {};
 __export(exports_interactive, {
@@ -7844,6 +7864,14 @@ function addAdminCommands(program2) {
     const { resolveArtistCommand: resolveArtistCommand2 } = await Promise.resolve().then(() => (init_admin_artists(), exports_admin_artists));
     await runArtistResolve(artistId, options, resolveArtistCommand2);
   });
+  const migrations = configureCommand(admin.command("migrations").description("One-off operator data migrations"));
+  migrations.action(() => {
+    migrations.outputHelp();
+  });
+  migrations.command("preview-archive").description("Move archived 30s previews from the public bucket to the private one (REF-05)").option("--execute", "Actually perform the migration (default is a dry run)", false).option("--delete-public", "Delete phase: sweep the whole public analysis/previews/ prefix (run only after a full copy)", false).option("--verify", "Read-only: count the objects still under the public analysis/previews/ prefix", false).option("--limit <limit>", "Max findings/objects to process per pass", "50").option("--json", "Print JSON", false).action(async (options) => {
+    const { migratePreviewArchiveCommand: migratePreviewArchiveCommand2 } = await Promise.resolve().then(() => (init_preview_migration(), exports_preview_migration));
+    await runMigratePreviewArchive(options, migratePreviewArchiveCommand2);
+  });
 }
 async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCommand2) {
   if (!idOrLogId || !options.file || !options.source || !options.mime) {
@@ -7936,6 +7964,88 @@ async function runTrackNote(idOrLogId, options, trackNoteCommand2) {
   console.log(`Authored the note for ${result.logId}:`);
   console.log(`  ${result.note}`);
 }
+async function runMigratePreviewArchive(options, migratePreviewArchiveCommand2) {
+  const limit = options.limit === undefined ? 50 : Number.parseInt(options.limit, 10);
+  if (!Number.isInteger(limit) || limit < 1) {
+    throw new Error("Limit must be a positive integer");
+  }
+  const mode = options.verify ? "verify" : options.deletePublic ? "delete" : "copy";
+  const dryRun = mode === "verify" ? true : !options.execute;
+  if (mode === "verify") {
+    const result = await migratePreviewArchiveCommand2({ dryRun: true, limit, mode });
+    if (options.json) {
+      printJson({ mode, ok: true, remaining: result.remaining, sampleKeys: result.sampleKeys });
+      return;
+    }
+    console.log(`${result.remaining} object(s) remain under the public analysis/previews/ prefix.`);
+    for (const key of result.sampleKeys) {
+      console.log(`  ${key}`);
+    }
+    return;
+  }
+  const copied = [];
+  const deleted = [];
+  const skipped = [];
+  const failed = [];
+  let cursor;
+  let remaining = 0;
+  let blocked = null;
+  for (;; ) {
+    const result = await migratePreviewArchiveCommand2({ cursor, dryRun, limit, mode });
+    if (result.blocked) {
+      blocked = result.blocked;
+      remaining = result.remaining;
+      break;
+    }
+    copied.push(...result.copied);
+    deleted.push(...result.deleted);
+    skipped.push(...result.skipped);
+    failed.push(...result.failed);
+    remaining = result.remaining;
+    if (!options.json) {
+      const verb = dryRun ? "would" : "did";
+      console.log(`  \u2026${mode} pass (${verb}): +${result.copiedCount} copied, +${result.deletedCount} deleted, ${result.skippedCount} skipped, ${result.failedCount} failed; ${result.remaining} remaining`);
+    }
+    if (result.nextCursor === null) {
+      break;
+    }
+    cursor = result.nextCursor;
+  }
+  if (options.json) {
+    printJson({
+      blocked,
+      copied,
+      copiedCount: copied.length,
+      deleted,
+      deletedCount: deleted.length,
+      dryRun,
+      failed,
+      failedCount: failed.length,
+      mode,
+      ok: true,
+      remaining,
+      skipped,
+      skippedCount: skipped.length
+    });
+    return;
+  }
+  if (blocked) {
+    console.log(`REFUSED (${blocked}): ${remaining} legacy row(s) still need copying first.`);
+    return;
+  }
+  const done = mode === "delete" ? deleted.length : copied.length;
+  const noun = mode === "delete" ? "public object(s) deleted" : "preview(s) copied to the private bucket";
+  const prefix = dryRun ? "DRY RUN \u2014 would have: " : "";
+  console.log(`${prefix}${done} ${noun}; ${skipped.length} skipped; ${failed.length} failed; ${remaining} still under the prefix.`);
+  for (const item of skipped) {
+    if (item.reason === "private_copy_absent") {
+      console.log(`  LEFT (no private copy) ${item.trackId}`);
+    }
+  }
+  for (const item of failed) {
+    console.log(`  FAILED ${item.trackId}: ${item.error}`);
+  }
+}
 async function runPreviewArchiveBackfill(options, previewArchiveBackfillCommand2) {
   const limit = options.limit === undefined ? undefined : Number.parseInt(options.limit, 10);
   if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {

package/package.json

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