fluncle 0.252.0 → 0.254.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.252.0".trim() ? "0.252.0".trim() : "0.1.0";
+  currentVersion = "0.254.0".trim() ? "0.254.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -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.252.0".trim() ? "0.252.0".trim() : "0.1.0";
+  currentVersion2 = "0.254.0".trim() ? "0.254.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -4309,6 +4309,15 @@ async function trackRequeueVideoCommand(idOrLogId) {
 async function trackPurgeVideoCommand(idOrLogId) {
   return adminApiPost(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/video/purge`);
 }
+async function trackPinSourceCommand(idOrLogId, youtube, options = {}) {
+  return adminApiPut(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/capture-source`, {
+    ...options.allowDurationMismatch === true ? { allowDurationMismatch: true } : {},
+    youtubeVideoId: youtube
+  });
+}
+async function trackClearSourcePinCommand(idOrLogId) {
+  return adminApiDelete(`/api/v1/admin/tracks/${encodeURIComponent(idOrLogId)}/capture-source`);
+}
 async function trackObserveCommand(idOrLogId, options) {
   const body = { script: options.script };
   if (options.voiceId !== undefined) {
@@ -11644,6 +11653,7 @@ var init_admin_catalogue = __esm(() => {
     action: _enum([
       "flagged-finding",
       "not-captured",
+      "operator-verified",
       "preview-match",
       "quarantined-catalogue",
       "unverified"
@@ -14722,7 +14732,7 @@ var init_admin_tokens = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-tracks.ts
-var UpdateTrackBodySchema, ObserveTrackBodySchema, ContextTrackBodySchema, NoteTrackBodySchema, NoteEchoSchema, PresignVideoUploadsBodySchema, FinalizeVideoBodySchema, VideoUploadSchema, updateTrack, CaptureReconciliationKindSchema, CaptureExternalResultSchema, CaptureReceiptCoordinatesSchema, CapturePreparedTrackSchema, CaptureCommittedReceiptResultSchema, CaptureRejectedReceiptResultSchema, prepareTrackCapture, authorizeTrackCapture, commitTrackCapture, MAX_CAPTURE_PREPARE_BATCH = 12, MAX_CAPTURE_COMMIT_BATCH = 6, MAX_EMBEDDING_WRITE_BATCH = 6, EMBEDDING_DIMENSIONS = 1024, TrackWorkCapabilitiesSchema, ItemElapsedMsSchema, CapturePreparedItemSchema, prepareTrackCaptures, CaptureCommitReceiptSchema, commitTrackCaptures, updateTrackEmbeddings, observeTrack, contextTrack, noteTrack, presignTrackVideoUploads, finalizeTrackVideo, requeueVideo, purgeVideo, PublishTrackResultSchema, getTrackAdmin, listTracksAdmin, TrackWorkKindSchema, TrackWorkScopeSchema, TrackWorkItemSchema, listTrackWork, publishTrack, MixOrderStopSchema, getMixableOrder, adminTracksContract;
+var UpdateTrackBodySchema, ObserveTrackBodySchema, ContextTrackBodySchema, NoteTrackBodySchema, NoteEchoSchema, PresignVideoUploadsBodySchema, FinalizeVideoBodySchema, VideoUploadSchema, updateTrack, CaptureReconciliationKindSchema, CaptureExternalResultSchema, CaptureReceiptCoordinatesSchema, CapturePreparedTrackSchema, CaptureCommittedReceiptResultSchema, CaptureRejectedReceiptResultSchema, prepareTrackCapture, authorizeTrackCapture, commitTrackCapture, MAX_CAPTURE_PREPARE_BATCH = 12, MAX_CAPTURE_COMMIT_BATCH = 6, MAX_EMBEDDING_WRITE_BATCH = 6, EMBEDDING_DIMENSIONS = 1024, TrackWorkCapabilitiesSchema, ItemElapsedMsSchema, CapturePreparedItemSchema, prepareTrackCaptures, CaptureCommitReceiptSchema, commitTrackCaptures, updateTrackEmbeddings, observeTrack, contextTrack, noteTrack, presignTrackVideoUploads, finalizeTrackVideo, requeueVideo, purgeVideo, CaptureSourcePinResultSchema, pinCaptureSource, clearCaptureSource, PublishTrackResultSchema, getTrackAdmin, listTracksAdmin, TrackWorkKindSchema, TrackWorkScopeSchema, TrackWorkItemSchema, listTrackWork, publishTrack, MixOrderStopSchema, getMixableOrder, adminTracksContract;
 var init_admin_tracks = __esm(() => {
   init_dist3();
   init_zod();
@@ -14828,7 +14838,12 @@ var init_admin_tracks = __esm(() => {
       strictObject({
         attemptedAt: string2().datetime({ offset: true }),
         bytes: number2().int().min(1),
-        captureVerification: _enum(["preview-match", "unverified"]),
+        captureVerification: _enum([
+          "consensus-verified",
+          "operator-verified",
+          "preview-match",
+          "unverified"
+        ]),
         capturedAt: string2().datetime({ offset: true }),
         kind: literal("capture"),
         outcome: literal("done"),
@@ -14868,6 +14883,8 @@ var init_admin_tracks = __esm(() => {
     anchored: boolean2().optional(),
     artists: array(string2().max(512)).max(64),
     bpm: number2().optional(),
+    captureSourcePin: string2().max(64).optional(),
+    captureSourcePinAllowDuration: boolean2().optional(),
     certified: boolean2(),
     durationMs: number2().int().min(1).optional(),
     label: string2().max(1024).optional(),
@@ -15154,6 +15171,32 @@ var init_admin_tracks = __esm(() => {
     ok: literal(true),
     trackId: string2()
   }));
+  CaptureSourcePinResultSchema = object({
+    captureSourcePin: string2().nullable(),
+    captureSourcePinAllowDuration: boolean2(),
+    captureStatus: string2(),
+    logId: string2().nullable(),
+    ok: literal(true),
+    trackId: string2()
+  }).meta({ id: "CaptureSourcePinResult" });
+  pinCaptureSource = oc.route({
+    method: "PUT",
+    operationId: "pinCaptureSource",
+    path: "/admin/tracks/{trackId}/capture-source",
+    summary: "Pin the YouTube upload the capture sweep must download for a track",
+    tags: ["Admin"]
+  }).input(object({
+    allowDurationMismatch: boolean2().optional(),
+    trackId: string2(),
+    youtubeVideoId: string2().min(1).max(2048)
+  })).output(CaptureSourcePinResultSchema);
+  clearCaptureSource = oc.route({
+    method: "DELETE",
+    operationId: "clearCaptureSource",
+    path: "/admin/tracks/{trackId}/capture-source",
+    summary: "Clear a track's pinned capture source (the ladder runs again)",
+    tags: ["Admin"]
+  }).input(object({ trackId: string2() })).output(CaptureSourcePinResultSchema);
   PublishTrackResultSchema = object({
     addedToSpotify: boolean2(),
     dryRun: boolean2(),
@@ -15231,6 +15274,8 @@ var init_admin_tracks = __esm(() => {
     artists: array(string2()),
     bpm: number2().optional(),
     capturePriority: number2().nullable(),
+    captureSourcePin: string2().optional(),
+    captureSourcePinAllowDuration: boolean2().optional(),
     certified: boolean2(),
     deezerQuery: string2().optional(),
     durationMs: number2(),
@@ -15297,6 +15342,7 @@ var init_admin_tracks = __esm(() => {
   }));
   adminTracksContract = {
     authorize_track_capture: authorizeTrackCapture,
+    clear_capture_source: clearCaptureSource,
     commit_track_capture: commitTrackCapture,
     commit_track_captures: commitTrackCaptures,
     context_track: contextTrack,
@@ -15307,6 +15353,7 @@ var init_admin_tracks = __esm(() => {
     list_tracks_admin: listTracksAdmin,
     note_track: noteTrack,
     observe_track: observeTrack,
+    pin_capture_source: pinCaptureSource,
     prepare_track_capture: prepareTrackCapture,
     prepare_track_captures: prepareTrackCaptures,
     presign_track_video_uploads: presignTrackVideoUploads,
@@ -22183,6 +22230,13 @@ JSON field reference:
     await Promise.resolve().then(() => init_track());
     await runTrackPurgeVideo(idOrLogId, options, trackPurgeVideoCommand);
   });
+  adminTrack.command("pin-source").description("Pin the YouTube upload the capture sweep must download for a track (operator); --clear withdraws it").argument("[idOrLogId]").option("--allow-duration-mismatch", "Waive the duration guard for this pin: a deliberately chosen different edit of the same recording (the finding keeps its store length)", false).option("--clear", "Withdraw the pin (capture status and captured audio stay as they are)", false).option("--json", "Print JSON", false).option("--upload <url|id>", "The YouTube upload: a bare 11-char video id or a youtube.com / youtu.be URL").allowExcessArguments().action(async (idOrLogId, options) => {
+    await Promise.resolve().then(() => init_track());
+    await runTrackPinSource(idOrLogId, options, {
+      clear: trackClearSourcePinCommand,
+      pin: trackPinSourceCommand
+    });
+  });
   adminTrack.command("draft").description("Push the video to a platform as a draft").argument("[idOrLogId]").option("--json", "Print JSON", false).option("--platform <platform>", "Publishing platform").allowExcessArguments().action(async (idOrLogId, options) => {
     await Promise.resolve().then(() => init_track());
     await runTrackDraft(idOrLogId, options, trackDraftCommand);
@@ -24550,6 +24604,32 @@ async function runTrackRequeueVideo(idOrLogId, options, trackRequeueVideoCommand
   }
   console.log(result.alreadyClear ? `${result.logId} already had no video. Nothing to clear.` : `Cleared the video for ${result.logId}. It's back on the render queue (and off radio until re-rendered).`);
 }
+async function runTrackPinSource(idOrLogId, options, commands) {
+  const usage = "Usage: fluncle admin tracks pin-source <track_id|log_id> --upload <url|id> [--allow-duration-mismatch] [--json] | --clear";
+  if (!idOrLogId) {
+    throw new Error(`Missing id. ${usage}`);
+  }
+  const youtube = options.upload?.trim();
+  if (options.clear && youtube) {
+    throw new Error(`Pass either --upload or --clear, not both. ${usage}`);
+  }
+  if (!options.clear && !youtube) {
+    throw new Error(`Missing --upload <url|id> (or --clear to withdraw the pin). ${usage}`);
+  }
+  if (options.clear && options.allowDurationMismatch) {
+    throw new Error(`--allow-duration-mismatch rides a pin, not --clear. ${usage}`);
+  }
+  const result = options.clear ? await commands.clear(idOrLogId) : await commands.pin(idOrLogId, youtube ?? "", {
+    allowDurationMismatch: options.allowDurationMismatch
+  });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  const who = result.logId ?? result.trackId;
+  const guard = result.captureSourcePinAllowDuration ? "any length accepted" : "duration guard applies";
+  console.log(result.captureSourcePin ? `Pinned ${who} to youtube ${result.captureSourcePin} \u2014 capture ${result.captureStatus.toUpperCase()}; the next capture tick downloads that upload, ladder skipped, ${guard}.` : `Cleared the capture-source pin on ${who} \u2014 capture ${result.captureStatus.toUpperCase()} untouched; the ladder runs again.`);
+}
 async function runTrackPurgeVideo(idOrLogId, options, trackPurgeVideoCommand) {
   if (!idOrLogId) {
     throw new Error("Missing id. Usage: fluncle admin tracks purge-video <track_id|log_id>");
@@ -26008,6 +26088,7 @@ var stringOptions = new Set([
   "--wall-ms",
   "--window-since",
   "--window-until",
+  "--upload",
   "--work-kind"
 ]);
 var rootHelpSections = `

package/package.json

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