fluncle 0.200.0 → 0.202.0

package/bin/fluncle.mjs

@@ -367,6 +367,55 @@ var require_main = __commonJS((exports, module) => {
   module.exports = DotenvModule;
 });
 
+// src/env.ts
+import { homedir } from "node:os";
+import { join } from "node:path";
+function loadEnv(keys) {
+  loadConfig();
+  const result = {};
+  const missing = [];
+  for (const key of keys) {
+    const value = process.env[key];
+    if (value === undefined) {
+      missing.push(key);
+      continue;
+    }
+    result[key] = value;
+  }
+  if (missing.length > 0) {
+    throw new Error(`Missing required env vars: ${missing.join(", ")}`);
+  }
+  return result;
+}
+function getApiBaseUrl() {
+  loadConfig();
+  return (process.env.FLUNCLE_API_BASE_URL ?? "https://www.fluncle.com").replace(/\/+$/, "");
+}
+function loadConfig() {
+  const profile = getEnvProfile();
+  if (loadedProfile === profile) {
+    return;
+  }
+  loadedProfile = profile;
+  if (false) {}
+  import_dotenv2.config({ path: join(homedir(), `.config/fluncle/.env.${profile}`), quiet: true });
+}
+function getEnvProfile() {
+  const profile = process.env.FLUNCLE_ENV ?? defaultEnvProfile;
+  if (!isEnvProfile2(profile)) {
+    throw new Error(`Unknown env profile: ${profile}. Expected local or production.`);
+  }
+  return profile;
+}
+function isEnvProfile2(value) {
+  return envProfiles2.includes(value);
+}
+var import_dotenv2, envProfiles2, defaultEnvProfile = "production", loadedProfile;
+var init_env = __esm(() => {
+  import_dotenv2 = __toESM(require_main(), 1);
+  envProfiles2 = ["local", "production"];
+});
+
 // ../../packages/contracts/src/util.ts
 function formatDuration(durationMs) {
   const totalSeconds = Math.round(durationMs / 1000);
@@ -561,7 +610,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.200.0".trim() ? "0.200.0".trim() : "0.1.0";
+  currentVersion = "0.202.0".trim() ? "0.202.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -573,8 +622,8 @@ __export(exports_update_notifier, {
   detectInstallMethod: () => detectInstallMethod
 });
 import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { homedir, platform } from "node:os";
