fluncle 0.240.0 → 0.242.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.240.0".trim() ? "0.240.0".trim() : "0.1.0";
+  currentVersion = "0.242.0".trim() ? "0.242.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.240.0".trim() ? "0.240.0".trim() : "0.1.0";
+  currentVersion2 = "0.242.0".trim() ? "0.242.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3967,7 +3967,7 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.funnel-snapshot",
-      operatorNotes: "23:45 UTC daily (end of the UTC day the snapshot is keyed on). A bare trigger (the reach/anchor shape): fires the AGENT-tier record_catalogue_snapshot op once — the Worker computes every stage total + queue depth + frontier count through the SAME predicates the sweeps run (lib/server/funnel.ts) and UPSERTS one idempotent row per UTC day (a same-day re-run overwrites, never doubles a bar). Zero LLM tokens; the box's agent token drives it and calls the oRPC HTTP endpoint directly (no new CLI command the pinned box CLI would lack), so no new secret. Source: docs/agents/hermes/scripts/funnel-snapshot-sweep.*. See docs/admin-shell.md.",
+      operatorNotes: "23:45 UTC daily (end of the UTC day the snapshot is keyed on), with a retry slot at 23:57 UTC still inside that day. A bare trigger (the reach/anchor shape): fires the AGENT-tier record_catalogue_snapshot op once — the Worker computes every stage total + queue depth + frontier count through the SAME predicates the sweeps run (lib/server/funnel.ts) and UPSERTS one idempotent row per UTC day (a same-day re-run overwrites, never doubles a bar). A missed day cannot be recomputed later, so the tick is defended three ways: an in-tick retry ladder for a transient Worker fault, the second timer slot for a database-admission yield, and the Worker's catch-up grace window for a box that slept through the slot (it fills a missing previous day and names it as backfilledDays). Zero LLM tokens; the box's agent token drives it and calls the oRPC HTTP endpoint directly (no new CLI command the pinned box CLI would lack), so no new secret. Source: docs/agents/hermes/scripts/funnel-snapshot-sweep.*. See docs/admin-shell.md.",
       probeConfig: {
         cadenceMs: 24 * 60 * MINUTE_MS,
         cronName: "fluncle-funnel-snapshot",
@@ -11435,7 +11435,7 @@ var init_admin_bios = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-catalogue.ts
-var CatalogueLensSchema, CapturePriorityReasonSchema, CatalogueMatchSchema, CatalogueTrackItemSchema, CatalogueSummarySchema, listCatalogueTracks, rankCatalogue, recordDemand, clearWrongAudio, requeueUnmatchedCaptures, requeueAnchor, requeueIsrcRecovery, flagWrongAudio, forceCapture, certifyTrack, setTrackDismissed, CaptureVerifyItemSchema, listUnverifiedCaptures, verifyCapture, CrawlPassSchema, CrawlPhaseInitializationSchema, MAX_CRAWL_PREPARE_LIMIT = 6, CrawlPhaseInputSchema, CrawlPhaseOutputSchema, CrawlStatusSchema, crawlCatalogue, getCrawlStatus, ANCHOR_CANDIDATE_LIMIT = 100, ANCHOR_ARTIST_LIMIT = 20, ANCHOR_TEXT_MAX = 300, ANCHOR_ISRC_MAX = 64, ANCHOR_ID_MAX = 64, ANCHOR_URL_MAX = 2048, AnchorCandidateSchema, anchorTrack, DEEZER_CANDIDATE_LIMIT = 5, DEEZER_TEXT_MAX = 300, DEEZER_ISRC_MAX = 64, DEEZER_TRACK_ID_MAX = 32, DeezerIsrcCandidateSchema, resolveAnchor, resolveAnchorReview, setAnchorSearch, setAnchorApify, CaptureBudgetStateSchema, getCaptureBudget, setCaptureBudget, SpotifyAnchorBreakerStateSchema, AnchorRungFlagsSchema, getSpotifyAnchorBreaker, resetSpotifyAnchorBreaker, AppleBreakerStateSchema, resetAppleBreaker, adminCatalogueContract;
+var CatalogueLensSchema, CapturePriorityReasonSchema, CatalogueMatchSchema, CatalogueTrackItemSchema, CatalogueSummarySchema, listCatalogueTracks, rankCatalogue, recordDemand, clearWrongAudio, requeueUnmatchedCaptures, requeueAnchor, requeueIsrcRecovery, flagWrongAudio, forceCapture, certifyTrack, setTrackDismissed, CaptureVerifyItemSchema, listUnverifiedCaptures, verifyCapture, CrawlPassSchema, CrawlPhaseInitializationSchema, MAX_CRAWL_PREPARE_LIMIT = 6, CrawlFetchPlanSchema, SuppliedCrawlBodySchema, MAX_CRAWL_COMMIT_BATCH, CRAWL_COMMIT_TOKEN_MAX_BYTES, CRAWL_COMMIT_BATCH_MAX_TOTAL_BYTES, CrawlCommitItemSchema, CrawlCommitReceiptSchema, CrawlPhaseCapabilitiesSchema, CrawlPhaseInputSchema, CrawlPhaseOutputSchema, CrawlStatusSchema, crawlCatalogue, commitCrawlNodes, getCrawlStatus, ANCHOR_CANDIDATE_LIMIT = 100, ANCHOR_ARTIST_LIMIT = 20, ANCHOR_TEXT_MAX = 300, ANCHOR_ISRC_MAX = 64, ANCHOR_ID_MAX = 64, ANCHOR_URL_MAX = 2048, AnchorCandidateSchema, anchorTrack, DEEZER_CANDIDATE_LIMIT = 5, DEEZER_TEXT_MAX = 300, DEEZER_ISRC_MAX = 64, DEEZER_TRACK_ID_MAX = 32, DeezerIsrcCandidateSchema, resolveAnchor, resolveAnchorReview, setAnchorSearch, setAnchorApify, CaptureBudgetStateSchema, getCaptureBudget, setCaptureBudget, SpotifyAnchorBreakerStateSchema, AnchorRungFlagsSchema, getSpotifyAnchorBreaker, resetSpotifyAnchorBreaker, AppleBreakerStateSchema, resetAppleBreaker, adminCatalogueContract;
 var init_admin_catalogue = __esm(() => {
   init_dist3();
   init_zod();
@@ -11677,6 +11677,53 @@ var init_admin_catalogue = __esm(() => {
     seeded: number2(),
     seedsRearmed: number2()
   });
+  CrawlFetchPlanSchema = discriminatedUnion("kind", [
+    object({ kind: literal("none") }),
+    object({ kind: literal("single"), url: string2().max(2048) }),
+    object({
+      countField: literal("release-count"),
+      kind: literal("tail"),
+      pageSize: number2().int().positive(),
+      pageUrlTemplate: string2().max(2048),
+      probeUrl: string2().max(2048)
+    })
+  ]);
+  SuppliedCrawlBodySchema = object({
+    body: json().optional(),
+    outcome: _enum(["body", "empty", "invalid", "oversize", "throttled"]),
+    url: string2().max(2048)
+  });
+  MAX_CRAWL_COMMIT_BATCH = MAX_CRAWL_PREPARE_LIMIT;
+  CRAWL_COMMIT_TOKEN_MAX_BYTES = 2 * 1024 * 1024;
+  CRAWL_COMMIT_BATCH_MAX_TOTAL_BYTES = 8 * 1024 * 1024;
+  CrawlCommitItemSchema = strictObject({
+    commitToken: string2().max(CRAWL_COMMIT_TOKEN_MAX_BYTES),
+    operationId: literal("catalogue.crawl"),
+    operationKey: string2().max(128),
+    requestDigest: string2().regex(/^[0-9a-f]{64}$/)
+  });
+  CrawlCommitReceiptSchema = object({
+    elapsedMs: number2().int().min(0).optional(),
+    error: string2().max(500).optional(),
+    operationKey: string2().max(128),
+    outcome: _enum([
+      "committed",
+      "conflict",
+      "failed",
+      "in-progress",
+      "lookup-failed",
+      "rejected",
+      "safely-retryable"
+    ]),
+    replayed: boolean2(),
+    result: json().optional(),
+    resultIdentity: string2().optional(),
+    state: _enum(["accepted", "committed", "rejected"]).optional()
+  }).meta({ id: "CrawlCommitReceipt" });
+  CrawlPhaseCapabilitiesSchema = strictObject({
+    commitBatchLimit: number2().int().min(1).max(MAX_CRAWL_COMMIT_BATCH),
+    commitBatchMaxTotalBytes: number2().int().min(1)
+  });
   CrawlPhaseInputSchema = discriminatedUnion("phase", [
     object({ phase: literal("initialize") }),
     object({
@@ -11684,7 +11731,11 @@ var init_admin_catalogue = __esm(() => {
       maxHop: number2().int().min(0).max(3).default(2),
       phase: literal("prepare")
     }),
-    object({ phase: literal("fetch"), preparedToken: string2().max(2 * 1024 * 1024) }),
+    object({
+      phase: literal("fetch"),
+      preparedToken: string2().max(2 * 1024 * 1024),
+      supplied: array(SuppliedCrawlBodySchema).max(2).optional()
+    }),
     object({
       commitToken: string2().max(2 * 1024 * 1024),
       operationId: literal("catalogue.crawl"),
@@ -11701,9 +11752,15 @@ var init_admin_catalogue = __esm(() => {
       phase: literal("initialize")
     }),
     object({
+      boxFetch: boolean2(),
+      capabilities: CrawlPhaseCapabilitiesSchema.optional(),
       frontierPending: number2(),
       initialization: CrawlPhaseInitializationSchema,
-      items: array(object({ nodeId: string2(), preparedToken: string2() })).max(MAX_CRAWL_PREPARE_LIMIT),
+      items: array(object({
+        fetchPlan: CrawlFetchPlanSchema,
+        nodeId: string2(),
+        preparedToken: string2()
+      })).max(MAX_CRAWL_PREPARE_LIMIT),
       kind: _enum(["drained", "prepared", "unavailable"]),
       ok: literal(true),
       phase: literal("prepare")
@@ -11714,6 +11771,7 @@ var init_admin_catalogue = __esm(() => {
       operationId: literal("catalogue.crawl"),
       operationKey: string2(),
       phase: literal("fetch"),
+      rateLimited: boolean2().optional(),
       requestDigest: string2()
     }),
     object({
@@ -11751,7 +11809,9 @@ var init_admin_catalogue = __esm(() => {
     }),
     labelsUndecided: number2(),
     seedLabels: array(string2()),
-    storablePending: number2()
+    storablePending: number2(),
+    undecidedLabelsQueued: number2(),
+    unstorablePending: number2()
   }).meta({ id: "CrawlStatus" });
   crawlCatalogue = oc.route({
     inputStructure: "detailed",
@@ -11768,6 +11828,19 @@ var init_admin_catalogue = __esm(() => {
       maxHop: string2().optional()
     })
   })).output(union([CrawlPassSchema.extend({ ok: literal(true) }), CrawlPhaseOutputSchema]));
+  commitCrawlNodes = oc.route({
+    method: "POST",
+    operationId: "commitCrawlNodes",
+    path: "/admin/catalogue/crawl/commits",
+    summary: "Commit one claim's fetched crawl nodes in a single admitted phase",
+    tags: ["Admin"]
+  }).input(strictObject({
+    items: array(CrawlCommitItemSchema).min(1).max(MAX_CRAWL_COMMIT_BATCH)
+  })).output(strictObject({
+    deferred: number2().int().min(0),
+    ok: literal(true),
+    receipts: array(CrawlCommitReceiptSchema).max(MAX_CRAWL_COMMIT_BATCH)
+  }));
   getCrawlStatus = oc.route({
     method: "GET",
     operationId: "getCrawlStatus",
@@ -11947,6 +12020,7 @@ var init_admin_catalogue = __esm(() => {
     anchor_track: anchorTrack,
     certify_track: certifyTrack,
     clear_wrong_audio: clearWrongAudio,
+    commit_crawl_nodes: commitCrawlNodes,
     crawl_catalogue: crawlCatalogue,
     flag_wrong_audio: flagWrongAudio,
     force_capture: forceCapture,
@@ -13118,7 +13192,7 @@ var init_admin_frontier = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-funnel.ts
-var FunnelStagesSchema, FunnelQueuesSchema, FunnelLiveQueuesSchema, PublicSurfaceCountsSchema, FunnelMetersSchema, CatalogueSnapshotRowSchema, recordCatalogueSnapshot, getFunnel, adminFunnelContract;
+var FunnelStagesSchema, FunnelQueuesSchema, FunnelLiveQueuesSchema, PublicSurfaceCountsSchema, CaptureBacklogSchema, FunnelMetersSchema, CatalogueSnapshotRowSchema, recordCatalogueSnapshot, getFunnel, adminFunnelContract;
 var init_admin_funnel = __esm(() => {
   init_dist3();
   init_zod();
@@ -13149,6 +13223,16 @@ var init_admin_funnel = __esm(() => {
     labels: number2().int(),
     tracks: number2().int()
   }).meta({ id: "PublicSurfaceCounts" });
+  CaptureBacklogSchema = object({
+    authorized: number2().int(),
+    authorizedAnchored: number2().int(),
+    budgetOpen: boolean2(),
+    tiers: array(object({
+      anchored: number2().int(),
+      tier: number2().int(),
+      unanchored: number2().int()
+    }))
+  }).meta({ id: "CaptureBacklog" });
   FunnelMetersSchema = object({
     anchorBackoff: number2().int(),
     captureBudget: object({
@@ -13187,7 +13271,11 @@ var init_admin_funnel = __esm(() => {
     path: "/admin/funnel/snapshot",
     summary: "Record today's catalogue-funnel snapshot (idempotent per UTC day)",
     tags: ["Admin"]
-  }).input(object({})).output(object({ ok: literal(true), snapshot: CatalogueSnapshotRowSchema }));
+  }).input(object({})).output(object({
+    backfilledDays: array(string2()),
+    ok: literal(true),
+    snapshot: CatalogueSnapshotRowSchema
+  }));
   getFunnel = oc.route({
     method: "GET",
     operationId: "getFunnel",
@@ -13196,6 +13284,7 @@ var init_admin_funnel = __esm(() => {
     tags: ["Admin"]
   }).input(object({ windowDays: string2().optional() })).output(object({
     live: object({
+      captureBacklog: CaptureBacklogSchema,
       meters: FunnelMetersSchema,
       publicSurfaces: PublicSurfaceCountsSchema,
       queues: FunnelLiveQueuesSchema,
@@ -14549,7 +14638,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, 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, PublishTrackResultSchema, getTrackAdmin, listTracksAdmin, TrackWorkKindSchema, TrackWorkScopeSchema, TrackWorkItemSchema, listTrackWork, publishTrack, MixOrderStopSchema, getMixableOrder, adminTracksContract;
 var init_admin_tracks = __esm(() => {
   init_dist3();
   init_zod();
@@ -14692,6 +14781,7 @@ var init_admin_tracks = __esm(() => {
   });
   CapturePreparedTrackSchema = strictObject({
     analyzedFrom: _enum(["full", "preview"]).optional(),
+    anchored: boolean2().optional(),
     artists: array(string2().max(512)).max(64),
     bpm: number2().optional(),
     certified: boolean2(),
@@ -14790,6 +14880,100 @@ var init_admin_tracks = __esm(() => {
       replayed: boolean2()
     })
   ]));
+  TrackWorkCapabilitiesSchema = strictObject({
+    commitTrackCaptures: number2().int().min(1).max(MAX_CAPTURE_COMMIT_BATCH).optional(),
+    prepareTrackCaptures: number2().int().min(1).max(MAX_CAPTURE_PREPARE_BATCH).optional(),
+    updateTrackEmbeddings: number2().int().min(1).max(MAX_EMBEDDING_WRITE_BATCH).optional()
+  });
+  ItemElapsedMsSchema = number2().int().min(0).optional();
+  CapturePreparedItemSchema = union([
+    strictObject({
+      elapsedMs: ItemElapsedMsSchema,
+      prepared: literal(false),
+      reason: _enum(["deferred", "ineligible", "not-found", "stale"]),
+      trackId: string2().min(1).max(256)
+    }),
+    strictObject({
+      elapsedMs: ItemElapsedMsSchema,
+      prepared: literal(true),
+      snapshotToken: string2().min(1).max(65536),
+      track: CapturePreparedTrackSchema,
+      trackId: string2().min(1).max(256)
+    })
+  ]);
+  prepareTrackCaptures = oc.route({
+    method: "POST",
+    operationId: "prepareTrackCaptures",
+    path: "/admin/tracks/captures/prepare",
+    summary: "Prepare a batch of capture reconciliation snapshots in one admitted phase",
+    tags: ["Admin"]
+  }).input(strictObject({
+    items: array(strictObject({
+      kind: CaptureReconciliationKindSchema,
+      priorSnapshotToken: string2().min(1).max(65536).optional(),
+      trackId: string2().min(1).max(256)
+    })).min(1).max(MAX_CAPTURE_PREPARE_BATCH),
+    reservedThisTick: number2().int().min(0).max(1e4).optional()
+  })).output(strictObject({
+    deferred: number2().int().min(0),
+    ok: literal(true),
+    reserved: number2().int().min(0),
+    results: array(CapturePreparedItemSchema).max(MAX_CAPTURE_PREPARE_BATCH)
+  }));
+  CaptureCommitReceiptSchema = object({
+    elapsedMs: ItemElapsedMsSchema,
+    error: string2().max(500).optional(),
+    outcome: _enum([
+      "committed",
+      "conflict",
+      "failed",
+      "in-progress",
+      "lookup-failed",
+      "rejected",
+      "safely-retryable"
+    ]),
+    replayed: boolean2(),
+    result: union([CaptureCommittedReceiptResultSchema, CaptureRejectedReceiptResultSchema]).optional(),
+    trackId: string2().min(1).max(256)
+  }).meta({ id: "CaptureCommitReceipt" });
+  commitTrackCaptures = oc.route({
+    method: "POST",
+    operationId: "commitTrackCaptures",
+    path: "/admin/tracks/captures/commit",
+    summary: "Commit a batch of prepared capture results in one admitted phase",
+    tags: ["Admin"]
+  }).input(strictObject({
+    items: array(CaptureReceiptCoordinatesSchema.extend({
+      commitToken: string2().min(1).max(65536),
+      trackId: string2().min(1).max(256)
+    })).min(1).max(MAX_CAPTURE_COMMIT_BATCH)
+  })).output(strictObject({
+    deferred: number2().int().min(0),
+    ok: literal(true),
+    receipts: array(CaptureCommitReceiptSchema).max(MAX_CAPTURE_COMMIT_BATCH)
+  }));
+  updateTrackEmbeddings = oc.route({
+    method: "POST",
+    operationId: "updateTrackEmbeddings",
+    path: "/admin/tracks/embeddings",
+    summary: "Write a batch of audio embeddings in one admitted phase",
+    tags: ["Admin"]
+  }).input(strictObject({
+    items: array(strictObject({
+      embedding: array(number2()).length(EMBEDDING_DIMENSIONS),
+      trackId: string2().min(1).max(256)
+    })).min(1).max(MAX_EMBEDDING_WRITE_BATCH)
+  })).output(strictObject({
+    deferred: number2().int().min(0),
+    ok: literal(true),
+    results: array(strictObject({
+      elapsedMs: ItemElapsedMsSchema,
+      error: string2().max(500).optional(),
+      fields: array(string2()).optional(),
+      outcome: _enum(["deferred", "failed", "updated"]),
+      trackId: string2().min(1).max(256)
+    })).max(MAX_EMBEDDING_WRITE_BATCH)
+  }));
   observeTrack = oc.route({
     method: "POST",
     operationId: "observeTrack",
@@ -14987,6 +15171,7 @@ var init_admin_tracks = __esm(() => {
     limit: number3().int().min(1).max(250).default(50),
     scope: TrackWorkScopeSchema.default("all")
   })).output(object({
+    capabilities: TrackWorkCapabilitiesSchema.optional(),
     ok: literal(true),
     queued: number2().optional(),
     tracks: array(TrackWorkItemSchema)
@@ -15027,6 +15212,7 @@ var init_admin_tracks = __esm(() => {
   adminTracksContract = {
     authorize_track_capture: authorizeTrackCapture,
     commit_track_capture: commitTrackCapture,
+    commit_track_captures: commitTrackCaptures,
     context_track: contextTrack,
     finalize_track_video: finalizeTrackVideo,
     get_mixable_order: getMixableOrder,
@@ -15036,11 +15222,13 @@ var init_admin_tracks = __esm(() => {
     note_track: noteTrack,
     observe_track: observeTrack,
     prepare_track_capture: prepareTrackCapture,
+    prepare_track_captures: prepareTrackCaptures,
     presign_track_video_uploads: presignTrackVideoUploads,
     publish_track: publishTrack,
     purge_video: purgeVideo,
     requeue_video: requeueVideo,
-    update_track: updateTrack
+    update_track: updateTrack,
+    update_track_embeddings: updateTrackEmbeddings
   };
 });
 
@@ -17140,6 +17328,15 @@ async function mixableOrderCommand(logIds, seed) {
   }
   return adminApiGet(`/api/v1/admin/tracks/mixable-order?${params.toString()}`);
 }
+async function prepareTrackCapturesCommand(body) {
+  return adminApiPost("/api/v1/admin/tracks/captures/prepare", body);
+}
+async function commitTrackCapturesCommand(body) {
+  return adminApiPost("/api/v1/admin/tracks/captures/commit", body);
+}
+async function updateTrackEmbeddingsCommand(body) {
+  return adminApiPost("/api/v1/admin/tracks/embeddings", body);
+}
 var pageSize3 = 48;
 var init_admin_tracks2 = __esm(() => {
   init_api();
@@ -18586,6 +18783,9 @@ async function crawlCatalogueCommand(limit, maxHop, dryRun) {
 async function crawlCataloguePhaseCommand(body) {
   return adminApiPost("/api/v1/admin/catalogue/crawl", body);
 }
+async function commitCrawlNodesCommand(body) {
+  return adminApiPost("/api/v1/admin/catalogue/crawl/commits", body);
+}
 async function crawlStatusCommand() {
   return adminApiGet("/api/v1/admin/catalogue/crawl");
 }
@@ -21732,6 +21932,18 @@ JSON field reference:
     await Promise.resolve().then(() => init_admin_tracks2());
     await runAdminTrackWork(options, trackWorkCommand);
   });
+  adminTracks.command("prepare-captures").description("Freeze a batch of capture snapshots in one admitted phase").requiredOption("--file <path>", "JSON file holding the batch body ({ items: [...] })").option("--json", "Print JSON", false).action(async (options) => {
+    await Promise.resolve().then(() => init_admin_tracks2());
+    printJson(await prepareTrackCapturesCommand(JSON.parse(readFileSync6(options.file, "utf8"))));
+  });
+  adminTracks.command("commit-captures").description("Commit a batch of prepared capture results in one admitted phase").requiredOption("--file <path>", "JSON file holding the batch body ({ items: [...] })").option("--json", "Print JSON", false).action(async (options) => {
+    await Promise.resolve().then(() => init_admin_tracks2());
+    printJson(await commitTrackCapturesCommand(JSON.parse(readFileSync6(options.file, "utf8"))));
+  });
+  adminTracks.command("update-embeddings").description("Write a batch of audio embeddings in one admitted phase").requiredOption("--file <path>", "JSON file holding the batch body ({ items: [...] })").option("--json", "Print JSON", false).action(async (options) => {
+    await Promise.resolve().then(() => init_admin_tracks2());
+    printJson(await updateTrackEmbeddingsCommand(JSON.parse(readFileSync6(options.file, "utf8"))));
+  });
   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) => {
     await Promise.resolve().then(() => init_admin_tracks2());
     await runAdminRequeueAnalysis(options, requeueAnalysisCommand);
@@ -22322,6 +22534,11 @@ JSON field reference:
     }
     await runCrawlCatalogue(options, crawlCatalogueCommand);
   });
+  catalogue.command("commit-nodes").description("Commit one claim's fetched crawl nodes in a single admitted phase").requiredOption("--file <path>", "JSON file holding the batch body ({ items: [...] })").option("--json", "Print JSON", false).action(async (options) => {
+    await Promise.resolve().then(() => init_admin_catalogue2());
+    const body = JSON.parse(readFileSync6(options.file, "utf8"));
+    printJson(await commitCrawlNodesCommand(body));
+  });
   catalogue.command("status").description("The crawl frontier's state, the catalogue's size, and the seed set").option("--json", "Print JSON", false).action(async (options) => {
     await Promise.resolve().then(() => init_admin_catalogue2());
     await runCrawlStatus(options, crawlStatusCommand);
@@ -22963,6 +23180,7 @@ async function runCrawlStatus(options, crawlStatusCommand) {
   console.log(`Catalogue: ${result.catalogueTracks} uncertified track(s); ${result.anchorsPending} awaiting a Spotify anchor.`);
   console.log(`Frontier: ${frontier.pending} pending, ${frontier.done} done, ${frontier.failed} failed, ${frontier.skipped} skipped (${frontierByKind.label} label, ${frontierByKind.artist} artist, ${frontierByKind.release} release).`);
   console.log(`Ready to write: ${result.storablePending} storable release node(s) claimable now.`);
+  console.log(`Held by the storage gate: ${result.unstorablePending} claimable release node(s) \u2014 ${result.undecidedLabelsQueued} undecided label(s) hold queued work.`);
   console.log(`Seeds (${result.seedLabels.length}): ${result.seedLabels.join(", ") || "none enabled"}.`);
   console.log(`Awaiting your ruling: ${result.labelsUndecided} label(s).`);
 }

package/package.json

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