@braingrid/cli 0.2.26 → 0.2.27

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.27] - 2025-01-27
+
+### Added
+
+- **Requirement tagging support**
+  - New `--tags` option for `requirement create` and `specify` commands
+  - Accepts comma-separated tags (max 5 per requirement)
+  - Tags are validated, trimmed, and empty values filtered
+  - Tags displayed in all output formats (table, markdown, XML, JSON)
+
 ## [0.2.26] - 2025-01-20
 
 ### Added

package/dist/cli.js

@@ -25,7 +25,7 @@ import axios from "axios";
 
 // src/build-config.ts
 var BUILD_ENV = true ? "production" : process.env.NODE_ENV === "test" ? "development" : "production";
-var CLI_VERSION = true ? "0.2.26" : "0.0.0-test";
+var CLI_VERSION = true ? "0.2.27" : "0.0.0-test";
 var PRODUCTION_CONFIG = {
   apiUrl: "https://app.braingrid.ai",
   workosAuthUrl: "https://auth.braingrid.ai",
@@ -2744,6 +2744,11 @@ function formatRequirementOutput(requirement2, options) {
   }
   message += `${chalk5.bold("Status:")} ${requirement2.status}
 `;
+  if (requirement2.tags && requirement2.tags.length > 0) {
+    const tagNames = requirement2.tags.map((tag) => tag.name).join(", ");
+    message += `${chalk5.bold("Tags:")} ${tagNames}
+`;
+  }
   if (requirement2.assignee) {
     const assigneeName = requirement2.assignee.first_name || requirement2.assignee.last_name ? `${requirement2.assignee.first_name || ""} ${requirement2.assignee.last_name || ""}`.trim() : requirement2.assignee.email;
     message += `${chalk5.bold("Assigned to:")} ${assigneeName} (${requirement2.assignee.email})
@@ -2890,15 +2895,16 @@ function formatRequirementListMarkdown(requirements, pagination) {
     md += "_No requirements found._\n";
     return md;
   }
-  md += "| Short ID | Status | Name | Branch | Progress |\n";
-  md += "|----------|--------|------|--------|----------|\n";
+  md += "| Short ID | Status | Name | Branch | Tags | Progress |\n";
+  md += "|----------|--------|------|--------|------|----------|\n";
   for (const req of requirements) {
     const shortId = req.short_id || req.id.slice(0, 11);
     const status = req.status;
     const name = req.name;
     const branch = req.branch || "N/A";
+    const tags = req.tags && req.tags.length > 0 ? req.tags.map((t) => t.name).join(", ") : "-";
     const progress = req.task_progress ? `${req.task_progress.progress_percentage}%` : "N/A";
-    md += `| ${shortId} | ${status} | ${name} | ${branch} | ${progress} |
+    md += `| ${shortId} | ${status} | ${name} | ${branch} | ${tags} | ${progress} |
 `;
   }
   if (pagination) {
@@ -2971,6 +2977,15 @@ function formatRequirementListXml(requirements, pagination) {
 `;
       xml += "      </assignee>\n";
     }
+    if (req.tags && req.tags.length > 0) {
+      xml += `      <tags count="${req.tags.length}">
+`;
+      for (const tag of req.tags) {
+        xml += `        <tag>${escapeXml(tag.name)}</tag>
+`;
+      }
+      xml += "      </tags>\n";
+    }
     xml += `      <created_at>${escapeXml(req.created_at)}</created_at>
 `;
     xml += `      <updated_at>${escapeXml(req.updated_at)}</updated_at>
@@ -3087,6 +3102,12 @@ function formatRequirementBuildMarkdown(requirement2, options) {
   md += `**Status:** ${requirement2.status}
 
 `;
+  if (requirement2.tags && requirement2.tags.length > 0) {
+    const tagNames = requirement2.tags.map((tag) => tag.name).join(", ");
+    md += `**Tags:** ${tagNames}
+
+`;
+  }
   if (requirement2.assignee) {
     const assigneeName = requirement2.assignee.first_name || requirement2.assignee.last_name ? `${requirement2.assignee.first_name || ""} ${requirement2.assignee.last_name || ""}`.trim() : requirement2.assignee.email;
     md += `**Assigned to:** ${assigneeName} (${requirement2.assignee.email})
@@ -3223,6 +3244,15 @@ function formatRequirementBuildXml(requirement2) {
     xml += `  <branch>${escapeXml(requirement2.branch)}</branch>
 `;
   }
+  if (requirement2.tags && requirement2.tags.length > 0) {
+    xml += `  <tags count="${requirement2.tags.length}">
+`;
+    for (const tag of requirement2.tags) {
+      xml += `    <tag>${escapeXml(tag.name)}</tag>
+`;
+    }
+    xml += "  </tags>\n";
+  }
   if (requirement2.assignee) {
     xml += "  <assignee>\n";
     xml += `    <email>${escapeXml(requirement2.assignee.email)}</email>
@@ -3976,6 +4006,22 @@ var RequirementService = class {
   }
 };
 
+// src/utils/tag-validation.ts
+var MAX_TAGS = 5;
+function validateTags(tagsString) {
+  if (!tagsString || tagsString.trim().length === 0) {
+    return { valid: true, tags: [] };
+  }
+  const tags = tagsString.split(",").map((tag) => tag.trim()).filter((tag) => tag.length > 0);
+  if (tags.length > MAX_TAGS) {
+    return {
+      valid: false,
+      error: `Maximum ${MAX_TAGS} tags allowed`
+    };
+  }
+  return { valid: true, tags };
+}
+
 // src/handlers/requirement.handlers.ts
 function getServices2() {
   const config = getConfig();
@@ -4203,11 +4249,23 @@ async function handleRequirementCreate(opts) {
         };
       }
     }
+    let validatedTags;
+    if (opts.tags) {
+      const tagResult = validateTags(opts.tags);
+      if (!tagResult.valid) {
+        return {
+          success: false,
+          message: chalk7.red(`\u274C ${tagResult.error}`)
+        };
+      }
+      validatedTags = tagResult.tags;
+    }
     stopSpinner = showSpinner("Creating requirement", chalk7.gray);
     const requirement2 = await requirementService.createProjectRequirement(projectId, {
       name: opts.name,
       content: opts.content || null,
-      assigned_to: opts.assignedTo || null
+      assigned_to: opts.assignedTo || null,
+      tags: validatedTags
     });
     stopSpinner();
     stopSpinner = null;
@@ -4280,9 +4338,21 @@ async function handleRequirementSpecify(opts) {
         message: chalk7.red("\u274C Prompt must be no more than 5000 characters long")
       };
     }
+    let validatedTags;
+    if (opts.tags) {
+      const tagResult = validateTags(opts.tags);
+      if (!tagResult.valid) {
+        return {
+          success: false,
+          message: chalk7.red(`\u274C ${tagResult.error}`)
+        };
+      }
+      validatedTags = tagResult.tags;
+    }
     stopSpinner = showSpinner("Specifying requirement...");
     const requirement2 = await requirementService.specifyRequirement(projectId, {
-      prompt: opts.prompt
+      prompt: opts.prompt,
+      tags: validatedTags
     });
     stopSpinner();
     stopSpinner = null;
@@ -7610,7 +7680,7 @@ program.command("update").description("Update BrainGrid CLI to the latest versio
 program.command("specify").description("Create AI-refined requirement from prompt").option(
   "-p, --project <id>",
   "project ID (auto-detects from .braingrid/project.json if not provided)"
-).requiredOption("--prompt <prompt>", "requirement description (10-5000 characters)").option("--format <format>", "output format (table, json, xml, markdown)", "table").action(async (opts) => {
+).requiredOption("--prompt <prompt>", "requirement description (10-5000 characters)").option("-t, --tags <tags>", "comma-separated tags (max 5)").option("--format <format>", "output format (table, json, xml, markdown)", "table").action(async (opts) => {
   const result = await handleRequirementSpecify(opts);
   console.log(result.message);
   if (!result.success) {
@@ -7695,7 +7765,7 @@ requirement.command("show [id]").description("Show requirement details (auto-det
 requirement.command("create").description("Create a new requirement").option(
   "-p, --project <id>",
   "project ID (auto-detects from .braingrid/project.json if not provided)"
-).requiredOption("-n, --name <name>", "requirement name").option("-c, --content <content>", "requirement content/description").option("-a, --assigned-to <uuid>", "user UUID to assign the requirement to").action(async (opts) => {
+).requiredOption("-n, --name <name>", "requirement name").option("-c, --content <content>", "requirement content/description").option("-a, --assigned-to <uuid>", "user UUID to assign the requirement to").option("-t, --tags <tags>", "comma-separated tags (max 5)").action(async (opts) => {
   const result = await handleRequirementCreate(opts);
   console.log(result.message);
   if (!result.success) {