fluncle 0.278.0 → 0.280.0

package/bin/fluncle.mjs

@@ -95,9 +95,11 @@ var EAGAIN_WAIT, stopWaitingForReader = () => false, CliError;
 var init_output = __esm(() => {
   EAGAIN_WAIT = new Int32Array(new SharedArrayBuffer(4));
   CliError = class CliError extends Error {
+    dueWork;
     code;
-    constructor(code, message) {
+    constructor(code, message, dueWork) {
       super(message);
+      this.dueWork = dueWork;
       this.name = "CliError";
       this.code = code;
     }
@@ -702,7 +704,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.278.0".trim() ? "0.278.0".trim() : "0.1.0";
+  currentVersion = "0.280.0".trim() ? "0.280.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -9740,11 +9742,12 @@ async function apiRequest(path, init = {}) {
       const failure = isJsonFailure(data) ? data : undefined;
       return yield* new ApiResponseError({
         code: failure?.code ?? `http_${response.status}`,
+        dueWork: failure?.dueWork,
         message: failure?.message ?? `${response.status} ${response.statusText}`
       });
     }
     return data;
-  }).pipe(mapError2((error) => error._tag === "ApiTransportError" ? error.cause : new CliError(error.code, error.message))));
+  }).pipe(mapError2((error) => error._tag === "ApiTransportError" ? error.cause : new CliError(error.code, error.message, error.dueWork))));
 }
 function parseJson2(text) {
   if (!text) {
@@ -10105,7 +10108,7 @@ async function mixtapeGetCommand(idOrLogId) {
   const mixtapes = await mixtapeListCommand();
   const match = mixtapes.find((mixtape) => mixtape.id === idOrLogId || mixtape.logId === idOrLogId);
   if (!match) {
-    throw new CliError("mixtape_not_found", `No mixtape with id or log id ${idOrLogId}`);
+    throw new CliError("mixtape_not_found", `No mixtape with id or Log ID ${idOrLogId}`);
   }
   return match;
 }
@@ -10389,7 +10392,7 @@ async function mixtapeUpdateCommand(id, options) {
 async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {}) {
   const mixtape = await mixtapeGetCommand(idOrLogId);
   if (!mixtape.id) {
-    throw new CliError("mixtape_not_found", `No mixtape with id or log id ${idOrLogId}`);
+    throw new CliError("mixtape_not_found", `No mixtape with id or Log ID ${idOrLogId}`);
   }
   const both = !options.youtube && !options.mixcloud;
   const doYoutube = both || Boolean(options.youtube);
@@ -10445,7 +10448,7 @@ async function mixtapeDistributeCommand(idOrLogId, options, onProgress = () => {
 async function mixtapeResyncCommand(idOrLogId, options, onProgress = () => {}) {
   const mixtape = await mixtapeGetCommand(idOrLogId);
   if (!mixtape.id) {
-    throw new CliError("mixtape_not_found", `No mixtape with id or log id ${idOrLogId}`);
+    throw new CliError("mixtape_not_found", `No mixtape with id or Log ID ${idOrLogId}`);
   }
   if (!mixtape.logId) {
     throw new CliError("mixtape_no_log_id", "The mixtape isn't published yet. Distribute it before re-syncing.");
@@ -11142,7 +11145,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.278.0".trim() ? "0.278.0".trim() : "0.1.0";
+  currentVersion2 = "0.280.0".trim() ? "0.280.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -11838,7 +11841,7 @@ var init_src = __esm(() => {
       exposedContent: ["the XML sitemap index of every public page"],
       kind: "discovery",
       name: "discovery.sitemap",
-      operatorNotes: "A sitemap INDEX, not a flat urlset: the URLs live in children at /sitemap/<kind>-<n>.xml, ONE CHILD PER ENTITY TYPE (pages/findings/artists/labels/albums/galaxies/logbook/docs), each auto-paged under Google's 50,000-URL ceiling so a breach cannot happen rather than merely not having happened yet. robots.txt still names this one URL — a crawler discovers the children from here. Splitting per entity type is also the diagnostic: Search Console reports coverage PER sitemap, so each entity type gets its own submitted/indexed count.",
+      operatorNotes: "A sitemap INDEX, not a flat urlset: the URLs live in children at /sitemap/<kind>-<n>.xml, ONE CHILD PER ENTITY TYPE (pages/findings/tracks/artists/labels/albums/galaxies/logbook/docs), each auto-paged under Google's 50,000-URL ceiling so a breach cannot happen rather than merely not having happened yet. robots.txt still names this one URL — a crawler discovers the children from here. Splitting per entity type is also the diagnostic: Search Console reports coverage PER sitemap, so each entity type gets its own submitted/indexed count.",
       probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
       route: "/sitemap.xml",
       url: `${SITE}/sitemap.xml`,
@@ -11847,7 +11850,7 @@ var init_src = __esm(() => {
     {
       apiFormat: "application/xml",
       exposedContent: [
-        "one child sitemap, per entity type: the pages / findings / artists / labels / albums / galaxies / logbook / docs URLs, auto-paged"
+        "one child sitemap, per entity type: the pages / findings / tracks / artists / labels / albums / galaxies / logbook / docs URLs, auto-paged"
       ],
       kind: "discovery",
       name: "discovery.sitemap-shard",
@@ -12785,7 +12788,7 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.projection-maintenance",
-      operatorNotes: "every 5m with per-firing jitter, run by a rave-02 host systemd timer (docs/agents/hermes/projection-maintenance-timer/). Reads bounded projection status exactly once; the track, crawl, and public cutovers gate their own families independently. Open indebted families run strictly serially: track and crawl get at most twenty pages of 500, then public aggregates and artist qualification get at most four pages of 500. Repair responses omit terminal status so those four commands cannot repeat the global status suite. Public aggregate repair also advances the bounded anchor cursor after marker debt drains. The agent may repair only these four fixed targets; rebuild, audit, and every cutover mutation remain operator-only. Zero LLM tokens; no new secret.",
+      operatorNotes: "every 5m with per-firing jitter, run by a rave-02 host systemd timer (docs/agents/hermes/projection-maintenance-timer/). Reads bounded projection status exactly once; the track, crawl, and public cutovers gate their own families independently. Open indebted families run strictly serially, oldest debt first, each repairing in pages of 500 under a 30-second wall budget inside a 120-second tick budget; each family's step count is sized from its measured debt, capped at 100, with a floor of four for public aggregates and artist qualification. Repair responses omit terminal status so those four commands cannot repeat the global status suite. Public aggregate repair also advances the bounded anchor cursor after marker debt drains. The agent may repair only these four fixed targets; rebuild, audit, and every cutover mutation remain operator-only. Zero LLM tokens; no new secret.",
       probeConfig: {
         cadenceMs: 5 * MINUTE_MS,
         cronName: "fluncle-projection-maintenance",
@@ -23117,6 +23120,13 @@ var init_admin_projections = __esm(() => {
     scheduled: CountSchema,
     status: ProjectionStatusSchema.optional(),
     target: ProjectionTargetSchema,
+    trackRepair: object({
+      catalogueRankRowsScanned: CountSchema,
+      physicalRowsScanned: record2(string4(), CountSchema),
+      sourceMarkersCleared: CountSchema,
+      sourceMarkersDeferred: CountSchema,
+      sourceMarkersScanned: CountSchema
+    }).optional(),
     trackSourceMarkersPending: boolean3().optional()
   }));
   setProjectionCutover = oc.route({
@@ -25677,7 +25687,13 @@ var init_admin_tracks = __esm(() => {
     sourceAudioKey: unknown2().optional(),
     sourceAudioRejected: unknown2().optional(),
     sourceVerification: unknown2().optional(),
+    videoGrain: unknown2().optional(),
+    videoPalette: unknown2().optional(),
+    videoPlateSubject: unknown2().optional(),
+    videoRegister: unknown2().optional(),
+    videoStructure: unknown2().optional(),
     videoUrl: unknown2().optional(),
+    videoVehicle: unknown2().optional(),
     youtubeReverdict: unknown2().optional(),
     youtubeVerification: unknown2().optional(),
     youtubeVideoId: unknown2().optional()
@@ -26223,6 +26239,7 @@ var init_admin_tracks = __esm(() => {
       open: literal(false)
     }).optional(),
     debtPending: boolean3().optional(),
+    dueWork: object({ branch: string4(), workKind: string4() }).optional(),
     ok: literal(true),
     oldestQueuedCaptureOver24h: boolean3().optional(),
     queued: number4().optional(),
@@ -26571,7 +26588,7 @@ var init_admin_turso_usage = __esm(() => {
 });
 
 // ../../packages/contracts/src/orpc/admin-twitch.ts
-var recordLiveState, adminTwitchContract;
+var LIVE_STATE_TIMESTAMP_MAX = 64, recordLiveState, adminTwitchContract;
 var init_admin_twitch = __esm(() => {
   init_dist4();
   init_zod();
@@ -26582,9 +26599,9 @@ var init_admin_twitch = __esm(() => {
     summary: "Record the current Twitch live state for the cross-surface live callout",
     tags: ["Admin"]
   }).input(object({
-    at: string4().min(1),
+    at: string4().max(LIVE_STATE_TIMESTAMP_MAX).datetime({ offset: true }),
     live: boolean3(),
-    startedAt: string4().nullable(),
+    startedAt: string4().max(LIVE_STATE_TIMESTAMP_MAX).nullable(),
     title: string4().nullable()
   })).output(object({ ok: literal(true) }));
   adminTwitchContract = {
@@ -26704,11 +26721,72 @@ var init_editions = __esm(() => {
   };
 });
 
+// ../../packages/contracts/src/orpc/me-follows.ts
+var FollowKindSchema, FollowSchema, SaveFollowBodySchema, listPrivateFollows, savePrivateFollow, deletePrivateFollow, revokePrivateFollowLinkAccess, meFollowsContract;
+var init_me_follows = __esm(() => {
+  init_dist4();
+  init_zod();
+  FollowKindSchema = _enum(["artist", "label"]).meta({ id: "FollowKind" });
+  FollowSchema = object({
+    createdAt: string4(),
+    entityId: string4(),
+    id: string4(),
+    includeSimilar: boolean3(),
+    kind: FollowKindSchema,
+    name: string4(),
+    slug: string4()
+  }).meta({ id: "Follow" });
+  SaveFollowBodySchema = looseObject({
+    entityId: unknown2().optional(),
+    intent: unknown2().optional(),
+    kind: unknown2().optional()
+  });
+  listPrivateFollows = oc.route({
+    method: "GET",
+    operationId: "listPrivateFollows",
+    path: "/me/follows",
+    summary: "List the artists and labels the signed-in user follows",
+    tags: ["Me"]
+  }).output(object({ follows: array2(FollowSchema), ok: literal(true) }));
+  savePrivateFollow = oc.route({
+    method: "POST",
+    operationId: "savePrivateFollow",
+    path: "/me/follows",
+    summary: "Follow an artist or label for the signed-in user",
+    tags: ["Me"]
+  }).input(SaveFollowBodySchema).output(object({
+    follow: FollowSchema,
+    followsEmail: boolean3(),
+    ok: literal(true)
+  }));
+  deletePrivateFollow = oc.route({
+    method: "DELETE",
+    operationId: "deletePrivateFollow",
+    path: "/me/follows/{id}",
+    summary: "Unfollow an artist or label for the signed-in user",
+    tags: ["Me"]
+  }).input(object({ id: string4() })).output(object({ ok: literal(true) }));
+  revokePrivateFollowLinkAccess = oc.route({
+    method: "POST",
+    operationId: "revokePrivateFollowLinkAccess",
+    path: "/me/follow-link-access/revoke",
+    summary: "Revoke emailed follows management links for the signed-in user",
+    tags: ["Me"]
+  }).output(object({ ok: literal(true), token: string4() }));
+  meFollowsContract = {
+    delete_private_follow: deletePrivateFollow,
+    list_private_follows: listPrivateFollows,
+    revoke_private_follow_link_access: revokePrivateFollowLinkAccess,
+    save_private_follow: savePrivateFollow
+  };
+});
+
 // ../../packages/contracts/src/orpc/follow-digest.ts
 var TokenSchema, sendFollowDigests, getFollowDigestState, setFollowDigestState, unsubscribeFollowDigest, subscribeFollowDigest, listDigestFollows, deleteDigestFollow, followDigestContract;
 var init_follow_digest = __esm(() => {
   init_dist4();
   init_zod();
+  init_me_follows();
   TokenSchema = string4().min(10).max(1024);
   sendFollowDigests = oc.route({
     method: "POST",
@@ -26783,7 +26861,7 @@ var init_follow_digest = __esm(() => {
   }).input(object({ token: TokenSchema })).output(object({
     follows: array2(object({
       id: string4(),
-      kind: _enum(["artist", "label"]),
+      kind: FollowKindSchema,
       name: string4(),
       slug: string4()
     })),
@@ -26812,74 +26890,6 @@ var init_follow_digest = __esm(() => {
   };
 });
 
-// ../../packages/contracts/src/orpc/me-follows.ts
-var FollowKindSchema, FollowSchema, SaveFollowBodySchema, listPrivateFollows, savePrivateFollow, deletePrivateFollow, revokePrivateFollowLinkAccess, meFollowsContract;
-var init_me_follows = __esm(() => {
-  init_dist4();
-  init_zod();
-  FollowKindSchema = _enum(["artist", "label"]).meta({ id: "FollowKind" });
-  FollowSchema = object({
-    createdAt: string4(),
-    entityId: string4(),
-    id: string4(),
-    includeSimilar: boolean3(),
-    kind: FollowKindSchema,
-    name: string4(),
-    slug: string4()
-  }).meta({ id: "Follow" });
-  SaveFollowBodySchema = looseObject({
-    entityId: unknown2().optional(),
-    intent: unknown2().optional(),
-    kind: unknown2().optional()
-  });
-  listPrivateFollows = oc.route({
-    method: "GET",
-    operationId: "listPrivateFollows",
-    path: "/me/follows",
-    summary: "List the artists and labels the signed-in user follows",
-    tags: ["Me"]
-  }).output(object({ follows: array2(FollowSchema), ok: literal(true) }));
-  savePrivateFollow = oc.route({
-    method: "POST",
-    operationId: "savePrivateFollow",
-    path: "/me/follows",
-    summary: "Follow an artist or label for the signed-in user",
-    tags: ["Me"]
-  }).input(SaveFollowBodySchema).output(object({
-    follow: object({
-      createdAt: string4(),
-      entityId: string4(),
-      id: string4(),
-      includeSimilar: boolean3(),
-      kind: FollowKindSchema,
-      name: string4(),
-      slug: string4()
-    }),
-    followsEmail: boolean3(),
-    ok: literal(true)
-  }));
-  deletePrivateFollow = oc.route({
-    method: "DELETE",
-    operationId: "deletePrivateFollow",
-    path: "/me/follows/{id}",
-    summary: "Unfollow an artist or label for the signed-in user",
-    tags: ["Me"]
-  }).input(object({ id: string4() })).output(object({ ok: literal(true) }));
-  revokePrivateFollowLinkAccess = oc.route({
-    method: "POST",
-    operationId: "revokePrivateFollowLinkAccess",
-    path: "/me/follow-link-access/revoke",
-    summary: "Revoke emailed follows management links for the signed-in user",
-    tags: ["Me"]
-  }).output(object({ ok: literal(true), token: string4() }));
-  meFollowsContract = {
-    delete_private_follow: deletePrivateFollow,
-    list_private_follows: listPrivateFollows,
-    revoke_private_follow_link_access: revokePrivateFollowLinkAccess,
-    save_private_follow: savePrivateFollow
-  };
-});
-
 // ../../packages/contracts/src/orpc/me-galaxy.ts
 var GalaxyProgressSchema, GalaxyMergeBodySchema, GalaxyLogBodySchema, getPrivateGalaxyProgress, mergePrivateGalaxyProgress, collectPrivateGalaxyLog, GalaxyCollectionItemSchema, GalaxyCompletionSchema, listPrivateGalaxyCollection, meGalaxyContract;
 var init_me_galaxy = __esm(() => {
@@ -28235,19 +28245,46 @@ async function advanceProjectionCommand(input) {
   let wallStopped = false;
   let rebuildRowsWalked = response.rebuildRowsWalked ?? 0;
   let rebuildReported = response.rebuildStaleFamilies !== undefined;
+  const trackRepair = {
+    catalogueRankRowsScanned: 0,
+    physicalRowsScanned: {},
+    sourceMarkersCleared: 0,
+    sourceMarkersDeferred: 0,
+    sourceMarkersScanned: 0
+  };
+  let trackRepairReported = false;
+  const addTrackRepair = () => {
+    const metrics = response.trackRepair;
+    if (metrics === undefined) {
+      return;
+    }
+    trackRepairReported = true;
+    trackRepair.catalogueRankRowsScanned += metrics.catalogueRankRowsScanned;
+    trackRepair.sourceMarkersCleared += metrics.sourceMarkersCleared;
+    trackRepair.sourceMarkersDeferred += metrics.sourceMarkersDeferred;
+    trackRepair.sourceMarkersScanned += metrics.sourceMarkersScanned;
+    for (const [kind, scanned] of Object.entries(metrics.physicalRowsScanned)) {
+      trackRepair.physicalRowsScanned[kind] = (trackRepair.physicalRowsScanned[kind] ?? 0) + scanned;
+    }
+  };
+  addTrackRepair();
   while (!response.complete && steps < maxSteps) {
     if (wallMs !== undefined && now() - startedAt >= wallMs) {
       wallStopped = true;
       break;
     }
     response = await adminApiPost(`/api/v1/admin/projections/${target}/advance`, stepBody);
+    addTrackRepair();
     steps += 1;
     processed += response.processed;
     scheduled += response.scheduled;
     rebuildRowsWalked += response.rebuildRowsWalked ?? 0;
     rebuildReported ||= response.rebuildStaleFamilies !== undefined;
   }
-  const rebuild = rebuildReported ? { rebuildRowsWalked, rebuildStaleFamilies: response.rebuildStaleFamilies ?? 0 } : {};
+  const rebuild = {
+    ...rebuildReported ? { rebuildRowsWalked, rebuildStaleFamilies: response.rebuildStaleFamilies ?? 0 } : {},
+    ...trackRepairReported ? { trackRepair } : {}
+  };
   if (!includeTerminalStatus) {
     const { status: _status, ...withoutStatus } = response;
     return { ...withoutStatus, ...rebuild, processed, scheduled, steps, wallStopped };
@@ -28651,6 +28688,7 @@ async function trackWorkCommand(options) {
   const response = await adminApiGet(`/api/v1/admin/tracks/work?${params.toString()}`);
   return {
     debtPending: response.debtPending,
+    dueWork: response.dueWork,
     queued: response.queued,
     tracks: response.tracks ?? []
   };
@@ -34028,9 +34066,11 @@ function routeConsoleThroughBlockingWrites(pastDeadline) {
   console.warn = toStderr;
 }
 class CliError2 extends Error {
+  dueWork;
   code;
-  constructor(code, message) {
+  constructor(code, message, dueWork) {
     super(message);
+    this.dueWork = dueWork;
     this.name = "CliError";
     this.code = code;
   }
@@ -34043,6 +34083,7 @@ function toJsonFailure(error) {
   if (error instanceof CliError2) {
     return {
       code: error.code,
+      ...error.dueWork === undefined ? {} : { dueWork: error.dueWork },
       message: error.message,
       ok: false
     };
@@ -34738,7 +34779,7 @@ JSON field reference:
     await Promise.resolve().then(() => init_mixtapes());
     await runMixtapeList(options, mixtapeListCommand);
   });
-  adminMixtapes.command("get").description("Show one mixtape by id or log id").argument("[idOrLogId]").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+  adminMixtapes.command("get").description("Show one mixtape by id or Log ID").argument("[idOrLogId]").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
     await Promise.resolve().then(() => init_mixtapes());
     await runMixtapeGet(idOrLogId, options, mixtapeGetCommand);
   });
@@ -37431,7 +37472,7 @@ async function runPublishAdvancePause(paused, options, publishAdvancePauseComman
 }
 async function runMixtapeGet(idOrLogId, options, mixtapeGetCommand) {
   if (!idOrLogId) {
-    throw new Error("Missing mixtape id or log id. Usage: fluncle admin mixtapes get <id|logId>");
+    throw new Error("Missing mixtape id or Log ID. Usage: fluncle admin mixtapes get <id|logId>");
   }
   const mixtape = await mixtapeGetCommand(idOrLogId);
   if (options.json) {

package/package.json

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