fluncle 0.111.0 → 0.113.0

package/bin/fluncle.mjs

@@ -557,7 +557,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.111.0".trim() ? "0.111.0".trim() : "0.1.0";
+  currentVersion = "0.113.0".trim() ? "0.113.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2209,7 +2209,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.111.0".trim() ? "0.111.0".trim() : "0.1.0";
+  currentVersion2 = "0.113.0".trim() ? "0.113.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2244,6 +2244,18 @@ var init_src = __esm(() => {
       url: `${SITE}/log`,
       weights: { ssh: "secondary", web: "primary" }
     },
+    {
+      exposedContent: [
+        "Fluncle's Logbook — the voyage as a first-person travelogue, one entry per sector-day",
+        "/logbook/:sector — one day written up, the findings inlined as photos"
+      ],
+      kind: "web_route",
+      name: "web.logbook",
+      probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
+      route: "/logbook",
+      url: `${SITE}/logbook`,
+      weights: { ssh: "tertiary", web: "primary" }
+    },
     {
       exposedContent: ["Fluncle's own DJ mixtapes — each a checkpoint set with an F-marked Log ID"],
       kind: "web_route",
@@ -2851,6 +2863,22 @@ var init_src = __esm(() => {
       probeConfig: { cadenceMs: 10 * MINUTE_MS, cronName: "fluncle-note", kind: "cron" },
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin logbook gaps",
+      exposedContent: [
+        "author the previous day's Logbook travelogue entry, fill-empty-only (hybrid: one claude -p call)"
+      ],
+      kind: "cron",
+      name: "cron.logbook",
+      operatorNotes: "00:40 Amsterdam daily. Hybrid --no-agent; one claude -p writes the day up. Never clobbers an operator entry; the self-healing gap window backfills history oldest-first. Source: docs/agents/hermes/scripts/logbook-sweep.{sh,ts}.",
+      probeConfig: {
+        cadenceMs: 24 * 60 * MINUTE_MS,
+        cronName: "fluncle-logbook",
+        kind: "cron",
+        schedule: { time: "00:40", tz: "Europe/Amsterdam" }
+      },
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin tracks observe --queue",
       exposedContent: [
@@ -3335,6 +3363,46 @@ var init_track = __esm(() => {
   NON_FILE_OPTIONS = ["model", "reasoning"];
 });
 
+// src/commands/admin-attention.ts
+var exports_admin_attention = {};
+__export(exports_admin_attention, {
+  attentionQueueLines: () => attentionQueueLines,
+  attentionQueueCommand: () => attentionQueueCommand
+});
+async function attentionQueueCommand() {
+  const response = await adminApiGet("/api/admin/attention");
+  return response.attention;
+}
+function attentionQueueLines(queue) {
+  const lines = [queue.brief];
+  if (queue.rows.length > 0) {
+    const width = queue.rows.reduce((max, row) => Math.max(max, SOURCE_LABELS[row.source].length), 0);
+    lines.push("");
+    for (const row of queue.rows) {
+      lines.push(`  ${SOURCE_LABELS[row.source].padEnd(width)}  ${row.title}`);
+    }
+  }
+  if (queue.renderQueueDepth > 0) {
+    const noun = queue.renderQueueDepth === 1 ? "finding" : "findings";
+    lines.push("", `${queue.renderQueueDepth} ${noun} in the render queue.`);
+  }
+  return lines;
+}
+var SOURCE_LABELS;
+var init_admin_attention = __esm(() => {
+  init_api();
+  SOURCE_LABELS = {
+    "artist-review": "artist links",
+    "attach-cues": "cues",
+    distribute: "distribute",
+    "drip-empty": "clip drip",
+    "post-tiktok": "tiktok",
+    "post-youtube": "youtube",
+    submission: "submission",
+    "tiktok-draft": "tiktok draft"
+  };
+});
+
 // src/commands/add.ts
 var exports_add = {};
 __export(exports_add, {
@@ -4781,6 +4849,54 @@ var init_newsletter = __esm(() => {
   init_output();
 });
 
+// src/commands/admin-logbook.ts
+var exports_admin_logbook = {};
+__export(exports_admin_logbook, {
+  logbookUpdateCommand: () => logbookUpdateCommand,
+  logbookGapsCommand: () => logbookGapsCommand,
+  logbookCreateCommand: () => logbookCreateCommand
+});
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
+async function logbookGapsCommand(limit) {
+  const query = typeof limit === "number" ? `?limit=${encodeURIComponent(String(limit))}` : "";
+  const response = await adminApiGet(`/api/admin/logbook/gaps${query}`);
+  return response.gaps;
+}
+function resolveBody(options) {
+  if (options.body !== undefined) {
+    return options.body;
+  }
+  if (options.bodyFile !== undefined) {
+    if (!existsSync5(options.bodyFile)) {
+      throw new CliError2("file_not_found", `Body file not found: ${options.bodyFile}`);
+    }
+    return readFileSync5(options.bodyFile, "utf-8");
+  }
+  throw new CliError2("missing_body", "An entry needs a body via --body <text> or --body-file <entry.md>");
+}
+function requireTitle(options) {
+  if (options.title === undefined || !options.title.trim()) {
+    throw new CliError2("missing_title", "An entry needs a title via --title <text>");
+  }
+  return options.title;
+}
+async function logbookCreateCommand(sector, options) {
+  return adminApiPost(`/api/admin/logbook/${encodeURIComponent(sector)}`, {
+    body: resolveBody(options),
+    title: requireTitle(options)
+  });
+}
+async function logbookUpdateCommand(sector, options) {
+  return adminApiPatch(`/api/admin/logbook/${encodeURIComponent(sector)}`, {
+    body: resolveBody(options),
+    title: requireTitle(options)
+  });
+}
+var init_admin_logbook = __esm(() => {
+  init_api();
+  init_output();
+});
+
 // src/commands/add.ts
 async function addCommand2(spotifyUrl, options) {
   const result = await adminApiPost("/api/admin/tracks", {
@@ -4806,6 +4922,7 @@ var init_add2 = __esm(() => {
 // src/commands/submissions.ts
 var exports_submissions = {};
 __export(exports_submissions, {
+  triageSubmissionCommand: () => triageSubmissionCommand,
   reviewSubmissionCommand: () => reviewSubmissionCommand,
   rejectSubmissionCommand: () => rejectSubmissionCommand,
   listSubmissionsCommand: () => listSubmissionsCommand,
@@ -4867,6 +4984,14 @@ async function approveSubmissionCommand(submissionId, options = {}) {
   }
   console.log(`Approved ${formatTrackLine(submission)}.`);
 }
+async function triageSubmissionCommand(submissionId, verdict, options = {}) {
+  const response = await adminApiPost(`/api/admin/submissions/${encodeURIComponent(submissionId)}/triage`, { verdict });
+  if (options.json) {
+    printJson2({ ok: true, submission: response.submission });
+    return;
+  }
+  console.log(`Triaged ${formatTrackLine(response.submission)}: ${response.submission.triageVerdict ?? ""}`);
+}
 async function fetchSubmission(submissionId) {
   const response = await adminApiGet(`/api/admin/submissions/${encodeURIComponent(submissionId)}`);
   return response.submission;
@@ -5436,7 +5561,7 @@ var init_format2 = __esm(() => {
 });
 
 // src/cli.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
 import path2 from "path";
 
 // ../../node_modules/commander/lib/error.js
@@ -7692,6 +7817,10 @@ function addAdminCommands(program2) {
   admin.command("help", { hidden: true }).description("display help for command").action(() => {
     admin.outputHelp();
   });
+  admin.command("queue").description("The attention queue: what's waiting, and the day's dispatch").option("--json", "Print JSON", false).action(async (options) => {
+    const { attentionQueueCommand: attentionQueueCommand2 } = await Promise.resolve().then(() => (init_admin_attention(), exports_admin_attention));
+    await runAdminAttention(options, attentionQueueCommand2);
+  });
   const adminTracks = configureCommand(admin.command("tracks").description("Track admin commands"));
   adminTracks.action(() => {
     adminTracks.outputHelp();
@@ -7916,6 +8045,22 @@ function addAdminCommands(program2) {
     const { newsletterDeleteCommand: newsletterDeleteCommand2 } = await Promise.resolve().then(() => (init_newsletter(), exports_newsletter));
     await runNewsletterDelete(id, options, newsletterDeleteCommand2);
   });
+  const adminLogbook = configureCommand(admin.command("logbook").description("Fluncle's Logbook (travelogue) commands"));
+  adminLogbook.action(() => {
+    adminLogbook.outputHelp();
+  });
+  adminLogbook.command("gaps").description("List sector-days with findings but no logbook entry (the sweep's worklist)").option("--limit <limit>", "Max gaps to return").option("--json", "Print JSON", false).allowExcessArguments().action(async (options) => {
+    const { logbookGapsCommand: logbookGapsCommand2 } = await Promise.resolve().then(() => (init_admin_logbook(), exports_admin_logbook));
+    await runLogbookGaps(options, logbookGapsCommand2);
+  });
+  adminLogbook.command("create").description("Author a sector-day's entry (fills an empty sector only)").argument("[sector]").option("--title <text>", "The entry title").option("--body <text>", "The entry body (markdown; [[logId]] figure tokens)").option("--body-file <file>", "Read the body from a file (the sweep's path)").option("--json", "Print JSON", false).allowExcessArguments().action(async (sector, options) => {
+    const { logbookCreateCommand: logbookCreateCommand2 } = await Promise.resolve().then(() => (init_admin_logbook(), exports_admin_logbook));
+    await runLogbookWrite(sector, options, logbookCreateCommand2);
+  });
+  adminLogbook.command("update").description("Create or overwrite a sector-day's entry. OPERATOR only").argument("[sector]").option("--title <text>", "The entry title").option("--body <text>", "The entry body (markdown; [[logId]] figure tokens)").option("--body-file <file>", "Read the body from a file").option("--json", "Print JSON", false).allowExcessArguments().action(async (sector, options) => {
+    const { logbookUpdateCommand: logbookUpdateCommand2 } = await Promise.resolve().then(() => (init_admin_logbook(), exports_admin_logbook));
+    await runLogbookWrite(sector, options, logbookUpdateCommand2);
+  });
   const submissions = configureCommand(admin.command("submissions").description("Review listener submissions"));
   submissions.option("--json", "Print JSON", false).action(async (options) => {
     const { listSubmissionsCommand: listSubmissionsCommand2 } = await Promise.resolve().then(() => (init_submissions(), exports_submissions));
@@ -7942,6 +8087,17 @@ function addAdminCommands(program2) {
     const { approveSubmissionCommand: approveSubmissionCommand2 } = await Promise.resolve().then(() => (init_submissions(), exports_submissions));
     await approveSubmissionCommand2(submissionId, options);
   });
+  submissions.command("triage").description("Write the pre-chew triage verdict onto a pending submission").argument("[submissionId]").option("--verdict <text>", "The triage verdict one-liner").option("--verdict-file <file>", "Read the verdict from a file").option("--json", "Print JSON", false).action(async (submissionId, options) => {
+    if (!submissionId) {
+      throw new Error("Missing submission id for: triage");
+    }
+    const verdict = options.verdictFile ? readFileSync6(options.verdictFile, "utf8") : options.verdict;
+    if (!verdict || !verdict.trim()) {
+      throw new Error("Usage: fluncle admin submissions triage <submissionId> (--verdict <text> | --verdict-file <file>) [--json]");
+    }
+    const { triageSubmissionCommand: triageSubmissionCommand2 } = await Promise.resolve().then(() => (init_submissions(), exports_submissions));
+    await triageSubmissionCommand2(submissionId, verdict, { json: options.json });
+  });
   const auth = configureCommand(admin.command("auth").description("Authentication commands"));
   auth.command("spotify").description("Authorize Spotify access").action(async () => {
     const { authSpotifyCommand: authSpotifyCommand2 } = await Promise.resolve().then(() => (init_auth(), exports_auth));
@@ -8020,7 +8176,7 @@ async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCo
   console.log(`  mime: ${result.mime}`);
 }
 async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
-  const script = options.scriptFile ? readFileSync5(options.scriptFile, "utf8") : options.script;
+  const script = options.scriptFile ? readFileSync6(options.scriptFile, "utf8") : options.script;
   if (!idOrLogId || !script || !script.trim()) {
     throw new Error("Usage: fluncle admin tracks observe <track_id|log_id> (--script <text> | --script-file <file>) [--voice-id <id>] [--duration-ms <ms>] [--context-note <text>] [--json]");
   }
@@ -8076,7 +8232,7 @@ async function runTrackContext(idOrLogId, options, trackContextCommand2) {
   }
 }
 async function runTrackNote(idOrLogId, options, trackNoteCommand2) {
-  const note = options.scriptFile ? readFileSync5(options.scriptFile, "utf8") : options.script;
+  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]");
   }
@@ -8389,7 +8545,7 @@ async function runTrackVideo(idOrLogId, options, trackVideoCommand2) {
       return;
     }
     const candidate = path2.join(dir, name);
-    return existsSync5(candidate) ? candidate : undefined;
+    return existsSync6(candidate) ? candidate : undefined;
   };
   const resolveFile = (explicit, name) => {
     if (explicit) {
@@ -8584,7 +8740,7 @@ async function runTrackUpdate(trackId, options, trackUpdateCommand3) {
   if (options.analyzedFrom !== undefined && options.analyzedFrom !== "full" && options.analyzedFrom !== "preview") {
     throw new Error(`Invalid --analyzed-from: ${options.analyzedFrom} (expected full or preview)`);
   }
-  const embeddingRaw = options.embeddingFile ? readFileSync5(options.embeddingFile, "utf8") : options.embedding;
+  const embeddingRaw = options.embeddingFile ? readFileSync6(options.embeddingFile, "utf8") : options.embedding;
   const embedding = parseEmbeddingArg(embeddingRaw);
   const result = await trackUpdateCommand3(trackId, {
     analyzedAt: options.analyzedAt,
@@ -8847,6 +9003,37 @@ async function runNewsletterList(options, newsletterListCommand2) {
     console.log(`${label}	${edition.status}	${edition.id}	${subject}`);
   }
 }
+async function runLogbookGaps(options, logbookGapsCommand2) {
+  const limit = options.limit === undefined ? undefined : Number.parseInt(options.limit, 10);
+  const gaps = await logbookGapsCommand2(limit !== undefined && Number.isFinite(limit) ? limit : undefined);
+  if (options.json) {
+    printJson({ gaps, ok: true });
+    return;
+  }
+  if (gaps.length === 0) {
+    console.log("No gaps \u2014 every past sector-day with findings has an entry.");
+    return;
+  }
+  for (const gap of gaps) {
+    console.log(`sector ${gap.sector}	${gap.date.slice(0, 10)}	${gap.findings.length} findings`);
+  }
+}
+async function runLogbookWrite(sector, options, writeCommand) {
+  if (!sector) {
+    throw new Error("Missing sector for the logbook entry");
+  }
+  const result = await writeCommand(sector, {
+    body: options.body,
+    bodyFile: options.bodyFile,
+    title: options.title
+  });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  const skipped = "skipped" in result && result.skipped;
+  console.log(skipped ? `sector ${result.entry.sector}: an entry already stands \u2014 no-op (${result.entry.generatedBy})` : `sector ${result.entry.sector}: ${result.entry.title}`);
+}
 async function runAdd(spotifyUrl, options, addCommand3) {
   if (!spotifyUrl) {
     throw new Error("Missing Spotify track URL");
@@ -8980,6 +9167,16 @@ async function runAdminTracksList(options, listCommand2) {
   console.log(trackRows2(tracks).join(`
 `));
 }
+async function runAdminAttention(options, attentionQueueCommand2) {
+  const queue = await attentionQueueCommand2();
+  if (options.json) {
+    printJson({ attention: queue, ok: true });
+    return;
+  }
+  const { attentionQueueLines: attentionQueueLines2 } = await Promise.resolve().then(() => (init_admin_attention(), exports_admin_attention));
+  console.log(attentionQueueLines2(queue).join(`
+`));
+}
 async function runAdminQueue(options, queueCommand2) {
   const limit = parseListLimit(options.limit);
   const tracks = await queueCommand2(limit, {

package/package.json

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