@audiofool/moondog 0.1.0

package/src/surfaces/cli/web-command.mjs

@@ -0,0 +1,52 @@
+import { sanitizeTerminalText } from "./format-output.mjs";
+
+function inline(value) {
+  return sanitizeTerminalText(value).replace(/\s+/gu, " ").replace(/[\\`*_[\]<>]/gu, "\\$&");
+}
+
+export function formatWebSources(sources) {
+  return [
+    "### Public web sources (Codex)",
+    "",
+    ...sources.map((source) => `- [${inline(source.title)}](<${source.url.replace(/[<>]/gu, encodeURIComponent)}>)${source.published_at ? ` - source date: ${inline(source.published_at)}` : ""}${source.retrieved_at ? ` - retrieved: ${source.retrieved_at}` : ""}`),
+  ].join("\n");
+}
+
+export function formatWebResearch(result) {
+  return [
+    `# Web ${result.kind}: ${result.status}`,
+    "",
+    `Retrieved: ${result.retrieved_at}${result.from_cache ? " (cached)" : ""}`,
+    "A Codex summary of public pages. The dates are when each page was published, which may not be when things happened.",
+    "",
+    sanitizeTerminalText(result.summary),
+    "",
+    "## Sources",
+    "",
+    ...result.sources.flatMap((source) => [
+      `- [${inline(source.title)}](<${source.url.replace(/[<>]/gu, encodeURIComponent)}>)${source.published_at ? ` - source date: ${inline(source.published_at)}` : " - source date unavailable"}`,
+      `  ${inline(source.snippet)}`,
+    ]),
+  ].join("\n");
+}
+
+export async function runWebCommand({ args = [], webResearch, json = false, signal } = {}) {
+  const [action = "help", ...values] = args;
+  if (action === "help" || action === "--help") {
+    return "# Moondog public web\n\n- `/web status` - inspect Codex CLI readiness without a model request\n- `/web search <query>` - search reviews, news, interviews or concert information\n- `/web read <https://public-page>` - read and summarize a public page\n\nThese commands use your existing Codex login and usage allowance. Results stay in the TUI. A 5-minute process-local cache avoids repeat requests. Ctrl+C cancels a request. No music-profile import is needed.\n\nShell equivalents: `moondog web status|search|read [arguments] [--json]`.";
+  }
+  if (!webResearch) throw new Error("Web lookups aren't available right now.");
+  if (action === "status" && values.length === 0) {
+    const status = webResearch.publicStatus();
+    return json ? JSON.stringify(status, null, 2) : `Web lookups through Codex: ${status.state.replaceAll("_", " ")}${status.reason ? ` (${status.reason.replaceAll("_", " ")})` : ""}. Checking this didn't search anything.`;
+  }
+  if (action === "search" && values.length > 0) {
+    const result = await webResearch.search({ query: values.join(" ") }, { signal });
+    return json ? JSON.stringify(result, null, 2) : formatWebResearch(result);
+  }
+  if (action === "read" && values.length === 1) {
+    const result = await webResearch.read({ url: values[0] }, { signal });
+    return json ? JSON.stringify(result, null, 2) : formatWebResearch(result);
+  }
+  throw new Error("Usage: /web status | /web search <query> | /web read <public-url>.");
+}

package/src/surfaces/html/tasteprint-artifact.mjs

@@ -0,0 +1,96 @@
+import { createHash } from "node:crypto";
+import { chmod, mkdir, open } from "node:fs/promises";
+import path from "node:path";
+
+import { resolveListeningHistoryPath } from "../../profile/listening-history-store.mjs";
+import {
+  renderTasteprintCardHtml,
+  renderTasteprintHtml,
+} from "./tasteprint.mjs";
+
+function timestampSlug(value) {
+  return new Date(value).toISOString().replaceAll(/[:.]/gu, "-");
+}
+
+export function resolveTasteprintOutputPath({
+  outputPath,
+  environment = process.env,
+  generatedAt = new Date().toISOString(),
+  format = "full",
+} = {}) {
+  if (!new Set(["full", "card"]).has(format)) {
+    throw new TypeError("Tasteprint artifact format must be full or card.");
+  }
+  if (outputPath !== undefined) {
+    if (typeof outputPath !== "string" || !outputPath.trim()) {
+      throw new TypeError("Tasteprint output path must be a non-empty string.");
+    }
+    const resolved = path.resolve(outputPath);
+    if (path.extname(resolved).toLocaleLowerCase("en-US") !== ".html") {
+      throw new TypeError("Tasteprint output path must end in .html.");
+    }
+    return { path: resolved, privateDirectory: false };
+  }
+
+  const privateRoot = path.join(
+    path.dirname(resolveListeningHistoryPath(environment)),
+    "tasteprints",
+  );
+  return {
+    path: path.join(
+      privateRoot,
+      `${format === "card" ? "tasteprint-card" : "tasteprint"}-${timestampSlug(generatedAt)}.html`,
+    ),
+    privateDirectory: true,
+  };
+}
+
+export async function writeTasteprintArtifact(
+  profile,
+  {
+    outputPath,
+    environment = process.env,
+    generatedAt = new Date().toISOString(),
+    format = "full",
+  } = {},
+) {
+  const destination = resolveTasteprintOutputPath({
+    outputPath,
+    environment,
+    generatedAt,
+    format,
+  });
+  const directory = path.dirname(destination.path);
+  await mkdir(directory, { recursive: true, mode: 0o700 });
+  if (destination.privateDirectory) await chmod(directory, 0o700);
+
+  const html = format === "card"
+    ? renderTasteprintCardHtml(profile, { generatedAt })
+    : renderTasteprintHtml(profile, { generatedAt });
+  let handle;
+  try {
+    handle = await open(destination.path, "wx", 0o600);
+    await handle.writeFile(html, "utf8");
+  } catch (error) {
+    if (error?.code === "EEXIST") {
+      throw new Error(`Tasteprint output already exists: ${destination.path}`);
+    }
+    throw error;
+  } finally {
+    await handle?.close();
+  }
+  await chmod(destination.path, 0o600);
+
+  return {
+    artifact_version:
+      format === "card"
+        ? "moondog-tasteprint-card-artifact/1"
+        : "moondog-tasteprint-artifact/1",
+    artifact_format: format,
+    path: destination.path,
+    bytes: Buffer.byteLength(html),
+    sha256: createHash("sha256").update(html).digest("hex"),
+    private: true,
+    network_requests: "none",
+  };
+}