@drakulavich/kesha-voice-kit 1.2.1 → 1.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drakulavich/kesha-voice-kit",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Open-source voice toolkit for Apple Silicon. Speech-to-text, language detection. 25 languages.",
   "type": "module",
   "bin": {

package/src/cli.ts

@@ -4,7 +4,8 @@ import { defineCommand, runMain } from "citty";
 import { detect } from "tinyld";
 import { transcribe } from "./lib";
 import { downloadEngine } from "./engine-install";
-import { detectAudioLanguageEngine, detectTextLanguageEngine } from "./engine";
+import { detectAudioLanguageEngine, detectTextLanguageEngine, getEngineBinPath } from "./engine";
+import { readStarSeen, shouldShowStarPrompt, writeStarSeen } from "./star";
 import type { LangDetectResult } from "./engine";
 import { log } from "./log";
 import { say, SayError } from "./say";
@@ -50,6 +51,24 @@ function resolveBackendFlag(coreml: boolean, onnx: boolean): string | undefined
 }
 
 async function askForStar() {
+  // Gate on major-or-minor bump only — patch releases and re-installs of the
+  // same version shouldn't nag. First-ever install (no marker) still prompts.
+  const currentVersion = typeof pkg.version === "string" ? pkg.version : null;
+  if (!currentVersion) return;
+  const binPath = getEngineBinPath();
+  const seen = readStarSeen(binPath);
+  if (!shouldShowStarPrompt(currentVersion, seen)) {
+    return;
+  }
+  // Record the version up front so a single run never prompts twice, even
+  // if the gh subprocess below throws.
+  try {
+    writeStarSeen(binPath, currentVersion);
+  } catch {
+    // Non-fatal — falling through to the prompt is still OK, just means we
+    // may nag again on the next install if the write failed for IO reasons.
+  }
+
   const gh = Bun.which("gh");
   if (!gh) {
     log.info("\nIf you enjoy Kesha Voice Kit, consider starring the repo:");

package/src/star.ts

@@ -0,0 +1,57 @@
+import { existsSync, readFileSync, writeFileSync } from "fs";
+
+/**
+ * Version-bump gate for the "star the repo" prompt in `kesha install`.
+ *
+ * Prompts are valuable on first install and on meaningful upgrades (new
+ * features) but annoying on patch-only bumps. This module persists the
+ * last-seen version to a marker file next to the engine binary and only
+ * returns true on a major-or-minor bump.
+ */
+export function starSeenPath(binPath: string): string {
+  return `${binPath}.star-seen`;
+}
+
+export function readStarSeen(binPath: string): string | null {
+  try {
+    const v = readFileSync(starSeenPath(binPath), "utf-8").trim();
+    return v.length > 0 ? v : null;
+  } catch {
+    return null;
+  }
+}
+
+export function writeStarSeen(binPath: string, version: string): void {
+  writeFileSync(starSeenPath(binPath), `${version}\n`);
+}
+
+function parseMajorMinor(v: string): [number, number] | null {
+  const parts = v.split(".");
+  if (parts.length < 2) return null;
+  const major = Number(parts[0]);
+  const minor = Number(parts[1]);
+  if (!Number.isFinite(major) || !Number.isFinite(minor)) return null;
+  return [major, minor];
+}
+
+/**
+ * Returns true iff `current` represents a major-or-minor bump over `seen`.
+ * - `seen === null` → true (first install, always prompt once).
+ * - Same or downgraded version → false.
+ * - Patch-only bump → false (annoying on every install).
+ * - Unparseable either side → false (don't nag when we can't reason).
+ */
+export function shouldShowStarPrompt(current: string, seen: string | null): boolean {
+  if (seen === null) return true;
+  const c = parseMajorMinor(current);
+  const s = parseMajorMinor(seen);
+  if (!c || !s) return false;
+  if (c[0] > s[0]) return true;
+  if (c[0] === s[0] && c[1] > s[1]) return true;
+  return false;
+}
+
+/** True when a star-seen marker already exists for this install. */
+export function hasStarMarker(binPath: string): boolean {
+  return existsSync(starSeenPath(binPath));
+}