fluncle 0.131.0 → 0.133.0

package/bin/fluncle.mjs

@@ -561,7 +561,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.131.0".trim() ? "0.131.0".trim() : "0.1.0";
+  currentVersion = "0.133.0".trim() ? "0.133.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2189,7 +2189,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.131.0".trim() ? "0.131.0".trim() : "0.1.0";
+  currentVersion2 = "0.133.0".trim() ? "0.133.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2651,14 +2651,25 @@ var init_src = __esm(() => {
     },
     {
       apiFormat: "application/xml",
-      exposedContent: ["the XML sitemap of every public page"],
+      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 (pages/findings/graph/logbook), 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 by kind is also the diagnostic: Search Console reports coverage PER sitemap.",
       probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
       route: "/sitemap.xml",
       url: `${SITE}/sitemap.xml`,
       weights: { web: "secondary" }
     },
+    {
+      apiFormat: "application/xml",
+      exposedContent: ["one child sitemap: the pages / findings / graph / logbook URLs, auto-paged"],
+      kind: "discovery",
+      name: "discovery.sitemap-shard",
+      probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
+      route: "/sitemap/$shard",
+      url: `${SITE}/sitemap/pages-1.xml`,
+      weights: {}
+    },
     {
       apiFormat: "text/plain",
       exposedContent: [
@@ -2836,6 +2847,15 @@ var init_src = __esm(() => {
       name: "cli.tracks-get",
       weights: { cli: "tertiary" }
     },
+    {
+      command: "fluncle tracks similar",
+      exposedContent: [
+        "the findings that sound nearest to one (the sonic neighbourhood, off the MuQ audio embedding), each with its note"
+      ],
+      kind: "cli",
+      name: "cli.tracks-similar",
+      weights: { cli: "tertiary" }
+    },
     {
       command: "fluncle about",
       exposedContent: ["Fluncle, and where to find him"],
@@ -3221,6 +3241,7 @@ __export(exports_track, {
   trackSocialUpdateCommand: () => trackSocialUpdateCommand,
   trackSocialShowCommand: () => trackSocialShowCommand,
   trackSocialCaptureCommand: () => trackSocialCaptureCommand,
+  trackSimilarCommand: () => trackSimilarCommand,
   trackRequeueVideoCommand: () => trackRequeueVideoCommand,
   trackPurgeVideoCommand: () => trackPurgeVideoCommand,
   trackObserveCommand: () => trackObserveCommand,
@@ -3235,6 +3256,10 @@ __export(exports_track, {
 async function trackGetCommand(idOrLogId) {
   return publicApiGet(`/api/tracks/${encodeURIComponent(idOrLogId)}`);
 }
+async function trackSimilarCommand(idOrLogId, limit) {
+  const query = limit === undefined ? "" : `?limit=${encodeURIComponent(String(limit))}`;
+  return publicApiGet(`/api/tracks/${encodeURIComponent(idOrLogId)}/similar${query}`);
+}
 async function trackGetAdminCommand(idOrLogId) {
   return adminApiGet(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}`);
 }
@@ -3438,6 +3463,9 @@ async function trackContextCommand(idOrLogId, options = {}) {
 }
 async function trackNoteCommand(idOrLogId, options) {
   const body = { note: options.note };
+  if (options.dryRun) {
+    body.dryRun = true;
+  }
   return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/note`, body);
 }
 var DEFAULT_VIDEO_MODEL = "anthropic/claude-opus-4-8", DEFAULT_VIDEO_REASONING = "high", FOUND_BASE = "https://found.fluncle.com", VIDEO_FIELDS, RERENDER_CONTRACT_FIELDS, RERENDER_ADVISORY_FIELDS, FOOTAGE_FIELDS, PLATE_FIELDS, NON_FILE_OPTIONS;
@@ -4200,6 +4228,22 @@ var init_publish = __esm(() => {
   init_api();
 });
 
+// src/commands/capture.ts
+var exports_capture = {};
+__export(exports_capture, {
+  setCaptureBudgetCommand: () => setCaptureBudgetCommand,
+  captureBudgetCommand: () => captureBudgetCommand
+});
+async function captureBudgetCommand() {
+  return adminApiGet("/api/admin/catalogue/capture-budget");
+}
+async function setCaptureBudgetCommand(input) {
+  return adminApiPut("/api/admin/catalogue/capture-budget", input);
+}
+var init_capture = __esm(() => {
+  init_api();
+});
+
 // ../../packages/contracts/src/util/multipart.ts
 function planMultipart(contentLength, partSize = DEFAULT_PART_SIZE) {
   if (!Number.isInteger(contentLength) || contentLength <= 0) {
@@ -8019,6 +8063,10 @@ function addTrackCommands(program2) {
     const { trackGetCommand: trackGetCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackGet(idOrLogId, options, trackGetCommand2);
   });
+  tracks.command("similar").description("The findings that sound nearest to one (the sonic neighbourhood)").argument("[idOrLogId]").option("--limit <limit>", "Number of neighbours to show", "6").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+    const { trackSimilarCommand: trackSimilarCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
+    await runTrackSimilar(idOrLogId, options, trackSimilarCommand2);
+  });
 }
 function addAdminCommands(program2) {
   const admin = configureCommand(program2.command("admin", { hidden: true }).description("Operator commands"));
@@ -8147,7 +8195,7 @@ function addAdminCommands(program2) {
     const { trackContextCommand: trackContextCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
     await runTrackContext(idOrLogId, options, trackContextCommand2);
   });
-  adminTrack.command("note").description("Author the editorial note for a finding (fills an empty note only)").argument("[idOrLogId]").option("--queue", "Show the note worklist (context'd findings with no note yet), oldest first", false).option("--limit <limit>", "Number of findings to show with --queue", "10").option("--script <text>", "The voice-gated editorial note").option("--script-file <file>", "Read the editorial note from a file").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+  adminTrack.command("note").description("Author the editorial note for a finding (fills an empty note only)").argument("[idOrLogId]").option("--queue", "Show the note worklist (context'd findings with no note yet), oldest first", false).option("--limit <limit>", "Number of findings to show with --queue", "10").option("--script <text>", "The voice-gated editorial note").option("--script-file <file>", "Read the editorial note from a file").option("--dry-run", "Run the voice + echo gates and report the verdict without storing anything", false).option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
     if (options.queue) {
       const { noteQueueCommand: noteQueueCommand2 } = await Promise.resolve().then(() => (init_admin_tracks(), exports_admin_tracks));
       await runAdminNoteQueue(options, noteQueueCommand2);
@@ -8200,6 +8248,26 @@ function addAdminCommands(program2) {
     const { publishAdvancePauseCommand: publishAdvancePauseCommand2 } = await Promise.resolve().then(() => (init_publish(), exports_publish));
     await runPublishAdvancePause(false, options, publishAdvancePauseCommand2);
   });
+  const adminCapture = configureCommand(admin.command("capture").description("The metered audio-capture budget and its kill switch"));
+  adminCapture.action(() => {
+    adminCapture.outputHelp();
+  });
+  adminCapture.command("budget").description("What catalogue capture spent in the last 24h, and how much budget is left").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { captureBudgetCommand: captureBudgetCommand2 } = await Promise.resolve().then(() => (init_capture(), exports_capture));
+    await runCaptureBudget(options, captureBudgetCommand2);
+  });
+  adminCapture.command("pause").description("Stop all catalogue audio capture \u2014 the kill switch (operator)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { setCaptureBudgetCommand: setCaptureBudgetCommand2 } = await Promise.resolve().then(() => (init_capture(), exports_capture));
+    await runSetCaptureBudget({ paused: true }, options, setCaptureBudgetCommand2);
+  });
+  adminCapture.command("resume").description("Let catalogue audio capture spend again, up to its budget (operator)").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { setCaptureBudgetCommand: setCaptureBudgetCommand2 } = await Promise.resolve().then(() => (init_capture(), exports_capture));
+    await runSetCaptureBudget({ paused: false }, options, setCaptureBudgetCommand2);
+  });
+  adminCapture.command("set").description("Set the rolling-24h capture caps (operator)").option("--tracks <n>", "Max catalogue downloads per rolling 24h").option("--gb <n>", "Max GB downloaded per rolling 24h").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { setCaptureBudgetCommand: setCaptureBudgetCommand2 } = await Promise.resolve().then(() => (init_capture(), exports_capture));
+    await runSetCaptureCaps(options, setCaptureBudgetCommand2);
+  });
   const adminClips = configureCommand(admin.command("clips").description("Mixtape clip (Fluncle Studio) commands"));
   adminClips.action(() => {
     adminClips.outputHelp();
@@ -8509,9 +8577,12 @@ async function runTrackContext(idOrLogId, options, trackContextCommand2) {
 async function runTrackNote(idOrLogId, options, trackNoteCommand2) {
   const note = options.scriptFile ? readFileSync6(options.scriptFile, "utf8") : options.script;
   if (!idOrLogId || !note || !note.trim()) {
-    throw new Error("Usage: fluncle admin tracks note <track_id|log_id> (--script <text> | --script-file <file>) [--json]");
+    throw new Error("Usage: fluncle admin tracks note <track_id|log_id> (--script <text> | --script-file <file>) [--dry-run] [--json]");
   }
-  const result = await trackNoteCommand2(idOrLogId, { note: note.trim() });
+  const result = await trackNoteCommand2(idOrLogId, {
+    dryRun: options.dryRun,
+    note: note.trim()
+  });
   if (options.json) {
     printJson(result);
     return;
@@ -8520,9 +8591,39 @@ async function runTrackNote(idOrLogId, options, trackNoteCommand2) {
     console.log(`A note is already on file for ${result.logId}. The operator's note stands.`);
     return;
   }
+  if (result.dryRun) {
+    console.log(`Both gates passed for ${result.logId}. Nothing was stored (dry run).`);
+    console.log(`  ${result.note}`);
+    if (result.echo?.logId) {
+      const reading = result.echo.phrase ? `lifts "${result.echo.phrase}" from ${result.echo.logId}` : `${Math.round(result.echo.overlap * 100)}% word overlap with ${result.echo.logId}`;
+      console.log(`  echo: ${reading}`);
+    }
+    return;
+  }
   console.log(`Authored the note for ${result.logId}:`);
   console.log(`  ${result.note}`);
 }
+async function runTrackSimilar(idOrLogId, options, trackSimilarCommand2) {
+  if (!idOrLogId) {
+    throw new Error("Missing id. Usage: fluncle tracks similar <track_id|log_id> [--limit <n>] [--json]");
+  }
+  const limit = options.limit ? Number.parseInt(options.limit, 10) : undefined;
+  const result = await trackSimilarCommand2(idOrLogId, limit !== undefined && Number.isFinite(limit) ? limit : undefined);
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  if (result.findings.length === 0) {
+    console.log("Nothing sounds near this one yet. It may still be waiting on its embedding.");
+    return;
+  }
+  for (const finding of result.findings) {
+    console.log(`${finding.logId ?? "\u2014"}  ${finding.artists.join(", ")} \u2014 ${finding.title}`);
+    if (finding.note) {
+      console.log(`  ${finding.note}`);
+    }
+  }
+}
 function printSweepJson(payload, failedCount) {
   printJson({ ...payload, failedCount, ok: failedCount === 0 });
   if (failedCount > 0) {
@@ -9319,6 +9420,60 @@ async function runPublishAdvance(options, publishAdvanceCommand2) {
     console.log(`Failed ${failure.platform} for ${failure.trackId} \u2014 left for the operator.`);
   }
 }
+var GB = 1073741824;
+function formatGb(bytes) {
+  return `${(bytes / GB).toFixed(2)} GB`;
+}
+function printCaptureBudget(state) {
+  const reason = state.closedReason === "paused" ? "paused \u2014 you stopped it" : state.closedReason === "tracks_spent" ? "the daily track cap is spent" : state.closedReason === "bytes_spent" ? "the daily GB cap is spent" : "";
+  console.log(state.open ? "Catalogue capture is RUNNING \u2014 it may buy audio, up to the budget below." : `Catalogue capture is STOPPED (${reason}). Findings still capture as normal.`);
+  console.log(`  Last ${state.windowHours}h:  ${state.spend.tracks} ${state.spend.tracks === 1 ? "track" : "tracks"} \xB7 ${formatGb(state.spend.bytes)}`);
+  console.log(`  Budget:    ${state.budget.dailyTracks} tracks \xB7 ${formatGb(state.budget.dailyBytes)} per ${state.windowHours}h`);
+  console.log(`  Left:      ${state.remainingTracks} ${state.remainingTracks === 1 ? "track" : "tracks"} \xB7 ${formatGb(state.remainingBytes)}`);
+}
+async function runCaptureBudget(options, captureBudgetCommand2) {
+  const state = await captureBudgetCommand2();
+  if (options.json) {
+    printJson(state);
+    return;
+  }
+  printCaptureBudget(state);
+}
+async function runSetCaptureBudget(input, options, setCaptureBudgetCommand2) {
+  const state = await setCaptureBudgetCommand2(input);
+  if (options.json) {
+    printJson(state);
+    return;
+  }
+  printCaptureBudget(state);
+}
+async function runSetCaptureCaps(options, setCaptureBudgetCommand2) {
+  const input = {};
+  if (options.tracks !== undefined) {
+    const tracks = Number(options.tracks);
+    if (!Number.isInteger(tracks) || tracks < 0) {
+      console.error("--tracks must be a whole number of tracks (0 or more).");
+      process.exitCode = 1;
+      return;
+    }
+    input.dailyTracks = tracks;
+  }
+  if (options.gb !== undefined) {
+    const gb = Number(options.gb);
+    if (!Number.isFinite(gb) || gb < 0) {
+      console.error("--gb must be a number of gigabytes (0 or more).");
+      process.exitCode = 1;
+      return;
+    }
+    input.dailyBytes = Math.round(gb * GB);
+  }
+  if (input.dailyTracks === undefined && input.dailyBytes === undefined) {
+    console.error("Nothing to set \u2014 pass --tracks and/or --gb.");
+    process.exitCode = 1;
+    return;
+  }
+  await runSetCaptureBudget(input, options, setCaptureBudgetCommand2);
+}
 async function runPublishAdvancePause(paused, options, publishAdvancePauseCommand2) {
   const result = await publishAdvancePauseCommand2(paused);
   if (options.json) {
@@ -10189,6 +10344,7 @@ var stringOptions = new Set([
   "--footage-social",
   "--from",
   "--galaxy-id",
+  "--gb",
   "--has-key",
   "--intent",
   "--key",
@@ -10227,6 +10383,7 @@ var stringOptions = new Set([
   "--title",
   "--token",
   "--tracklist-file",
+  "--tracks",
   "--url",
   "--verdict",
   "--verdict-file",

package/package.json

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