-import { dirname, join, sep } from "node:path";
+import { homedir as homedir2, platform } from "node:os";
+import { dirname, join as join2, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 async function notifyIfUpdateAvailable(args) {
   try {
@@ -686,8 +735,8 @@ async function writeCache(state) {
   } catch {}
 }
 function cacheFilePath() {
-  const base = process.env.XDG_CACHE_HOME?.trim() || platform() === "win32" && process.env.LOCALAPPDATA?.trim() || join(homedir(), ".config");
-  return join(base, "fluncle", "update-check.json");
+  const base = process.env.XDG_CACHE_HOME?.trim() || platform() === "win32" && process.env.LOCALAPPDATA?.trim() || join2(homedir2(), ".config");
+  return join2(base, "fluncle", "update-check.json");
 }
 function buildNotice(current, latest) {
   const method = detectInstallMethod({ entry: entryPath(), execPath: process.execPath || "" });
@@ -747,55 +796,6 @@ var init_update_notifier = __esm(() => {
   cacheTtlMs = 24 * 60 * 60 * 1000;
 });
 
-// src/env.ts
-import { homedir as homedir2 } from "node:os";
-import { join as join2 } from "node:path";
-function loadEnv(keys) {
-  loadConfig();
-  const result = {};
-  const missing = [];
-  for (const key of keys) {
-    const value = process.env[key];
-    if (value === undefined) {
-      missing.push(key);
-      continue;
-    }
-    result[key] = value;
-  }
-  if (missing.length > 0) {
-    throw new Error(`Missing required env vars: ${missing.join(", ")}`);
-  }
-  return result;
-}
-function getApiBaseUrl() {
-  loadConfig();
-  return (process.env.FLUNCLE_API_BASE_URL ?? "https://www.fluncle.com").replace(/\/+$/, "");
-}
-function loadConfig() {
-  const profile = getEnvProfile();
-  if (loadedProfile === profile) {
-    return;
-  }
-  loadedProfile = profile;
-  if (false) {}
-  import_dotenv2.config({ path: join2(homedir2(), `.config/fluncle/.env.${profile}`), quiet: true });
-}
-function getEnvProfile() {
-  const profile = process.env.FLUNCLE_ENV ?? defaultEnvProfile;
-  if (!isEnvProfile2(profile)) {
-    throw new Error(`Unknown env profile: ${profile}. Expected local or production.`);
-  }
-  return profile;
-}
-function isEnvProfile2(value) {
-  return envProfiles2.includes(value);
-}
-var import_dotenv2, envProfiles2, defaultEnvProfile = "production", loadedProfile;
-var init_env = __esm(() => {
-  import_dotenv2 = __toESM(require_main(), 1);
-  envProfiles2 = ["local", "production"];
-});
-
 // src/user-token.ts
 import { chmodSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir as homedir3 } from "node:os";
@@ -1400,10 +1400,12 @@ async function resyncYoutube(mixtapeId) {
 }
 async function authYoutubeCommand() {
   const response = await adminApiGet("/api/v1/admin/youtube/auth/start");
-  console.log(`Open this YouTube authorization URL:
+  console.log(`Open this link in the browser you're logged into /admin with:
 
 ${response.authUrl}
 
+It hands you off to Google. Signed out? Log in there and it resumes on its own.
+The link is good for 10 minutes; run this again if it expires.
 After approving access, Google returns to the Fluncle admin callback and stores the refresh token server-side.`);
 }
 async function initiate(mixtapeId, contentLength, contentType) {
@@ -1571,10 +1573,12 @@ async function resyncMixcloud(mixtapeId) {
 }
 async function authMixcloudCommand() {
   const response = await adminApiGet("/api/v1/admin/mixcloud/auth/start");
-  console.log(`Open this Mixcloud authorization URL:
+  console.log(`Open this link in the browser you're logged into /admin with:
 
 ${response.authUrl}
 
+It hands you off to Mixcloud. Signed out? Log in there and it resumes on its own.
+The link is good for 10 minutes; run this again if it expires.
 After approving access, Mixcloud returns to the Fluncle admin callback and stores the access token server-side.`);
 }
 function mixtapeDescription(note, logId) {
@@ -2448,7 +2452,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.200.0".trim() ? "0.200.0".trim() : "0.1.0";
+  currentVersion2 = "0.202.0".trim() ? "0.202.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -2517,18 +2521,6 @@ var init_src = __esm(() => {
       url: `${SITE}/mix`,
       weights: { web: "secondary" }
     },
-    {
-      exposedContent: [
-        "the feed-first Stories surface — full-bleed findings",
-        "/stories/:logId — one finding as a Story"
-      ],
-      kind: "web_route",
-      name: "web.stories",
-      probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
-      route: "/stories",
-      url: `${SITE}/stories`,
-      weights: { web: "secondary" }
-    },
     {
       exposedContent: ["who Fluncle is, what the Galaxy is, how to read a Log ID"],
       kind: "web_route",
@@ -3113,7 +3105,7 @@ var init_src = __esm(() => {
       exposedContent: ["the XML sitemap index of every public page"],
       kind: "discovery",
       name: "discovery.sitemap",
-      operatorNotes: "A sitemap INDEX, not a flat urlset: the URLs live in children at /sitemap/<kind>-<n>.xml, ONE CHILD PER ENTITY TYPE (pages/findings/artists/labels/albums/galaxies/logbook), each auto-paged under Google's 50,000-URL ceiling so a breach cannot happen rather than merely not having happened yet. robots.txt still names this one URL — a crawler discovers the children from here. Splitting per entity type is also the diagnostic: Search Console reports coverage PER sitemap, so each entity type gets its own submitted/indexed count.",
+      operatorNotes: "A sitemap INDEX, not a flat urlset: the URLs live in children at /sitemap/<kind>-<n>.xml, ONE CHILD PER ENTITY TYPE (pages/findings/artists/labels/albums/galaxies/logbook/docs), each auto-paged under Google's 50,000-URL ceiling so a breach cannot happen rather than merely not having happened yet. robots.txt still names this one URL — a crawler discovers the children from here. Splitting per entity type is also the diagnostic: Search Console reports coverage PER sitemap, so each entity type gets its own submitted/indexed count.",
       probeConfig: { cadenceMs: PROBE_CADENCE_MS, kind: "http", timeoutMs: PROBE_TIMEOUT_MS },
       route: "/sitemap.xml",
       url: `${SITE}/sitemap.xml`,
@@ -3122,7 +3114,7 @@ var init_src = __esm(() => {
     {
       apiFormat: "application/xml",
       exposedContent: [
-        "one child sitemap, per entity type: the pages / findings / artists / labels / albums / galaxies / logbook URLs, auto-paged"
+        "one child sitemap, per entity type: the pages / findings / artists / labels / albums / galaxies / logbook / docs URLs, auto-paged"
       ],
       kind: "discovery",
       name: "discovery.sitemap-shard",
@@ -3153,6 +3145,16 @@ var init_src = __esm(() => {
       url: `${SITE}/llms.txt`,
       weights: { web: "primary" }
     },
+    {
+      apiFormat: "text/markdown",
+      exposedContent: ["one developer-doc page as clean Markdown, at `/docs.md/<slug>`"],
+      kind: "discovery",
+      name: "discovery.docs-markdown",
+      operatorNotes: 'The Markdown twin of every /docs page — front-matter-free, the title as the H1, the description as the lede, then the precompiled body (`includeProcessedMarkdown` in source.config.ts → `page.data.getText("processed")`). It is the endpoint behind the page-actions affordance ("View as Markdown", "Copy page", and the Open in ChatGPT/Claude/Cursor links, which carry this URL so the assistant pulls the clean Markdown), and each /docs page advertises it as `<link rel="alternate" type="text/markdown">` (routes/-docs-head.ts). A machine-FETCHED document rather than a page, so it is catalogued as `discovery` next to llms.txt. No probeConfig: the route is slug-parameterized, so there is no fixed URL to GET-probe (the `discovery.oembed` / `web.artist` precedent) — the post-deploy probe skips it for the same reason it skips /artist/:slug/fresh.xml. Source: apps/web/src/routes/docs[.]md.$.ts (a pure splat, mounted at /docs.md/$).',
+      route: "/docs.md/:slug",
+      url: `${SITE}/docs.md/cli`,
+      weights: { web: "tertiary" }
+    },
     {
       apiFormat: "text/markdown",
       exposedContent: ["the entire archive in one ingestible markdown document, every finding"],
@@ -3256,7 +3258,7 @@ var init_src = __esm(() => {
     {
       command: "ssh rave.fluncle.com",
       exposedContent: [
-        "the rave terminal TUI: Latest bangers, Fresh releases, Artist archive, Sonic galaxies, Mixtape archive, Random banger, Submit, Subscribe, Install CLI, System status, About",
+        "the rave terminal TUI: Latest findings, Fresh releases, Artist archive, Sonic galaxies, Mixtape archive, Random banger, Submit, Subscribe, Install CLI, System status, About",
         "deep-register one-shots: `ssh rave.fluncle.com latest|fresh|random`"
       ],
       kind: "ssh",
@@ -5054,10 +5056,12 @@ async function resyncYoutube2(mixtapeId) {
 }
 async function authYoutubeCommand2() {
   const response = await adminApiGet("/api/v1/admin/youtube/auth/start");
-  console.log(`Open this YouTube authorization URL:
+  console.log(`Open this link in the browser you're logged into /admin with:
 
 ${response.authUrl}
 
+It hands you off to Google. Signed out? Log in there and it resumes on its own.
+The link is good for 10 minutes; run this again if it expires.
 After approving access, Google returns to the Fluncle admin callback and stores the refresh token server-side.`);
 }
 async function initiate2(mixtapeId, contentLength, contentType) {
@@ -6394,11 +6398,13 @@ __export(exports_auth, {
 });
 async function authSpotifyCommand() {
   const response = await adminApiGet("/api/v1/admin/spotify/auth/start");
-  console.log(`Open this Spotify authorization URL:
+  console.log(`Open this link in the browser you're logged into /admin with:
 
 ${response.authUrl}
 
-After approving access, Spotify will return to the Fluncle admin callback and store auth server-side.`);
+It hands you off to Spotify. Signed out? Log in there and it resumes on its own.
+The link is good for 10 minutes; run this again if it expires.
+After approving access, Spotify returns to the Fluncle admin callback and stores auth server-side.`);
 }
 var init_auth = __esm(() => {
   init_api();
@@ -6475,10 +6481,12 @@ async function resyncMixcloud2(mixtapeId) {
 }
 async function authMixcloudCommand2() {
   const response = await adminApiGet("/api/v1/admin/mixcloud/auth/start");
-  console.log(`Open this Mixcloud authorization URL:
+  console.log(`Open this link in the browser you're logged into /admin with:
 
 ${response.authUrl}
 
+It hands you off to Mixcloud. Signed out? Log in there and it resumes on its own.
+The link is good for 10 minutes; run this again if it expires.
 After approving access, Mixcloud returns to the Fluncle admin callback and stores the access token server-side.`);
 }
 function mixtapeDescription2(note, logId) {
@@ -6554,10 +6562,12 @@ __export(exports_auth_tiktok, {
 });
 async function authTikTokCommand() {
   const response = await adminApiGet("/api/v1/admin/tiktok/auth/start");
-  console.log(`Open this TikTok authorization URL:
+  console.log(`Open this link in the browser you're logged into /admin with:
 
 ${response.authUrl}
 
+It hands you off to TikTok. Signed out? Log in there and it resumes on its own.
+The link is good for 10 minutes; run this again if it expires.
 After approving access, TikTok returns to the Fluncle admin callback and stores the refresh token server-side.`);
 }
 var init_auth_tiktok = __esm(() => {
@@ -9352,6 +9362,60 @@ function isEnvProfile(value) {
 var spotifyPlaylistUrl = "https://open.spotify.com/playlist/1m5LADqpLjiBERdtqrIiL0";
 var telegramUrl = "https://t.me/fluncle";
 
+// src/live.ts
+init_env();
+var NEBULA_VIOLET = "\x1B[38;2;171;123;255m";
+var RESET = "\x1B[0m";
+var TIMEOUT_MS = 1500;
+function shouldSkip(args) {
+  if (process.env.FLUNCLE_NO_LIVE_CALLOUT === "1") {
+    return true;
+  }
+  if (process.env.CI) {
+    return true;
+  }
+  if (args.length === 0) {
+    return true;
+  }
+  const first = args[0];
+  if (first === "admin" || first === "help") {
+    return true;
+  }
+  return args.some((arg) => arg === "--json" || arg === "--help" || arg === "-h" || arg === "--version" || arg === "-V");
+}
+function displayUrl(url) {
+  return url.replace(/^https?:\/\/(www\.)?/, "");
+}
+async function maybePrintLiveCallout(args) {
+  if (shouldSkip(args) || process.stdout.isTTY !== true) {
+    return;
+  }
+  try {
+    const controller = new AbortController;
+    const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    let data;
+    try {
+      const response = await fetch(`${getApiBaseUrl()}/api/v1/status`, {
+        signal: controller.signal
+      });
+      if (!response.ok) {
+        return;
+      }
+      data = await response.json();
+    } finally {
+      clearTimeout(timer);
+    }
+    const live = data.live;
+    if (!live?.on) {
+      return;
+    }
+    const text = `On the decks, live now: ${displayUrl(live.url)}`;
+    const line = process.env.NO_COLOR ? text : `${NEBULA_VIOLET}${text}${RESET}`;
+    console.log(`${line}
+`);
+  } catch {}
+}
+
 // src/output.ts
 import { writeSync } from "node:fs";
 var EAGAIN_WAIT = new Int32Array(new SharedArrayBuffer(4));
@@ -9430,6 +9494,7 @@ async function main(args = process.argv.slice(2)) {
     program2.outputHelp();
     return;
   }
+  await maybePrintLiveCallout(args);
   try {
     assertParseArgsCompatiblePositionals(args);
     assertParseArgsCompatibleOptionValues(args);

package/package.json

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