cozyclay 3.1.3 → 3.1.4

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## 3.1.4 - 2026-10-24
+
+Starring CozyClay from the terminal takes one key when the GitHub CLI is signed in.
+
+CLI
+
+- The one-time star question on exit stars NomaDamas/CozyClay through `gh`
+  when `gh` is installed and signed in: answer `y` and it is done, with no
+  browser. An account that already starred the repo is not asked. Without
+  `gh` the question opens the repo page as before, and `--no-star`,
+  `COZYCLAY_NO_STAR` and CI still turn it off.
+
 ## 3.1.3 - 2026-10-24
 
 More ways to connect a model (Claude Pro/Max, OpenAI-compatible servers, MiniMax M3.1 Flash), a Simplified Chinese UI, and easier project opening.

package/bin/cozyclay.mjs

@@ -23,6 +23,7 @@ import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
 import { ensureMcpRuntime, runMcp } from "./mcp-runtime.mjs";
 import { openBrowser } from "./open-browser.mjs";
+import { maybeAskForStar } from "./star-prompt.mjs";
 import { checkForUpdate, readUpdateStatus, runUpdate } from "./update-check.mjs";
 import { handleOAuthRequest } from "./codex-auth.mjs";
 import { createAgentHandler } from "./agent/agent-routes.mjs";
@@ -120,12 +121,8 @@ function parseArgs(argv) {
 	return opts;
 }
 
-const REPO_URL = "https://github.com/NomaDamas/CozyClay";
 const STATE_DIR = join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "cozyclay");
 const STATE_FILE = join(STATE_DIR, "state.json");
-// Only worth asking someone who actually used the thing. A prompt three
-// seconds in is a popup; a prompt after a real session is a question.
-const STAR_AFTER_MS = Number(process.env.COZYCLAY_STAR_AFTER_MS ?? 60_000);
 
 async function askFirstLaunchSource() {
 	if (!process.stdin.isTTY || !process.stdout.isTTY) return null;
@@ -197,49 +194,6 @@ function writeState(patch) {
 	}
 }
 
