github-labels-template 0.6.0 → 0.6.1-staging.3ace40c

package/README.md

@@ -14,7 +14,9 @@ A CLI tool to apply a curated set of GitHub labels to any repository using `gh`
 - 🚀 **One Command Setup**: Apply all labels to any repo with `ghlt apply`
 - 🔍 **Auto-Detect Repo**: Automatically detects the current repository from git remote
 - 🔄 **Smart Conflict Handling**: Skips existing labels by default, `--force` to update
-- 🧹 **Wipe Command**: Remove all existing labels with a confirmation prompt
+- 📋 **List Command**: View all labels on any repo — name, color, and description at a glance
+- 🧹 **Wipe Command**: Remove all or specific labels with a confirmation prompt
+- 🚫 **Apply with Exclusions**: Skip specific labels or entire categories with `--exclude` / `--exclude-category`
 - ✅ **Pre-Flight Checks**: Validates `gh` CLI is installed and authenticated before doing anything
 - 📊 **Clear Output**: Structured logging powered by [@wgtechlabs/log-engine](https://github.com/wgtechlabs/log-engine) with color-coded levels and emoji
 - 🎨 **ASCII Banner**: Beautiful ANSI Shadow figlet banner with version and author info
@@ -83,6 +85,15 @@ ghlt apply --category community --label bug
 # Combine with force and repo
 ghlt apply --category type --force --repo owner/repo
 
+# Apply all labels except specific ones
+ghlt apply --exclude "bug,enhancement"
+
+# Apply all labels except an entire category
+ghlt apply --exclude-category type
+
+# Combine: apply all community labels except hacktoberfest
+ghlt apply --category community --exclude hacktoberfest
+
 # Include custom labels from labels-custom.json
 ghlt apply --custom
 
@@ -90,6 +101,16 @@ ghlt apply --custom
 ghlt apply --custom --category type
 ```
 
+### List Labels
+
+```bash
+# List all labels on the current repo
+ghlt list
+
+# List labels on a specific repo
+ghlt list --repo owner/repo
+```
+
 ### Generate Labels (AI)
 
 Generate custom labels using GitHub Copilot — following the Clean Labels convention. Requires a [GitHub Copilot](https://github.com/features/copilot) subscription.
@@ -145,6 +166,18 @@ ghlt wipe --repo owner/repo
 
 # Skip confirmation prompt
 ghlt wipe --yes
+
+# Remove specific labels
+ghlt wipe --label "bug,enhancement"
+
+# Remove all labels from a category
+ghlt wipe --category type
+
+# Remove labels from multiple categories
+ghlt wipe --category "type,status"
+
+# Include custom labels in the selective wipe scope
+ghlt wipe --category type --custom
 ```
 
 ### Preview Landing Page
@@ -243,24 +276,30 @@ Broad software layers — universal across any project.
 ghlt — GitHub Labels Template CLI
 
 USAGE
-  ghlt [OPTIONS] apply|wipe|migrate|generate|preview
+  ghlt [OPTIONS] apply|wipe|migrate|generate|list|preview
 
 OPTIONS
   -v, --version              Show version number
 
 COMMANDS
   apply      Apply labels from the template to a repository
-  wipe       Remove all existing labels from a repository
+  wipe       Remove all or specific labels from a repository
   migrate    Wipe all existing labels and apply the template (clean slate)
   generate   Generate custom labels using AI (requires GitHub Copilot)
+  list       List all labels in a repository
   preview    Preview the landing page locally in your browser
 
 OPTIONS (apply)
+  -r, --repo <owner/repo>        Target repository (default: auto-detect)
+  -f, --force                    Overwrite existing labels
+  -l, --label <name>             Apply specific label(s) by name (comma-separated)
+  -c, --category <name>          Apply labels from specific category(ies) (comma-separated)
+  -e, --exclude <name>           Exclude specific label(s) by name (comma-separated)
+      --exclude-category <name>  Exclude labels from specific category(ies) (comma-separated)
+      --custom                   Include custom labels from labels-custom.json
+
+OPTIONS (list)
   -r, --repo <owner/repo>   Target repository (default: auto-detect)
-  -f, --force                Overwrite existing labels
-  -l, --label <name>         Apply specific label(s) by name (comma-separated)
-  -c, --category <name>      Apply labels from specific category(ies) (comma-separated)
-      --custom               Include custom labels from labels-custom.json
 
 OPTIONS (migrate)
   -r, --repo <owner/repo>   Target repository (default: auto-detect)
@@ -275,6 +314,9 @@ OPTIONS (generate)
 OPTIONS (wipe)
   -r, --repo <owner/repo>   Target repository (default: auto-detect)
   -y, --yes                  Skip confirmation prompt
+  -l, --label <name>         Remove specific label(s) by name (comma-separated)
+  -c, --category <name>      Remove labels from specific category(ies) (comma-separated)
+      --custom               Include custom labels when using --label or --category
 
 OPTIONS (preview)
   -p, --port <number>        Port to serve on (default: 3000)

package/dist/index.js

@@ -52,6 +52,28 @@ async function detectRepo() {
     return null;
   }
 }
