promaster 1.2.0 → 1.4.0

package/README.md

@@ -2,7 +2,8 @@
 
 Interactive CLI to browse Markdown from a **public GitHub repo**, grouped into
 three categories: **blog**, **memory**, **books**. Each selected file is
-rendered to a styled, standalone **HTML** page — click it to open in a browser.
+rendered to a styled, standalone **HTML** page and opened in your browser —
+nothing is saved to disk.
 
 The package ships only the CLI. Your Markdown content lives in your own GitHub
 repo and is fetched at runtime — it is never bundled into npm.
@@ -33,12 +34,12 @@ promaster list
 1. Pick a category: `blog` / `memory` / `books`.
 2. Files are listed newest → oldest (by last git commit date).
 3. Toggle one or more with space, confirm with enter.
-4. Each selection is converted to HTML and saved to
-   `./promaster-data/<category>/<name>.html`.
-5. The CLI then offers to open the saved file(s) in your default browser.
+4. Each selection is rendered to HTML in a temporary directory and opened in
+   your default browser right away.
+5. Press Enter in the CLI when you're done — the temporary files are deleted.
+   Nothing is ever written to your project directory.
 
-Open any saved `.html` later by double-clicking it — it renders fully offline
-(styles are inlined, with light/dark support).
+The pages render fully offline (styles are inlined, with light/dark support).
 
 ## Configuration
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promaster",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Interactive CLI to browse Markdown (blog/memory/books) from a public GitHub repo and save it as browser-ready HTML.",
   "type": "module",
   "bin": {

package/src/commands/list.js

@@ -1,8 +1,9 @@
-import { select, checkbox, confirm } from "@inquirer/prompts";
-import { resolve, dirname } from "node:path";
+import { select, checkbox, input } from "@inquirer/prompts";
+import { rmSync } from "node:fs";
+import { rm } from "node:fs/promises";
 import { resolveRepo, CATEGORIES } from "../config.js";
 import { listMarkdown, lastCommitDate, fetchRaw, HttpError } from "../github.js";
-import { save, OUTPUT_ROOT } from "../download.js";
+import { saveTemp } from "../download.js";
 import { openInBrowser } from "../open.js";
 
 const CONCURRENCY = 5;
@@ -54,22 +55,50 @@ export async function runList() {
     return;
   }
 
-  const saved = [];
-  for (const file of picked) {
-    const content = await fetchRaw(file.download_url, ctx);
-    saved.push(await save(category, file, content));
-  }
+  // All categories open immediately, never persist — temp files deleted on exit.
+  await openEphemeral(picked, ctx);
+}
 
-  console.log("\nSaved (HTML — click to open in a browser):");
-  for (const p of saved) console.log(`  ${p}`);
-  console.log(`\nOutput dir: ${resolve(process.cwd(), OUTPUT_ROOT, category)}`);
+// Render picks to OS temp, auto-open in the browser, then delete once the
+// user is done (Enter) or aborts (Ctrl+C). Nothing is left on disk.
+async function openEphemeral(picked, ctx) {
+  const dirs = [];
+  const cleanup = () => {
+    while (dirs.length) {
+      try {
+        rmSync(dirs.pop(), { recursive: true, force: true });
+      } catch {
+        /* best effort */
+      }
+    }
+  };
 
-  const open = await confirm({
-    message: `Open ${saved.length === 1 ? "it" : "them"} in your browser now?`,
-    default: true,
-  });
-  if (open) {
-    for (const p of saved) openInBrowser(p);
+  const onSigint = () => {
+    cleanup();
+    process.exit(130);
+  };
+  process.on("SIGINT", onSigint);
+
+  try {
+    for (const file of picked) {
+      const content = await fetchRaw(file.download_url, ctx);
+      const { path, dir } = await saveTemp(file, content);
+      dirs.push(dir);
+      openInBrowser(path);
+      console.log(`Opened in browser: ${file.name}`);
+    }
+
+    console.log("\nThese are temporary — nothing is saved to disk.");
+    await input({
+      message: `Press Enter when you're done to delete the temporary file${
+        picked.length === 1 ? "" : "s"
+      }`,
+    });
+  } finally {
+    process.off("SIGINT", onSigint);
+    for (const dir of dirs.splice(0)) {
+      await rm(dir, { recursive: true, force: true }).catch(() => {});
+    }
   }
 }
 

package/src/download.js

@@ -1,5 +1,6 @@
-import { mkdir, writeFile } from "node:fs/promises";
+import { mkdir, mkdtemp, writeFile } from "node:fs/promises";
 import { basename, extname, resolve } from "node:path";
+import { tmpdir } from "node:os";
 import { mdToHtml } from "./render.js";
 
 export const OUTPUT_ROOT = "promaster-data";
@@ -40,3 +41,19 @@ export async function save(category, file, content) {
   await writeFile(dest, html, "utf8");
   return dest;
 }
+
+/**
+ * Render markdown to HTML in a fresh OS temp directory (never under
+ * promaster-data). Returns { path, dir } so the caller can delete `dir`
+ * once the user is done viewing — nothing is persisted.
+ */
+export async function saveTemp(file, content) {
+  const dir = await mkdtemp(resolve(tmpdir(), "promaster-"));
+  const base = safeName(file.name);
+  const ext = extname(base);
+  const title = ext ? base.slice(0, -ext.length) : base;
+  const html = mdToHtml(content, { title });
+  const path = resolve(dir, htmlName(file.name));
+  await writeFile(path, html, "utf8");
+  return { path, dir };
+}