fluncle 0.112.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.112.0".trim() ? "0.112.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.112.0".trim() ? "0.112.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: [
@@ -4821,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", {
@@ -5485,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
@@ -7969,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));
@@ -7999,7 +8091,7 @@ function addAdminCommands(program2) {
     if (!submissionId) {
       throw new Error("Missing submission id for: triage");
     }
-    const verdict = options.verdictFile ? readFileSync5(options.verdictFile, "utf8") : options.verdict;
+    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]");
     }
@@ -8084,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]");
   }
@@ -8140,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]");
   }
@@ -8453,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) {
@@ -8648,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,
@@ -8911,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");

package/package.json

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