convoke-agents 3.1.0 → 3.2.1

package/_bmad/bme/_team-factory/lib/utils/csv-utils.js

@@ -0,0 +1,62 @@
+'use strict';
+
+/**
+ * RFC 4180-aware CSV row parser for team factory validation.
+ * Handles quoted fields containing commas and escaped quotes ("").
+ */
+
+/**
+ * Parse a single CSV row into an array of field values.
+ * Handles double-quoted fields per RFC 4180:
+ * - Fields containing commas, quotes, or newlines are enclosed in double quotes
+ * - Double quotes inside quoted fields are escaped as ""
+ *
+ * @param {string} line - A single CSV row string
+ * @returns {string[]} Array of field values
+ */
+function parseCsvRow(line) {
+  const fields = [];
+  let current = '';
+  let inQuotes = false;
+  let i = 0;
+
+  while (i < line.length) {
+    const ch = line[i];
+
+    if (inQuotes) {
+      if (ch === '"') {
+        // Check for escaped quote ""
+        if (i + 1 < line.length && line[i + 1] === '"') {
+          current += '"';
+          i += 2;
+        } else {
+          // End of quoted field
+          inQuotes = false;
+          i++;
+        }
+      } else {
+        current += ch;
+        i++;
+      }
+    } else {
+      if (ch === '"') {
+        inQuotes = true;
+        i++;
+      } else if (ch === ',') {
+        fields.push(current);
+        current = '';
+        i++;
+      } else {
+        current += ch;
+        i++;
+      }
+    }
+  }
+
+  // Push the last field
+  fields.push(current);
+
+  return fields;
+}
+
+module.exports = { parseCsvRow };

package/_bmad/bme/_team-factory/lib/utils/naming-utils.js

@@ -0,0 +1,45 @@
+'use strict';
+
+/**
+ * Shared naming utilities for team factory modules.
+ * Canonical source for toKebab() and deriveWorkflowName() — no duplication.
+ */
+
+/**
+ * Convert a string to kebab-case.
+ * @param {string} str
+ * @returns {string}
+ */
+function toKebab(str) {
+  if (!str) return '';
+  return str
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+}
+
+/**
+ * Derive a workflow name for a single agent from spec data.
+ * Uses workflow_names map if present, otherwise derives from first capability.
+ * Falls back to role > agent.id when capabilities are absent.
+ *
+ * @param {Object} agent - Agent spec object with id, role, capabilities
+ * @param {Object} [specData] - Full spec data (checked for workflow_names map)
+ * @returns {string} kebab-case workflow name
+ */
+function deriveWorkflowName(agent, specData) {
+  if (specData && specData.workflow_names && specData.workflow_names[agent.id]) {
+    return specData.workflow_names[agent.id];
+  }
+  if (agent.capabilities && agent.capabilities.length > 0) {
+    const cap = agent.capabilities[0];
+    const wordCount = cap.trim().split(/\s+/).length;
+    if (wordCount > 4 && agent.role) {
+      return toKebab(agent.role);
+    }
+    return toKebab(cap);
+  }
+  return toKebab(agent.role || agent.id);
+}
+
+module.exports = { toKebab, deriveWorkflowName };