github-labels-template 0.7.0 → 0.8.0

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 defineCommand7, 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,167 @@ 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/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",
   description: "A CLI tool to apply a curated GitHub labels template to any repository using gh CLI.",
   type: "module",
   bin: {
@@ -1134,15 +1301,15 @@ function getAuthor() {
   return package_default.author ?? "unknown";
 }
 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();
 }
@@ -1150,7 +1317,7 @@ function showBanner(minimal = false) {
 // src/index.ts
 var isHelp = process.argv.includes("--help") || process.argv.includes("-h");
 showBanner(isHelp);
-var main = defineCommand6({
+var main = defineCommand7({
   meta: {
     name: "ghlt",
     version: getVersion(),
@@ -1168,7 +1335,8 @@ var main = defineCommand6({
     wipe: wipe_default,
     migrate: migrate_default,
     generate: generate_default,
-    list: list_default
+    list: list_default,
+    check: check_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",
   "description": "A CLI tool to apply a curated GitHub labels template to any repository using gh CLI.",
   "type": "module",
   "bin": {