github-labels-template 0.7.0 → 0.8.0-patch.f835045

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { defineCommand as defineCommand6, runMain } from "citty";
+import { defineCommand as defineCommand8, runMain } from "citty";
 
 // src/commands/apply.ts
 import { defineCommand } from "citty";
@@ -621,21 +621,24 @@ var CATEGORY_NAMES = {
   resolution: "Resolution",
   area: "Area"
 };
-function buildSystemPrompt(category, count) {
+function buildSystemPrompt(category, count, attempt = 1) {
   const categoryTitle = CATEGORY_NAMES[category] ?? category;
   const existingLabels = labels_default[category] ?? [];
   const existingList = existingLabels.map((l) => `  - "${l.name}" (${l.color}) — ${l.description}`).join(`
 `);
+  const variationHint = attempt > 1 ? `IMPORTANT: This is attempt #${attempt}. You MUST generate completely different label names, colors, and descriptions than any previous suggestions. Be creative and explore new angles.` : null;
   return [
-    `You are a GitHub label generator. Generate exactly ${count} label suggestions for the "${categoryTitle}" category.`,
+    `You are a GitHub label generator. The user will describe the kind of label they need. Generate exactly ${count} label suggestions for the "${categoryTitle}" category that DIRECTLY match what the user is asking for.`,
     "",
+    "CRITICAL: Every suggestion MUST be relevant to the user's description. Do NOT generate generic or unrelated labels. Focus on what the user specifically asked for.",
+    ...variationHint ? ["", variationHint, ""] : [""],
     "Each label must follow this exact JSON format:",
     "[",
     `  { "name": "label-name", "color": "hex123", "description": "[${categoryTitle}] Description text [scope]" }`,
     "]",
     "",
     "Rules:",
-    "- name: lowercase, concise (1-3 words), use spaces for multi-word names",
+    "- name: lowercase, concise (1-3 words), use spaces for multi-word names, must reflect the user's request",
     "- color: 6-character hex without #, choose colors that are visually distinct from existing labels",
     `- description: MUST start with [${categoryTitle}] and end with [issues], [PRs], or [issues, PRs]`,
     "- Do NOT duplicate any of these existing labels:",
@@ -645,12 +648,17 @@ function buildSystemPrompt(category, count) {
   ].join(`
 `);
 }
-function buildUserPrompt(description, refinement) {
+function buildUserPrompt(description, refinement, attempt = 1) {
   let prompt = `I need a label for: ${description}`;
   if (refinement) {
     prompt += `
 
 Refinement feedback: ${refinement}`;
+  }
+  if (attempt > 1) {
+    prompt += `
+
+Generate different suggestions from previous attempts. This is attempt #${attempt}, so provide fresh and unique alternatives.`;
   }
   return prompt;
 }
@@ -683,13 +691,13 @@ function parseLabelsResponse(text) {
   });
 }
 async function generateLabels(options) {
-  const { category, description, count = 3, refinement, model } = options;
+  const { category, description, count = 3, refinement, model, attempt = 1 } = options;
   const client = new CopilotClient;
   await client.start();
   try {
     const sessionConfig = {
       systemMessage: {
-        content: buildSystemPrompt(category, count)
+        content: buildSystemPrompt(category, count, attempt)
       }
     };
     if (model) {
@@ -697,7 +705,7 @@ async function generateLabels(options) {
     }
     const session = await client.createSession(sessionConfig);
     try {
-      const userPrompt = buildUserPrompt(description, refinement);
+      const userPrompt = buildUserPrompt(description, refinement, attempt);
       const response = await session.sendAndWait({ content: userPrompt });
       if (!response || !response.data?.content) {
         throw new Error("No response received from Copilot");
@@ -818,6 +826,7 @@ var generate_default = defineCommand3({
     });
     let selectedLabel = null;
     let refinement;
+    let attempt = 1;
     while (!selectedLabel) {
       info(refinement ? "Regenerating with your feedback..." : "Generating label suggestions...");
       let suggestions;
@@ -827,7 +836,8 @@ var generate_default = defineCommand3({
           description,
           count: 3,
           refinement,
-          model: args.model
+          model: args.model,
+          attempt
         });
       } catch (err) {
         error(`Failed to generate labels: ${err instanceof Error ? err.message : String(err)}`);
@@ -837,6 +847,7 @@ var generate_default = defineCommand3({
         });
         if (retry) {
           refinement = undefined;
+          attempt = 1;
           continue;
         }
         return;
@@ -873,10 +884,12 @@ var generate_default = defineCommand3({
           message: "What would you like to change?",
           validate: (value) => value.trim().length > 0 || "Please provide feedback."
         });
+        attempt++;
         continue;
       }
       if (choice === "regenerate") {
         refinement = undefined;
+        attempt++;
         continue;
       }
       const pickIndex = parseInt(choice.replace("pick:", ""), 10);
@@ -1063,13 +1076,171 @@ var list_default = defineCommand5({
   }
 });
 
+// src/commands/check.ts
+import { defineCommand as defineCommand6 } from "citty";
+import pc7 from "picocolors";
+function statusIcon(status) {
+  if (status === "match")
+    return pc7.green("✔");
+  if (status === "missing")
+    return pc7.red("✘");
+  return pc7.yellow("~");
+}
+function statusLabel(status) {
+  switch (status) {
+    case "match":
+      return pc7.dim("match");
+    case "color-mismatch":
+      return pc7.yellow("color mismatch");
+    case "desc-mismatch":
+      return pc7.yellow("description mismatch");
+    case "both-mismatch":
+      return pc7.yellow("color + description mismatch");
+    case "missing":
+      return pc7.red("missing");
+  }
+}
+function isFailing(status, strict) {
+  if (status === "missing")
+    return true;
+  if (strict && status !== "match")
+    return true;
+  return false;
+}
+var check_default = defineCommand6({
+  meta: {
+    name: "check",
+    description: "Check if a repository is using the Clean Label template"
+  },
+  args: {
+    repo: {
+      type: "string",
+      alias: "r",
+      description: "Target repository (owner/repo). Defaults to current repo."
+    },
+    category: {
+      type: "string",
+      alias: "c",
+      description: 'Check specific category(ies) only. Comma-separated (e.g., --category "type,status")'
+    },
+    strict: {
+      type: "boolean",
+      alias: "s",
+      default: false,
+      description: "Strict mode — also flag labels with mismatched color or description"
+    }
+  },
+  async run({ args }) {
+    if (!await checkGhInstalled()) {
+      error("gh CLI is not installed. Install it from https://cli.github.com");
+      process.exit(1);
+    }
+    if (!await checkGhAuth()) {
+      error("Not authenticated. Run `gh auth login` first.");
+      process.exit(1);
+    }
+    const repo = args.repo || await detectRepo();
+    if (!repo) {
+      error("Could not detect repository. Use --repo <owner/repo> or run inside a git repo.");
+      process.exit(1);
+    }
+    const strict = args.strict ?? false;
+    info(`Target: ${repo}`);
+    if (strict)
+      info("Mode: strict (name + color + description)");
+    const repoLabels = await listLabelsDetailed(repo);
+    const repoMap = new Map(repoLabels.map((l) => [l.name.toLowerCase(), l]));
+    const { entries: templateEntries } = filterLabels(labels_default, {
+      category: args.category
+    });
+    const results = [];
+    for (const [category, categoryLabels] of templateEntries) {
+      for (const tmpl of categoryLabels) {
+        const existing = repoMap.get(tmpl.name.toLowerCase());
+        let status;
+        let repoColor;
+        let repoDesc;
+        if (!existing) {
+          status = "missing";
+        } else {
+          const colorMatch = existing.color.toLowerCase() === tmpl.color.toLowerCase();
+          const descMatch = existing.description.trim() === tmpl.description.trim();
+          if (colorMatch && descMatch) {
+            status = "match";
+          } else if (!colorMatch && !descMatch) {
+            status = "both-mismatch";
+            repoColor = existing.color;
+            repoDesc = existing.description;
+          } else if (!colorMatch) {
+            status = "color-mismatch";
+            repoColor = existing.color;
+          } else {
+            status = "desc-mismatch";
+            repoDesc = existing.description;
+          }
+        }
+        results.push({ template: tmpl, category, status, repoColor, repoDesc });
+      }
+    }
+    const byCategory = new Map;
+    for (const result of results) {
+      if (!byCategory.has(result.category))
+        byCategory.set(result.category, []);
+      byCategory.get(result.category).push(result);
+    }
+    console.log("");
+    for (const [category, catResults] of byCategory) {
+      const catTitle = category.charAt(0).toUpperCase() + category.slice(1);
+      const catFailing = catResults.filter((r) => isFailing(r.status, strict)).length;
+      const catStatus = catFailing > 0 ? pc7.red(`${catFailing} issue${catFailing !== 1 ? "s" : ""}`) : pc7.green("all good");
+      console.log(`${pc7.bold(catTitle)} ${pc7.dim(`(${catResults.length})`)} — ${catStatus}`);
+      for (const result of catResults) {
+        const icon = statusIcon(result.status);
+        const name = result.template.name.padEnd(28);
+        const color = pc7.dim(`#${result.template.color}`);
+        const lbl = statusLabel(result.status);
+        let line = `  ${icon} ${name} ${color}  ${lbl}`;
+        if (result.repoColor) {
+          line += pc7.dim(`  (repo: #${result.repoColor})`);
+        }
+        if (result.repoDesc) {
+          line += pc7.dim(`
+    repo desc: "${result.repoDesc}"`);
+        }
+        console.log(line);
+      }
+      console.log("");
+    }
+    const matched = results.filter((r) => r.status === "match").length;
+    const missing = results.filter((r) => r.status === "missing").length;
+    const mismatched = results.filter((r) => r.status !== "match" && r.status !== "missing").length;
+    const total = results.length;
+    const failing = results.filter((r) => isFailing(r.status, strict)).length;
+    const mismatchedStr = mismatched > 0 ? pc7.yellow(`, ${mismatched} mismatched`) : "";
+    const missingStr = missing > 0 ? pc7.red(`, ${missing} missing`) : "";
+    const scoreStr = pc7.bold(`${matched}/${total}`);
+    console.log(`${pc7.bold("Result:")} ${scoreStr} labels matched${mismatchedStr}${missingStr}`);
+    if (failing === 0) {
+      const mismatchHint = !strict && mismatched > 0 ? pc7.dim(`  (${mismatched} mismatch${mismatched !== 1 ? "es" : ""} — use --strict to enforce)`) : "";
+      console.log(`${pc7.bold("Compatible:")} ${pc7.green("✔ Yes")}${strict ? " (strict)" : ""}${mismatchHint}`);
+    } else {
+      console.log(`${pc7.bold("Compatible:")} ${pc7.red("✘ No")} — run ${pc7.bold("ghlt apply")} to fix`);
+      process.exit(1);
+    }
+  }
+});
+
+// src/commands/update.ts
+import { defineCommand as defineCommand7 } from "citty";
+import { execSync } from "child_process";
+
 // src/ui/banner.ts
 import figlet from "figlet";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 // package.json
 var package_default = {
   name: "github-labels-template",
-  version: "0.7.0",
+  version: "0.8.0-patch.f835045",
   description: "A CLI tool to apply a curated GitHub labels template to any repository using gh CLI.",
   type: "module",
   bin: {
@@ -1133,24 +1304,187 @@ function getVersion() {
 function getAuthor() {
   return package_default.author ?? "unknown";
 }
+function showUpdateBanner(latestVersion) {
+  const current = getVersion();
+  const visibleLen = (s) => s.replace(/\x1b\[[0-9;]*m/g, "").length;
+  const line1 = `  ${pc8.bold(`Update available: v${current} → v${latestVersion}`)}  `;
+  const line2 = `  Run ${pc8.bold("ghlt update")} to upgrade.  `;
+  const width = Math.max(visibleLen(line1), visibleLen(line2));
+  const border = "─".repeat(width);
+  console.log(pc8.yellow(`┌${border}┐`));
+  console.log(pc8.yellow("│") + line1 + " ".repeat(width - visibleLen(line1)) + pc8.yellow("│"));
+  console.log(pc8.yellow("│") + line2 + " ".repeat(width - visibleLen(line2)) + pc8.yellow("│"));
+  console.log(pc8.yellow(`└${border}┘`));
+  console.log();
+}
 function showBanner(minimal = false) {
-  console.log(pc7.cyan(`
+  console.log(pc8.cyan(`
 ` + LOGO));
-  console.log(`  ${pc7.dim("v" + getVersion())} ${pc7.dim("—")} ${pc7.dim("Built by " + getAuthor())}`);
+  console.log(`  ${pc8.dim("v" + getVersion())} ${pc8.dim("—")} ${pc8.dim("Built by " + getAuthor())}`);
   if (!minimal) {
-    console.log(`  ${pc7.dim(package_default.description)}`);
+    console.log(`  ${pc8.dim(package_default.description)}`);
     console.log();
-    console.log(`  ${pc7.yellow("Star")}        ${pc7.cyan("https://gh.waren.build/github-labels-template")}`);
-    console.log(`  ${pc7.green("Contribute")}  ${pc7.cyan("https://gh.waren.build/github-labels-template/blob/main/CONTRIBUTING.md")}`);
-    console.log(`  ${pc7.magenta("Sponsor")}     ${pc7.cyan("https://warengonzaga.com/sponsor")}`);
+    console.log(`  ${pc8.yellow("Star")}        ${pc8.cyan("https://gh.waren.build/github-labels-template")}`);
+    console.log(`  ${pc8.green("Contribute")}  ${pc8.cyan("https://gh.waren.build/github-labels-template/blob/main/CONTRIBUTING.md")}`);
+    console.log(`  ${pc8.magenta("Sponsor")}     ${pc8.cyan("https://warengonzaga.com/sponsor")}`);
   }
   console.log();
 }
 
+// src/utils/updater.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync, renameSync } from "fs";
+import { join, dirname } from "path";
+import { homedir, tmpdir } from "os";
+var CACHE_DIR = join(homedir(), ".ghlt");
+var CACHE_FILE = join(CACHE_DIR, "update-check.json");
+var CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+var REGISTRY_URL = "https://registry.npmjs.org/github-labels-template/latest";
+function isNewerVersion(latest, current) {
+  const parse = (v) => v.replace(/^v/, "").split(/[-+]/)[0].split(".").map(Number);
+  const [lMaj, lMin, lPatch] = parse(latest);
+  const [cMaj, cMin, cPatch] = parse(current);
+  if ([lMaj, lMin, lPatch, cMaj, cMin, cPatch].some(isNaN))
+    return false;
+  if (lMaj !== cMaj)
+    return lMaj > cMaj;
+  if (lMin !== cMin)
+    return lMin > cMin;
+  return lPatch > cPatch;
+}
+function readCache(cacheFile = CACHE_FILE) {
+  try {
+    if (!existsSync2(cacheFile))
+      return null;
+    const raw = readFileSync2(cacheFile, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function writeCache(data, cacheFile = CACHE_FILE) {
+  try {
+    const dir = dirname(cacheFile);
+    if (!existsSync2(dir))
+      mkdirSync(dir, { recursive: true });
+    const tmp = join(tmpdir(), `ghlt-update-${process.pid}-${Date.now()}.json`);
+    writeFileSync2(tmp, JSON.stringify(data), "utf-8");
+    renameSync(tmp, cacheFile);
+  } catch {}
+}
+async function fetchLatestVersion() {
+  try {
+    const res = await fetch(REGISTRY_URL);
+    if (!res.ok)
+      return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch (err) {
+    console.debug("Failed to fetch latest version from npm registry:", err);
+    return null;
+  }
+}
+function refreshCacheInBackground(cacheFile = CACHE_FILE) {
+  fetchLatestVersion().then((version) => {
+    if (version) {
+      writeCache({ lastChecked: Date.now(), latestVersion: version }, cacheFile);
+    }
+  }).catch(() => {});
+}
+function checkForUpdate(cacheFile = CACHE_FILE) {
+  if (process.env.CI === "true" || process.env.CI === "1")
+    return null;
+  if (process.env.NO_UPDATE_NOTIFIER)
+    return null;
+  if (process.argv.includes("--no-update-notifier"))
+    return null;
+  const cache = readCache(cacheFile);
+  const now = Date.now();
+  const isStale = !cache || now - cache.lastChecked > CACHE_TTL_MS;
+  if (isStale) {
+    refreshCacheInBackground(cacheFile);
+  }
+  if (cache?.latestVersion && isNewerVersion(cache.latestVersion, getVersion())) {
+    return cache.latestVersion;
+  }
+  return null;
+}
+
+// src/commands/update.ts
+function detectPackageManager() {
+  try {
+    execSync("bun --version", { stdio: "ignore" });
+    return "bun";
+  } catch {
+    return "npm";
+  }
+}
+function getUpdateCommand(pm) {
+  if (pm === "bun")
+    return "bun add -g github-labels-template";
+  return "npm install -g github-labels-template";
+}
+var update_default = defineCommand7({
+  meta: {
+    name: "update",
+    description: "Update ghlt to the latest published version"
+  },
+  args: {
+    check: {
+      type: "boolean",
+      default: false,
+      description: "Only check if an update is available without installing"
+    },
+    "dry-run": {
+      type: "boolean",
+      default: false,
+      description: "Alias for --check — report availability without updating"
+    }
+  },
+  async run({ args }) {
+    const current = getVersion();
+    info(`Current version: v${current}`);
+    const latest = await fetchLatestVersion();
+    if (!latest) {
+      error("Could not fetch the latest version. Check your internet connection.");
+      process.exit(1);
+    }
+    info(`Latest version:  v${latest}`);
+    writeCache({ lastChecked: Date.now(), latestVersion: latest });
+    if (!isNewerVersion(latest, current)) {
+      success("Already on the latest version.");
+      return;
+    }
+    if (args.check || args["dry-run"]) {
+      info(`Update available: v${current} → v${latest}`);
+      info(`Run 'ghlt update' to upgrade.`);
+      return;
+    }
+    info("Updating ghlt...");
+    try {
+      const pm = detectPackageManager();
+      const cmd = getUpdateCommand(pm);
+      info(`Running: ${cmd}`);
+      execSync(cmd, { stdio: "inherit" });
+      success(`ghlt updated to v${latest}`);
+    } catch {
+      error("Update failed. Try running the update command manually:");
+      console.log(`  npm install -g github-labels-template`);
+      process.exit(1);
+    }
+  }
+});
+
 // src/index.ts
 var isHelp = process.argv.includes("--help") || process.argv.includes("-h");
+var isUpdateCommand = process.argv.includes("update");
 showBanner(isHelp);
-var main = defineCommand6({
+if (!isUpdateCommand) {
+  const availableUpdate = checkForUpdate();
+  if (availableUpdate) {
+    showUpdateBanner(availableUpdate);
+  }
+}
+var main = defineCommand8({
   meta: {
     name: "ghlt",
     version: getVersion(),
@@ -1168,7 +1502,9 @@ var main = defineCommand6({
     wipe: wipe_default,
     migrate: migrate_default,
     generate: generate_default,
-    list: list_default
+    list: list_default,
+    check: check_default,
+    update: update_default
   },
   run({ args }) {
     if (args.version) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-labels-template",
-  "version": "0.7.0",
+  "version": "0.8.0-patch.f835045",
   "description": "A CLI tool to apply a curated GitHub labels template to any repository using gh CLI.",
   "type": "module",
   "bin": {