-async function starCount() {
-	try {
-		const res = await fetch("https://api.github.com/repos/NomaDamas/CozyClay", {
-			headers: { accept: "application/vnd.github+json" },
-			signal: AbortSignal.timeout(2500),
-		});
-		if (!res.ok) return null;
-		const body = await res.json();
-		return Number.isInteger(body?.stargazers_count) ? body.stargazers_count : null;
-	} catch {
-		return null;
-	}
-}
-
-// Asked once, on the way out, and never again on this machine. A CLI that
-// nags on every run is worse than one that never asks.
-async function maybeAskForStar(startedAt, opts) {
-	if (!opts.star) return;
-	if (process.env.CI || process.env.COZYCLAY_NO_STAR) return;
-	if (!process.stdin.isTTY || !process.stdout.isTTY) return;
-	if (Date.now() - startedAt < STAR_AFTER_MS) return;
-	if (readState().starPromptedAt) return;
-
-	writeState({ starPromptedAt: new Date().toISOString() });
-	const stars = await starCount();
-	const tally = stars === null ? "" : ` (${stars} so far)`;
-	const rl = createInterface({ input: process.stdin, output: process.stdout });
-	const answer = await new Promise((done) => {
-		const timer = setTimeout(() => done(""), 12_000);
-		rl.question(`\nWas CozyClay any good? A star helps people find it${tally}. Open GitHub? [Y/n] `, (a) => {
-			clearTimeout(timer);
-			done(a);
-		});
-	});
-	rl.close();
-	if (/^(y|yes|)$/i.test(answer.trim())) {
-		openBrowser(REPO_URL);
-		console.log("Thanks. Opening the repo.");
-	} else {
-		console.log(`Fair enough. ${REPO_URL} if you change your mind.`);
-	}
-}
-
 // Read on every launch now, so it must not be able to take the launcher down:
 // the version is cosmetic here, and "0.0.0" just suppresses a bogus notice.
 function readVersion() {
@@ -343,7 +297,7 @@ async function shutdown(exitCode = 0) {
 	shuttingDown = true;
 	if (server?.listening) await new Promise((resolvePromise) => server.close(() => resolvePromise()));
 	try {
-		await maybeAskForStar(startedAt, opts);
+		await maybeAskForStar(startedAt, opts, { readState, writeState });
 	} catch {
 		/* never let the goodbye prompt hold the process hostage */
 	}

package/bin/star-prompt.mjs

@@ -0,0 +1,123 @@
+/**
+ * The one-time "star the repo" question on the way out of `npx cozyclay` (#900).
+ *
+ * With the GitHub CLI installed and signed in, a "y" stars the repo through `gh` on
+ * the spot: no browser hop, which is where most people who meant to star it got lost.
+ * Without gh, a "yes" opens the repo page as before. Asked once per machine, after a
+ * real session, never in CI or without a terminal, and never to an account that has
+ * already starred it. Every failure here is silent: this runs while the launcher exits.
+ */
+import { execFile } from "node:child_process";
+import { createInterface } from "node:readline";
+import { openBrowser } from "./open-browser.mjs";
+
+const REPO = "NomaDamas/CozyClay";
+const REPO_URL = `https://github.com/${REPO}`;
+const STARRED_PATH = `/user/starred/${REPO}`;
+const ANSWER_TIMEOUT_MS = 12_000;
+// Only worth asking someone who actually used the thing. A prompt three
+// seconds in is a popup; a prompt after a real session is a question.
+const STAR_AFTER_MS = Number(process.env.COZYCLAY_STAR_AFTER_MS ?? 60_000);
+
+/** Runs gh and resolves true on exit 0. No gh on PATH, a timeout or an error status is false. */
+function runGh(args) {
+	return new Promise((resolve) => {
+		try {
+			execFile("gh", args, {
+				timeout: 4000,
+				windowsHide: true,
+				env: { ...process.env, GH_PROMPT_DISABLED: "1", GH_NO_UPDATE_NOTIFIER: "1" },
+			}, (error) => resolve(!error));
+		} catch {
+			resolve(false);
+		}
+	});
+}
+
+async function starCount() {
+	try {
+		const res = await fetch(`https://api.github.com/repos/${REPO}`, {
+			headers: { accept: "application/vnd.github+json" },
+			signal: AbortSignal.timeout(2500),
+		});
+		if (!res.ok) return null;
+		const body = await res.json();
+		return Number.isInteger(body?.stargazers_count) ? body.stargazers_count : null;
+	} catch {
+		return null;
+	}
+}
+
+function askLine(question) {
+	const rl = createInterface({ input: process.stdin, output: process.stdout });
+	return new Promise((done) => {
+		const timer = setTimeout(() => {
+			rl.close();
+			done("");
+		}, ANSWER_TIMEOUT_MS);
+		rl.question(question, (answer) => {
+			clearTimeout(timer);
+			rl.close();
+			done(answer);
+		});
+	});
+}
+
+/**
+ * Asked once, on the way out, and never again on this machine. A CLI that nags on
+ * every run is worse than one that never asks. Everything after `state` is injectable
+ * so the test can drive it without a terminal, gh, or the network.
+ */
+export async function maybeAskForStar(startedAt, opts, {
+	readState,
+	writeState,
+	env = process.env,
+	interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY),
+	now = Date.now,
+	minSessionMs = STAR_AFTER_MS,
+	gh = runGh,
+	ask = askLine,
+	stars = starCount,
+	open = openBrowser,
+	log = console.log,
+}) {
+	if (!opts.star) return;
+	if (env.CI || env.COZYCLAY_NO_STAR) return;
+	if (!interactive) return;
+	if (now() - startedAt < minSessionMs) return;
+	if (readState().starPromptedAt) return;
+
+	const promptedAt = new Date(now()).toISOString();
+	const viaGh = await gh(["auth", "status"]);
+	// GET /user/starred/<repo> answers 204 for a starred repo and 404 otherwise.
+	if (viaGh && await gh(["api", STARRED_PATH, "--silent"])) {
+		writeState({ starPromptedAt: promptedAt });
+		return;
+	}
+	writeState({ starPromptedAt: promptedAt });
+	const count = await stars();
+	const tally = count === null ? "" : ` (${count} so far)`;
+
+	if (viaGh) {
+		const answer = await ask(`\nWas CozyClay any good? A star helps people find it${tally}. Star ${REPO} with your gh account? [y/N] `);
+		if (!/^y(es)?$/i.test(answer.trim())) {
+			log(`No problem. ${REPO_URL} if you change your mind.`);
+			return;
+		}
+		if (await gh(["api", "--method", "PUT", STARRED_PATH, "--silent"])) {
+			log(`Starred ${REPO}. Thank you!`);
+			return;
+		}
+		log("gh could not star it, so opening the repo instead.");
+		open(REPO_URL);
+		return;
+	}
+
+	const answer = await ask(`\nWas CozyClay any good? A star helps people find it${tally}. Open GitHub? [Y/n] `);
+	if (/^(y|yes|)$/i.test(answer.trim())) {
+		open(REPO_URL);
+		log("Thanks. Opening the repo.");
+	} else {
+		log(`Fair enough. ${REPO_URL} if you change your mind.`);
+	}
+}

package/dist/app/index.html

@@ -34,7 +34,7 @@
     <title>CozyClay Studio — 3D staging and previs in your browser</title>
 
     <script defer src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "6a4384d1375d4ffc8a30a6346a8ad1a0"}'></script>
-    <script type="module" crossorigin src="/assets/app-DwETmoQZ.js"></script>
+    <script type="module" crossorigin src="/assets/app-KXdgBC-S.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-hePW80VL.js">
     <link rel="modulepreload" crossorigin href="/assets/modulepreload-polyfill-P2Xu9kJm.js">
     <link rel="modulepreload" crossorigin href="/assets/task-board-DFfNa0xg.js">