fluncle 0.109.0 → 0.111.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.111.0".trim() ? "0.111.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -961,6 +961,7 @@ function mapTrack(track) {
     addedToSpotify: track.addedToSpotify,
     album: track.album,
     albumImageUrl: track.albumImageUrl,
+    analyzedFrom: track.analyzedFrom,
     artists: track.artists,
     bpm: track.bpm,
     durationMs: track.durationMs,
@@ -1673,6 +1674,7 @@ function mapTrack2(track) {
     addedToSpotify: track.addedToSpotify,
     album: track.album,
     albumImageUrl: track.albumImageUrl,
+    analyzedFrom: track.analyzedFrom,
     artists: track.artists,
     bpm: track.bpm,
     durationMs: track.durationMs,
@@ -2207,7 +2209,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.111.0".trim() ? "0.111.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2650,11 +2652,26 @@ var init_src = __esm(() => {
       url: `${SITE}/.well-known/agent-skills/index.json`,
       weights: { web: "tertiary" }
     },
+    {
+      apiFormat: "application/json+oembed",
+      exposedContent: [
+        "the oEmbed 1.0 provider — a pasted /log, /mixtapes, or /artist link unfurls as a rich finding card (Discord/Notion/WordPress/Ghost/…)",
+        "html iframes the self-contained /embed/<logId> card; thumbnail is the finding's OG image"
+      ],
+      kind: "discovery",
+      name: "discovery.oembed",
+      operatorNotes: 'GET /oembed?url=<a fluncle.com /log|/mixtapes|/artist URL>&format=json. Discovered via the `<link rel="alternate" type="application/json+oembed">` on the /log, mixtape, and /artist heads. XML → 501 (JSON only). No probeConfig — a bare GET without a valid `url` param is a 404, so there is no fixed URL to health-probe (like web.artist). The `rich` html frames /embed/<logId> (apps/web/src/routes/embed.$logId.ts), a standalone dark card served with a permissive `frame-ancestors *` CSP scoped to that route. Source: apps/web/src/routes/oembed.ts + src/lib/oembed.ts.',
+      route: "/oembed",
+      url: `${SITE}/oembed`,
+      weights: { web: "tertiary" }
+    },
     {
       apiFormat: "application/json",
       discoveryUrl: `${SITE}/.well-known/mcp/server-card.json`,
       exposedContent: [
-        "the archive as MCP tools (Streamable HTTP, no auth): list_tracks, get_random_track, get_status, search_tracks, submit_track, subscribe_newsletter"
+        "the archive as MCP tools (Streamable HTTP, no auth): list_tracks, get_track, get_random_track, get_status, search_tracks, submit_track, subscribe_newsletter",
+        "the archive as MCP resources: each finding/mixtape at fluncle://finding/<logId> or fluncle://mixtape/<logId> (its public record)",
+        "Fluncle-voiced MCP prompts: recommend_finding, walk_recent_night, decode_coordinate"
       ],
       kind: "mcp",
       name: "mcp.server",
@@ -2679,7 +2696,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 +2814,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 +2825,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" }
     },
@@ -3216,6 +3233,24 @@ async function trackUpdateCommand(trackId, options) {
   if (options.note !== undefined) {
     body.note = options.note;
   }
+  if (options.bpmSource !== undefined) {
+    body.bpmSource = options.bpmSource;
+  }
+  if (options.bpmConfidence !== undefined) {
+    body.bpmConfidence = options.bpmConfidence;
+  }
+  if (options.keySource !== undefined) {
+    body.keySource = options.keySource;
+  }
+  if (options.keyConfidence !== undefined) {
+    body.keyConfidence = options.keyConfidence;
+  }
+  if (options.analyzedFrom !== undefined) {
+    body.analyzedFrom = options.analyzedFrom;
+  }
+  if (options.analyzedAt !== undefined) {
+    body.analyzedAt = options.analyzedAt;
+  }
   return adminApiPatch(`/api/admin/tracks/${encodeURIComponent(trackId)}`, body);
 }
 async function trackRequeueVideoCommand(idOrLogId) {
@@ -3326,10 +3361,60 @@ var init_add = __esm(() => {
   init_api();
 });
 
+// src/commands/track.ts
+async function trackUpdateCommand2(trackId, options) {
+  const body = {};
+  if (options.bpm !== undefined) {
+    body.bpm = options.bpm;
+  }
+  if (options.key !== undefined) {
+    body.key = options.key;
+  }
+  if (options.videoUrl !== undefined) {
+    body.videoUrl = options.videoUrl;
+  }
+  if (options.status !== undefined) {
+    body.enrichmentStatus = options.status;
+  }
+  if (options.features !== undefined) {
+    body.features = options.features;
+  }
+  if (options.embedding !== undefined) {
+    body.embedding = options.embedding;
+  }
+  if (options.note !== undefined) {
+    body.note = options.note;
+  }
+  if (options.bpmSource !== undefined) {
+    body.bpmSource = options.bpmSource;
+  }
+  if (options.bpmConfidence !== undefined) {
+    body.bpmConfidence = options.bpmConfidence;
+  }
+  if (options.keySource !== undefined) {
+    body.keySource = options.keySource;
+  }
+  if (options.keyConfidence !== undefined) {
+    body.keyConfidence = options.keyConfidence;
+  }
+  if (options.analyzedFrom !== undefined) {
+    body.analyzedFrom = options.analyzedFrom;
+  }
+  if (options.analyzedAt !== undefined) {
+    body.analyzedAt = options.analyzedAt;
+  }
+  return adminApiPatch(`/api/admin/tracks/${encodeURIComponent(trackId)}`, body);
+}
+var init_track2 = __esm(() => {
+  init_api();
+  init_output();
+});
+
 // src/commands/admin-tracks.ts
 var exports_admin_tracks = {};
 __export(exports_admin_tracks, {
   vehiclesCommand: () => vehiclesCommand,
+  requeueAnalysisCommand: () => requeueAnalysisCommand,
   queueCommand: () => queueCommand,
   observeQueueCommand: () => observeQueueCommand,
   noteQueueCommand: () => noteQueueCommand,
@@ -3429,6 +3514,44 @@ async function embedQueueCommand(limit) {
 async function captureQueueCommand(limit) {
   return fetchAdminTracks({ captureQueue: true, max: limit, order: "desc" });
 }
+async function requeueAnalysisCommand(options) {
+  const findings = await fetchAdminTracks({ max: options.max, order: "asc" });
+  const stale = findings.filter((track) => track.analyzedFrom !== "full");
+  const rows = stale.map((track) => ({
+    analyzedFrom: track.analyzedFrom,
+    bpm: track.bpm,
+    hasSourceAudio: Boolean(track.sourceAudioKey),
+    key: track.key,
+    logId: track.logId,
+    title: track.title,
+    trackId: track.trackId
+  }));
+  const withSourceAudio = rows.filter((row) => row.hasSourceAudio);
+  const withoutSourceAudio = rows.filter((row) => !row.hasSourceAudio);
+  const requeued = [];
+  const failed = [];
+  if (options.apply) {
+    for (const row of rows) {
+      try {
+        await trackUpdateCommand2(row.trackId, { status: "pending" });
+        requeued.push(row.trackId);
+      } catch (error) {
+        failed.push({
+          error: error instanceof Error ? error.message : String(error),
+          trackId: row.trackId
+        });
+      }
+    }
+  }
+  return {
+    applied: options.apply,
+    failed,
+    requeued,
+    scanned: findings.length,
+    withSourceAudio,
+    withoutSourceAudio
+  };
+}
 async function contextQueueCommand(limit, retryEmptyContext = false) {
   return fetchAdminTracks({ hasContext: false, max: limit, order: "asc", retryEmptyContext });
 }
@@ -3478,6 +3601,7 @@ var pageSize3 = 48;
 var init_admin_tracks = __esm(() => {
   init_api();
   init_recent2();
+  init_track2();
 });
 
 // src/commands/preview-archive.ts
@@ -5013,6 +5137,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, {
@@ -7591,6 +7735,10 @@ function addAdminCommands(program2) {
     const { captureQueueCommand: captureQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminCaptureQueue(options, captureQueueCommand2);
   });
+  adminTracks.command("requeue-analysis").description("Re-queue findings whose BPM/key are preview-grade (dry-run; --apply to flip)").option("--apply", "Actually flip statuses (default is a dry-run preview)", false).option("--limit <limit>", "Cap the archive walk (default: the whole archive)").option("--json", "Print JSON", false).action(async (options) => {
+    const { requeueAnalysisCommand: requeueAnalysisCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
+    await runAdminRequeueAnalysis(options, requeueAnalysisCommand2);
+  });
   adminTracks.command("vehicles").description("Recent video vehicles, newest first (the style ledger for diversity)").option("--limit <limit>", "Number of vehicles to show", "10").option("--json", "Print JSON", false).action(async (options) => {
     const { vehiclesCommand: vehiclesCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
     await runAdminVehicles(options, vehiclesCommand2);
@@ -7600,9 +7748,9 @@ function addAdminCommands(program2) {
     const { trackGetAdminCommand: trackGetAdminCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackGetAdmin(idOrLogId, options, trackGetAdminCommand2);
   });
-  adminTrack.command("update").description("Certify a track into the archive").argument("[trackId]").option("--bpm <number>", "Track BPM").option("--embedding <json>", "MuQ audio embedding as a JSON array of 1024 floats").option("--embedding-file <file>", "Read the MuQ embedding JSON array from a file").option("--features <json>", "Audio feature JSON").option("--json", "Print JSON", false).option("--key <key>", "Musical key").option("--note <text>", "Operator note").option("--status <status>", "Enrichment status").option("--video-url <url>", "Rendered video URL").allowExcessArguments().action(async (trackId, options) => {
-    const { trackUpdateCommand: trackUpdateCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
-    await runTrackUpdate(trackId, options, trackUpdateCommand2);
+  adminTrack.command("update").description("Certify a track into the archive").argument("[trackId]").option("--analyzed-at <iso>", "Analysis-write ISO timestamp (BPM/key provenance)").option("--analyzed-from <class>", "Audio class BPM/key were analyzed from: full or preview").option("--bpm <number>", "Track BPM").option("--bpm-confidence <number>", "Analyzer confidence in the BPM (0..1)").option("--bpm-source <source>", "Where the BPM came from (analyzer bpmSource)").option("--embedding <json>", "MuQ audio embedding as a JSON array of 1024 floats").option("--embedding-file <file>", "Read the MuQ embedding JSON array from a file").option("--features <json>", "Audio feature JSON").option("--json", "Print JSON", false).option("--key <key>", "Musical key").option("--key-confidence <number>", "Analyzer confidence in the key (0..1)").option("--key-source <source>", "Where the key came from (analyzer keySource)").option("--note <text>", "Operator note").option("--status <status>", "Enrichment status").option("--video-url <url>", "Rendered video URL").allowExcessArguments().action(async (trackId, options) => {
+    const { trackUpdateCommand: trackUpdateCommand3 } = await Promise.resolve().then(() => (init_track(), exports_track));
+    await runTrackUpdate(trackId, options, trackUpdateCommand3);
   });
   adminTrack.command("video").description("Upload a track's video bundle to R2 and link it").argument("[idOrLogId]").option("--allow-partial", "Allow an intentionally partial upload (skip the re-render-contract check; e.g. poster-only)", false).option("--composition <file>", "Composition source file").option("--cover <file>", "Cover image").option("--dir <dir>", "Bundle directory").option("--footage <file>", "Video footage (square crop source)").option("--footage-landscape <file>", "Clean landscape cut (optional escape hatch)").option("--footage-landscape-social <file>", "Landscape cut with baked text (optional)").option("--footage-notext <file>", "Portrait cut without the type layer (optional)").option("--footage-social <file>", "Portrait social cut (baked text)").option("--intent <file>", "Render-intent JSON (optional)").option("--json", "Print JSON", false).option("--metrics <file>", "Gate metrics JSON (optional)").option("--model <model>", "Authoring AI model (<provider>/<model>)").option("--note <file>", "Note file").option("--plate <file>", "Plate-lane photographic plate (plate.png; uploadable pre-render)").option("--plate-background <file>", "The plate's subject-removed background (plate.background.png, optional)").option("--poster <file>", "Poster image").option("--props <file>", "Render props JSON").option("--reasoning <level>", "Authoring model reasoning effort (e.g. high)").option("--render <file>", "Render metadata JSON").option("--scene <file>", "Scene replay manifest JSON (fluncle.scene/1, optional)").allowExcessArguments().action(async (idOrLogId, options) => {
     const { trackVideoCommand: trackVideoCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
@@ -7844,6 +7992,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 +8092,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)) {
@@ -8327,7 +8565,7 @@ function parseEmbeddingArg(raw) {
   }
   return parsed;
 }
-async function runTrackUpdate(trackId, options, trackUpdateCommand2) {
+async function runTrackUpdate(trackId, options, trackUpdateCommand3) {
   if (!trackId) {
     throw new Error("Missing track id. Usage: fluncle admin tracks update <track_id>");
   }
@@ -8335,13 +8573,30 @@ async function runTrackUpdate(trackId, options, trackUpdateCommand2) {
   if (bpm !== undefined && !Number.isFinite(bpm)) {
     throw new Error(`Invalid --bpm: ${options.bpm}`);
   }
+  const bpmConfidence = options.bpmConfidence === undefined ? undefined : Number(options.bpmConfidence);
+  if (bpmConfidence !== undefined && !Number.isFinite(bpmConfidence)) {
+    throw new Error(`Invalid --bpm-confidence: ${options.bpmConfidence}`);
+  }
+  const keyConfidence = options.keyConfidence === undefined ? undefined : Number(options.keyConfidence);
+  if (keyConfidence !== undefined && !Number.isFinite(keyConfidence)) {
+    throw new Error(`Invalid --key-confidence: ${options.keyConfidence}`);
+  }
+  if (options.analyzedFrom !== undefined && options.analyzedFrom !== "full" && options.analyzedFrom !== "preview") {
+    throw new Error(`Invalid --analyzed-from: ${options.analyzedFrom} (expected full or preview)`);
+  }
   const embeddingRaw = options.embeddingFile ? readFileSync5(options.embeddingFile, "utf8") : options.embedding;
   const embedding = parseEmbeddingArg(embeddingRaw);
-  const result = await trackUpdateCommand2(trackId, {
+  const result = await trackUpdateCommand3(trackId, {
+    analyzedAt: options.analyzedAt,
+    analyzedFrom: options.analyzedFrom,
     bpm,
+    bpmConfidence,
+    bpmSource: options.bpmSource,
     embedding,
     features: options.features,
     key: options.key,
+    keyConfidence,
+    keySource: options.keySource,
     note: options.note,
     status: options.status,
     videoUrl: options.videoUrl
@@ -8869,6 +9124,66 @@ async function runAdminCaptureQueue(options, captureQueueCommand2) {
   console.log(trackRows2(tracks).join(`
 `));
 }
+var REQUEUE_ANALYSIS_ARCHIVE_CAP = 1e6;
+function parseRequeueAnalysisLimit(value) {
+  if (value === undefined) {
+    return REQUEUE_ANALYSIS_ARCHIVE_CAP;
+  }
+  const limit = Number.parseInt(value, 10);
+  if (!Number.isInteger(limit) || limit < 1) {
+    throw new Error("Limit must be a positive integer");
+  }
+  return limit;
+}
+async function runAdminRequeueAnalysis(options, requeueAnalysisCommand2) {
+  const max = parseRequeueAnalysisLimit(options.limit);
+  const result = await requeueAnalysisCommand2({ apply: options.apply === true, max });
+  if (options.json) {
+    printJson({ ok: true, ...result });
+    return;
+  }
+  const { coordinate: coordinate3 } = await Promise.resolve().then(() => (init_format2(), exports_format));
+  const staleCount = result.withSourceAudio.length + result.withoutSourceAudio.length;
+  if (staleCount === 0) {
+    console.log("Nothing to re-queue. Every finding's BPM/key was analyzed from full audio.");
+    return;
+  }
+  const describe = (row) => {
+    const coord = coordinate3({ logId: row.logId });
+    const bpm = row.bpm ? `${row.bpm} bpm` : "no bpm";
+    const key = row.key ?? "no key";
+    const from = row.analyzedFrom ?? "legacy/null";
+    return `  ${coord}  ${row.trackId}  ${row.title} \u2014 ${bpm}, ${key} (from ${from})`;
+  };
+  console.log(`${staleCount} finding${staleCount === 1 ? "" : "s"} with preview-grade BPM/key (scanned ${result.scanned}):`);
+  if (result.withSourceAudio.length > 0) {
+    console.log(`
+Captured full song on file \u2014 re-derives from full audio (${result.withSourceAudio.length}):`);
+    console.log(result.withSourceAudio.map(describe).join(`
+`));
+  }
+  if (result.withoutSourceAudio.length > 0) {
+    console.log(`
+No captured full song \u2014 re-derives from the 30s preview, still an upgrade with the fixed estimator (${result.withoutSourceAudio.length}):`);
+    console.log(result.withoutSourceAudio.map(describe).join(`
+`));
+  }
+  console.log(`
+Caveat: keys backfilled from Rekordbox are indistinguishable from DSP keys (no legacy` + " provenance) and a re-enrichment may overwrite them. This dry-run diff is the gate \u2014" + " review it before applying.");
+  if (!result.applied) {
+    console.log(`
+Dry-run \u2014 nothing flipped. Re-run with --apply to re-queue all ${staleCount}.`);
+    return;
+  }
+  console.log(`
+Applied \u2014 re-queued ${result.requeued.length} of ${staleCount}.`);
+  if (result.failed.length > 0) {
+    console.log(`${result.failed.length} failed:`);
+    console.log(result.failed.map((entry) => `  ${entry.trackId}: ${entry.error}`).join(`
+`));
+    process.exitCode = 1;
+  }
+}
 async function runAdminVehicles(options, vehiclesCommand2) {
   const limit = parseListLimit(options.limit);
   const vehicles = await vehiclesCommand2(limit);
@@ -9093,7 +9408,11 @@ function normalizeCommanderError(error) {
   return new Error(message);
 }
 var stringOptions = new Set([
+  "--analyzed-at",
+  "--analyzed-from",
   "--bpm",
+  "--bpm-confidence",
+  "--bpm-source",
   "--composition",
   "--cover",
   "--dir",
@@ -9108,6 +9427,8 @@ var stringOptions = new Set([
   "--from",
   "--intent",
   "--key",
+  "--key-confidence",
+  "--key-source",
   "--limit",
   "--metrics",
   "--mime",

package/package.json

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