+async function listLabelsDetailed(repo) {
+  const { exitCode, stdout } = await run([
+    "label",
+    "list",
+    "--repo",
+    repo,
+    "--json",
+    "name,color,description",
+    "--limit",
+    "100"
+  ]);
+  if (exitCode !== 0)
+    return [];
+  const text = stdout.trim();
+  if (!text)
+    return [];
+  try {
+    return JSON.parse(text);
+  } catch {
+    return [];
+  }
+}
 async function listLabels(repo) {
   const { exitCode, stdout } = await run([
     "label",
@@ -161,7 +183,9 @@ function filterLabels(allLabels, options) {
   const warnings = [];
   const labelFilter = options.label ? options.label.split(",").map((l) => l.trim().toLowerCase()).filter(Boolean) : null;
   const categoryFilter = options.category ? options.category.split(",").map((c) => c.trim().toLowerCase()).filter(Boolean) : null;
-  if (!labelFilter && !categoryFilter) {
+  const excludeLabelFilter = options.excludeLabel ? options.excludeLabel.split(",").map((l) => l.trim().toLowerCase()).filter(Boolean) : null;
+  const excludeCategoryFilter = options.excludeCategory ? options.excludeCategory.split(",").map((c) => c.trim().toLowerCase()).filter(Boolean) : null;
+  if (!labelFilter && !categoryFilter && !excludeLabelFilter && !excludeCategoryFilter) {
     return {
       entries: Object.entries(allLabels),
       warnings
@@ -183,7 +207,25 @@ function filterLabels(allLabels, options) {
       }
     }
   }
-  const entries = Object.entries(allLabels).map(([category, categoryLabels]) => {
+  if (excludeCategoryFilter) {
+    for (const cat of excludeCategoryFilter) {
+      if (!validCategories.includes(cat)) {
+        warnings.push(`Unknown exclude category "${cat}". Valid categories: ${validCategories.join(", ")}`);
+      }
+    }
+  }
+  if (excludeLabelFilter) {
+    const allLabelNames = Object.values(allLabels).flat().map((l) => l.name.toLowerCase());
+    for (const name of excludeLabelFilter) {
+      if (!allLabelNames.includes(name)) {
+        warnings.push(`Exclude label "${name}" not found in the template.`);
+      }
+    }
+  }
+  const included = Object.entries(allLabels).map(([category, categoryLabels]) => {
+    if (!labelFilter && !categoryFilter) {
+      return [category, categoryLabels];
+    }
     const categoryMatches = categoryFilter?.includes(category.toLowerCase()) ?? false;
     if (categoryMatches) {
       return [category, categoryLabels];
@@ -194,6 +236,14 @@ function filterLabels(allLabels, options) {
     }
     return [category, []];
   }).filter(([, categoryLabels]) => categoryLabels.length > 0);
+  const entries = included.filter(([category]) => excludeCategoryFilter ? !excludeCategoryFilter.includes(category.toLowerCase()) : true).map(([category, categoryLabels]) => {
+    if (!excludeLabelFilter)
+      return [category, categoryLabels];
+    return [
+      category,
+      categoryLabels.filter((l) => !excludeLabelFilter.includes(l.name.toLowerCase()))
+    ];
+  }).filter(([, categoryLabels]) => categoryLabels.length > 0);
   return { entries, warnings };
 }
 
@@ -306,6 +356,15 @@ var apply_default = defineCommand({
       type: "boolean",
       default: false,
       description: "Include custom labels from labels-custom.json (generated via ghlt generate)"
+    },
+    exclude: {
+      type: "string",
+      alias: "e",
+      description: 'Exclude specific label(s) by name. Comma-separated for multiple (e.g., --exclude "bug,enhancement")'
+    },
+    "exclude-category": {
+      type: "string",
+      description: 'Exclude labels from specific category(ies). Comma-separated for multiple (e.g., --exclude-category "type,status")'
     }
   },
   async run({ args }) {
@@ -350,7 +409,9 @@ var apply_default = defineCommand({
     }
     const { entries: filteredEntries, warnings } = filterLabels(labelPool, {
       label: args.label,
-      category: args.category
+      category: args.category,
+      excludeLabel: args.exclude,
+      excludeCategory: args["exclude-category"]
     });
     for (const w of warnings) {
       warn(w);
@@ -361,6 +422,12 @@ var apply_default = defineCommand({
     if (args.label) {
       info(`Applying specific labels: ${args.label}`);
     }
+    if (args["exclude-category"]) {
+      info(`Excluding categories: ${args["exclude-category"]}`);
+    }
+    if (args.exclude) {
+      info(`Excluding labels: ${args.exclude}`);
+    }
     if (filteredEntries.length === 0) {
       warn("No labels matched the specified filter(s).");
       return;
@@ -440,6 +507,21 @@ var wipe_default = defineCommand2({
       alias: "y",
       default: false,
       description: "Skip confirmation prompt"
+    },
+    label: {
+      type: "string",
+      alias: "l",
+      description: 'Remove specific label(s) by name. Comma-separated for multiple (e.g., --label "bug,enhancement")'
+    },
+    category: {
+      type: "string",
+      alias: "c",
+      description: 'Remove labels from specific category(ies). Comma-separated for multiple (e.g., --category "type,status")'
+    },
+    custom: {
+      type: "boolean",
+      default: false,
+      description: "Include custom labels from labels-custom.json when using --label or --category"
     }
   },
   async run({ args }) {
@@ -462,14 +544,57 @@ var wipe_default = defineCommand2({
       info("No labels found. Nothing to wipe.");
       return;
     }
+    const isSelective = !!(args.label || args.category);
+    let toDelete;
+    if (isSelective) {
+      const labelPool = {
+        ...labels_default
+      };
+      if (args.custom) {
+        const custom = loadCustomLabels();
+        for (const [cat, catLabels] of Object.entries(custom)) {
+          if (!labelPool[cat])
+            labelPool[cat] = [];
+          for (const label of catLabels) {
+            const exists = labelPool[cat].some((l) => l.name.toLowerCase() === label.name.toLowerCase());
+            if (!exists)
+              labelPool[cat].push(label);
+          }
+        }
+      }
+      const { entries: filteredEntries, warnings } = filterLabels(labelPool, {
+        label: args.label,
+        category: args.category
+      });
+      for (const w of warnings) {
+        warn(w);
+      }
+      if (filteredEntries.length === 0) {
+        warn("No labels matched the specified filter(s).");
+        return;
+      }
+      const existingSet = new Set(existing.map((n) => n.toLowerCase()));
+      toDelete = filteredEntries.flatMap(([, categoryLabels]) => categoryLabels.map((l) => l.name)).filter((name) => existingSet.has(name.toLowerCase()));
+      if (toDelete.length === 0) {
+        info("None of the specified labels exist on the repo. Nothing to remove.");
+        return;
+      }
+      if (args.label)
+        info(`Removing specific labels: ${args.label}`);
+      if (args.category)
+        info(`Removing labels from category: ${args.category}`);
+    } else {
+      toDelete = existing;
+    }
     if (!args.yes) {
-      const confirmed = await confirmPrompt(pc3.bold(pc3.red(`This will delete all ${existing.length} labels from ${repo}.`)));
+      const message = isSelective ? pc3.bold(pc3.red(`This will delete ${toDelete.length} label(s) from ${repo}.`)) : pc3.bold(pc3.red(`This will delete all ${toDelete.length} labels from ${repo}.`));
+      const confirmed = await confirmPrompt(message);
       if (!confirmed)
         return;
     }
     heading("Deleting Labels");
     const counts = { deleted: 0, failed: 0 };
-    for (const name of existing) {
+    for (const name of toDelete) {
       const ok = await deleteLabel(repo, name);
       if (ok) {
         success(`${name} (deleted)`);
@@ -483,85 +608,8 @@ var wipe_default = defineCommand2({
   }
 });
 
-// src/commands/preview.ts
-import { defineCommand as defineCommand3 } from "citty";
-import { resolve as resolve2, join } from "path";
-import { readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
-import { createServer } from "http";
-var MIME_TYPES = {
-  ".html": "text/html",
-  ".css": "text/css",
-  ".js": "application/javascript",
-  ".json": "application/json",
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".svg": "image/svg+xml",
-  ".ico": "image/x-icon",
-  ".woff": "font/woff",
-  ".woff2": "font/woff2"
-};
-function getMimeType(filePath) {
-  const ext = filePath.slice(filePath.lastIndexOf("."));
-  return MIME_TYPES[ext] || "application/octet-stream";
-}
-var preview_default = defineCommand3({
-  meta: {
-    name: "preview",
-    description: "Preview the landing page locally in your browser"
-  },
-  args: {
-    port: {
-      type: "string",
-      alias: "p",
-      default: "3000",
-      description: "Port to serve on (default: 3000)"
-    }
-  },
-  async run({ args }) {
-    const docsDir = resolve2(import.meta.dirname ?? ".", "..", "..", "docs");
-    if (!existsSync2(docsDir)) {
-      error("docs/ directory not found. Nothing to preview.");
-      process.exit(1);
-    }
-    const indexPath = join(docsDir, "index.html");
-    if (!existsSync2(indexPath)) {
-      error("docs/index.html not found. Nothing to preview.");
-      process.exit(1);
-    }
-    const port = parseInt(args.port, 10) || 3000;
-    const server = createServer((req, res) => {
-      const url = req.url === "/" ? "/index.html" : req.url || "/index.html";
-      const filePath = join(docsDir, url);
-      if (!filePath.startsWith(docsDir)) {
-        res.writeHead(403);
-        res.end("Forbidden");
-        return;
-      }
-      if (!existsSync2(filePath)) {
-        res.writeHead(404);
-        res.end("Not Found");
-        return;
-      }
-      try {
-        const content = readFileSync2(filePath);
-        res.writeHead(200, { "Content-Type": getMimeType(filePath) });
-        res.end(content);
-      } catch {
-        res.writeHead(500);
-        res.end("Internal Server Error");
-      }
-    });
-    server.listen(port, () => {
-      const url = `http://localhost:${port}`;
-      success(`Landing page preview running at ${url}`);
-      info("Press Ctrl+C to stop the server");
-    });
-    await new Promise(() => {});
-  }
-});
-
 // src/commands/generate.ts
-import { defineCommand as defineCommand4 } from "citty";
+import { defineCommand as defineCommand3 } from "citty";
 import { select, input, confirm } from "@inquirer/prompts";
 
 // src/utils/copilot.ts
@@ -705,7 +753,7 @@ var CATEGORIES = [
 function formatLabelChoice(label, index) {
   return `${pc4.bold(label.name)} ${pc4.dim(`#${label.color}`)} — ${label.description}`;
 }
-var generate_default = defineCommand4({
+var generate_default = defineCommand3({
   meta: {
     name: "generate",
     description: "Generate custom labels using AI (requires GitHub Copilot subscription)"
@@ -865,9 +913,9 @@ var generate_default = defineCommand4({
 });
 
 // src/commands/migrate.ts
-import { defineCommand as defineCommand5 } from "citty";
+import { defineCommand as defineCommand4 } from "citty";
 import pc5 from "picocolors";
-var migrate_default = defineCommand5({
+var migrate_default = defineCommand4({
   meta: {
     name: "migrate",
     description: "Wipe all existing labels and apply the template (clean slate)"
@@ -970,13 +1018,58 @@ var migrate_default = defineCommand5({
   }
 });
 
+// src/commands/list.ts
+import { defineCommand as defineCommand5 } from "citty";
+import pc6 from "picocolors";
+var list_default = defineCommand5({
+  meta: {
+    name: "list",
+    description: "List all labels in a repository"
+  },
+  args: {
+    repo: {
+      type: "string",
+      alias: "r",
+      description: "Target repository (owner/repo). Defaults to current repo."
+    }
+  },
+  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);
+    }
+    info(`Target: ${repo}`);
+    const labels = await listLabelsDetailed(repo);
+    if (labels.length === 0) {
+      info("No labels found.");
+      return;
+    }
+    heading(`Labels (${labels.length} total)`);
+    for (const label of labels) {
+      const name = pc6.bold(label.name.padEnd(30));
+      const color = pc6.dim(`#${label.color}`);
+      const desc = label.description ? pc6.dim(label.description) : "";
+      console.log(`  ${name} ${color}  ${desc}`);
+    }
+  }
+});
+
 // src/ui/banner.ts
 import figlet from "figlet";
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 // package.json
 var package_default = {
   name: "github-labels-template",
-  version: "0.6.0",
+  version: "0.6.1-staging.3ace40c",
   description: "A CLI tool to apply a curated GitHub labels template to any repository using gh CLI.",
   type: "module",
   bin: {
@@ -1041,15 +1134,15 @@ function getAuthor() {
   return package_default.author ?? "unknown";
 }
 function showBanner(minimal = false) {
-  console.log(pc6.cyan(`
+  console.log(pc7.cyan(`
 ` + LOGO));
-  console.log(`  ${pc6.dim("v" + getVersion())} ${pc6.dim("—")} ${pc6.dim("Built by " + getAuthor())}`);
+  console.log(`  ${pc7.dim("v" + getVersion())} ${pc7.dim("—")} ${pc7.dim("Built by " + getAuthor())}`);
   if (!minimal) {
-    console.log(`  ${pc6.dim(package_default.description)}`);
+    console.log(`  ${pc7.dim(package_default.description)}`);
     console.log();
-    console.log(`  ${pc6.yellow("Star")}        ${pc6.cyan("https://gh.waren.build/github-labels-template")}`);
-    console.log(`  ${pc6.green("Contribute")}  ${pc6.cyan("https://gh.waren.build/github-labels-template/blob/main/CONTRIBUTING.md")}`);
-    console.log(`  ${pc6.magenta("Sponsor")}     ${pc6.cyan("https://warengonzaga.com/sponsor")}`);
+    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();
 }
@@ -1074,8 +1167,8 @@ var main = defineCommand6({
     apply: apply_default,
     wipe: wipe_default,
     migrate: migrate_default,
-    preview: preview_default,
-    generate: generate_default
+    generate: generate_default,
+    list: list_default
   },
   run({ args }) {
     if (args.version) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "github-labels-template",
-  "version": "0.6.0",
+  "version": "0.6.1-staging.3ace40c",
   "description": "A CLI tool to apply a curated GitHub labels template to any repository using gh CLI.",
   "type": "module",
   "bin": {