fluncle 0.110.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.110.0".trim() ? "0.110.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.110.0".trim() ? "0.110.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",
@@ -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
@@ -7611,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);
@@ -7620,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));
@@ -8437,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>");
   }
@@ -8445,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
@@ -8979,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);
@@ -9203,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",
@@ -9218,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.110.0"
+  "version": "0.111.0"
 }