bi-superpowers 1.0.0

package/bin/lib/generators/shared.js

@@ -0,0 +1,257 @@
+/**
+ * Shared Generator Functions
+ * ==========================
+ *
+ * Common functions used by all AI tool generators.
+ *
+ * @module lib/generators/shared
+ */
+
+/**
+ * Extract skill metadata from markdown content
+ *
+ * Parses a skill file to extract:
+ * - title: From the first H1 heading
+ * - triggers: Array of activation phrases from the Trigger section
+ * - identity: The AI role description from the Identity section
+ *
+ * @param {string} content - Raw markdown content of skill file
+ * @returns {Object} Parsed metadata
+ */
+function parseSkillMetadata(content) {
+  const metadata = {
+    title: '',
+    triggers: [],
+    identity: '',
+  };
+
+  // Get title from first H1
+  const titleMatch = content.match(/^#\s+(.+)/m);
+  if (titleMatch) metadata.title = titleMatch[1];
+
+  // Get triggers — collect every double-quoted fragment in the Trigger
+  // section. This handles all three shapes our skills use:
+  //   - Bare-quote bullets:    - "connect Power BI", "PBI connection"
+  //   - Prose bullets:         - User mentions: "analizar proyecto", "new project"
+  //   - Asterisk bullets:      * "pattern"
+  // The regex intentionally doesn't anchor to bullet syntax — that's
+  // what broke extraction for bi-kickoff (prose) and under-counted
+  // bi-connect (first quote per bullet only) before this change.
+  const triggerSection = content.match(/##\s+Trigger[\s\S]*?(?=##|$)/i);
+  if (triggerSection) {
+    const quotedFragments = triggerSection[0].match(/"([^"]+)"/g);
+    if (quotedFragments) {
+      metadata.triggers = quotedFragments.map((t) => t.slice(1, -1));
+    }
+  }
+
+  // Get identity
+  const identityMatch = content.match(/##\s+Identity[\s\S]*?(?=##|---)/i);
+  if (identityMatch) {
+    metadata.identity = identityMatch[0].replace(/##\s+Identity\s*/i, '').trim();
+  }
+
+  return metadata;
+}
+
+/**
+ * Map of skill name → one-line purpose description used in generated
+ * commands/*.md frontmatter and the CLI's `super powers` output.
+ *
+ * Keep this map in lock-step with `src/content/skills/`. Adding a skill
+ * without an entry here makes the generated description fall back to the
+ * generic `'Specialized BI assistance'` string and breaks the parity
+ * test in shared.test.js.
+ */
+const SKILL_PURPOSES = {
+  'bi-start': 'Session opener — environment snapshot, update check, and routing to other skills',
+  'bi-kickoff':
+    'New-project bootstrap — guided business intake, base-template scaffold, and domain demo model',
+  'bi-modeling':
+    'Semantic model design and audit — star schema, relationships, Date Table, health checklist',
+  'bi-dax':
+    'DAX authoring, debugging, and optimization — measures, calculation groups, SE/FE timing, Sallieri patterns',
+  'bi-performance':
+    'Performance profiling — Performance Analyzer, DAX Studio / VertiPaq Analyzer metrics, refresh diagnostics, Tabular Editor 2 / BPA',
+  'bi-connect': 'Power BI Desktop MCP connection and DAX UDF authoring',
+  'bi-powerquery':
+    'Power Query real-data staging — strict M queries for Demo/Real appends into base-template tables',
+  'bi-scorecard':
+    'Power BI Service scorecards — create scorecard blueprints from model metrics, manage goals, check-ins, and status rules',
+  'bi-refactor':
+    'Existing-project refactor — PBIX-to-PBIP guidance, template benchmark, semantic cleanup, and report topology preservation',
+};
+
+/**
+ * Get skill purpose description for table
+ * @param {string} skillName - Name of the skill
+ * @returns {string} Purpose description
+ */
+function getSkillPurpose(skillName) {
+  return SKILL_PURPOSES[skillName] || 'Specialized BI assistance';
+}
+
+/**
+ * Generate skills summary table for combined configs
+ * @param {Object[]} skills - Array of skill objects
+ * @returns {string} Markdown table
+ */
+function generateSkillsSection(skills) {
+  let section = `---
+
+## Available Skills
+
+When you detect these triggers, apply the corresponding skill knowledge:
+
+| Skill | Triggers | Purpose |
+|-------|----------|---------|
+`;
+
+  for (const skill of skills) {
+    const meta = parseSkillMetadata(skill.content);
+    const triggers =
+      meta.triggers
+        .slice(0, 3)
+        .map((t) => `"${t}"`)
+        .join(', ') || `"${skill.name}"`;
+    section += `| **${meta.title || skill.name}** | ${triggers} | ${getSkillPurpose(skill.name)} |\n`;
+  }
+
+  return section;
+}
+
+/**
+ * Get code standards section for combined configs
+ * @returns {string} Markdown code standards
+ */
+function getCodeStandards() {
+  return `---
+
+## Code Standards
+
+### DAX
+
+\`\`\`dax
+-- Use VAR/RETURN for clarity and performance
+SalesYoY =
+VAR _Current = [TotalSales]
+VAR _Prior = CALCULATE([TotalSales], SAMEPERIODLASTYEAR('Date'[Date]))
+RETURN DIVIDE(_Current - _Prior, _Prior)
+
+-- Always use DIVIDE for safe division
+Margin = DIVIDE([Profit], [Revenue], 0)
+
+-- Time intelligence
+Sales_YTD = TOTALYTD([TotalSales], 'Date'[Date])
+Sales_PY = CALCULATE([TotalSales], SAMEPERIODLASTYEAR('Date'[Date]))
+\`\`\`
+
+### Power Query
+
+\`\`\`powerquery
+let
+    Source = Sql.Database("server", "database"),
+    Filtered = Table.SelectRows(Source, each [Status] = "Active"),
+    Typed = Table.TransformColumnTypes(Filtered, {{"Date", type date}})
+in
+    Typed
+\`\`\`
+
+### Excel
+
+\`\`\`excel
+=XLOOKUP(A1, Table[ID], Table[Name], "Not Found")
+=FILTER(Data, Data[Status]="Active")
+=LET(x, SUM(A:A), y, COUNT(A:A), DIVIDE(x, y))
+\`\`\`
+
+### Naming Conventions
+
+| Element | Convention | Example |
+|---------|------------|---------|
+| Measures | PascalCase | \`TotalSales\` |
+| Tables | Singular | \`Customer\` |
+| Columns | PascalCase | \`OrderDate\` |
+| Variables | Underscore prefix | \`_Result\` |`;
+}
+
+/**
+ * Get format-specific header
+ * @param {string} format - Format type (cursor, copilot, chatgpt, generic)
+ * @param {number} skillCount - Number of skills
+ * @returns {string} Header content
+ */
+function getFormatHeader(format, skillCount) {
+  const headers = {
+    cursor: `# BI Agent Superpowers - Cursor Rules
+
+You are a Business Intelligence Expert with deep knowledge of Power BI, Microsoft Fabric, and Excel.
+Generated automatically from ${skillCount} skill definitions.`,
+
+    copilot: `# BI Agent Superpowers - GitHub Copilot Instructions
+
+You are a Business Intelligence Expert specializing in Power BI, Microsoft Fabric, and Excel development.
+Generated automatically from ${skillCount} skill definitions.`,
+
+    chatgpt: `# BI Agent Superpowers - ChatGPT Custom Instructions
+
+Copy this content to ChatGPT > Settings > Personalization > Custom Instructions.
+
+You are a Business Intelligence Expert specializing in Power BI, Microsoft Fabric, and Excel.`,
+
+    generic: `# BI Agent Superpowers - AI Context
+
+Universal context for any AI assistant working with Business Intelligence development.
+Generated automatically from ${skillCount} skill definitions.`,
+  };
+  return headers[format] || headers.generic;
+}
+
+/**
+ * Get format-specific footer
+ * @returns {string} Footer content
+ */
+function getFormatFooter() {
+  return `---
+
+## Resources
+
+- Skills: \`skills/*/SKILL.md\` - BI workflow instructions
+
+---
+
+**BI Agent Superpowers** - Developed by Lucas Sanchez (@luquimbo)
+https://github.com/luquimbo/bi-superpowers`;
+}
+
+/**
+ * Generate combined configuration for tools that use a single file
+ * @param {Object[]} skills - Array of skill objects
+ * @param {string} format - Format type (cursor, copilot, chatgpt, generic)
+ * @returns {string} Combined markdown content
+ */
+function generateCombinedConfig(skills, format) {
+  const header = getFormatHeader(format, skills.length);
+  const skillsSection = generateSkillsSection(skills);
+  const codeStandards = getCodeStandards();
+  const footer = getFormatFooter();
+
+  return `${header}
+
+${skillsSection}
+
+${codeStandards}
+
+${footer}`;
+}
+
+module.exports = {
+  parseSkillMetadata,
+  getSkillPurpose,
+  SKILL_PURPOSES,
+  generateSkillsSection,
+  getCodeStandards,
+  getFormatHeader,
+  getFormatFooter,
+  generateCombinedConfig,
+};