fluncle 0.131.0 → 0.132.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.132.0".trim() ? "0.132.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.132.0".trim() ? "0.132.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2836,6 +2836,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 +3230,7 @@ __export(exports_track, {
   trackSocialUpdateCommand: () => trackSocialUpdateCommand,
   trackSocialShowCommand: () => trackSocialShowCommand,
   trackSocialCaptureCommand: () => trackSocialCaptureCommand,
+  trackSimilarCommand: () => trackSimilarCommand,
   trackRequeueVideoCommand: () => trackRequeueVideoCommand,
   trackPurgeVideoCommand: () => trackPurgeVideoCommand,
   trackObserveCommand: () => trackObserveCommand,
@@ -3235,6 +3245,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 +3452,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;
@@ -8019,6 +8036,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 +8168,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);
@@ -8509,9 +8530,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 +8544,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) {

package/package.json

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