@zebralabs/context-cli 0.1.3 → 0.1.5

package/src/infrastructure/parsing/skill-extractor.js

@@ -0,0 +1,74 @@
+import { MarkdownParser } from "./markdown-parser.js";
+
+/**
+ * Skill extractor adapter
+ * Extracts skill definitions from @context.skills sections
+ */
+export class SkillExtractor {
+  constructor() {
+    this.parser = new MarkdownParser();
+  }
+
+  /**
+   * Extracts skill definitions from markdown content.
+   * @param {string} markdown - The markdown content.
+   * @param {Object} sourceMetadata - Metadata about the source file (packId, file, etc.).
+   * @returns {Object[]} Extracted skill definitions.
+   */
+  extractSkills(markdown, sourceMetadata) {
+    const skills = [];
+    const skillsSection = this.parser.findSection(markdown, "## @context.skills");
+    
+    if (!skillsSection) return skills;
+
+    const skillBlocks = skillsSection.split(/\r?\n### /).filter(Boolean);
+    for (const skillText of skillBlocks) {
+      try {
+        const skill = this._parseSkill(skillText, sourceMetadata);
+        if (skill) skills.push(skill);
+      } catch (e) {
+        console.warn(`Warning: Malformed skill in ${sourceMetadata.file}: ${e.message}`);
+      }
+    }
+    return skills;
+  }
+
+  _parseSkill(skillText, sourceMetadata) {
+    const lines = skillText.split(/\r?\n/);
+    // Handle first line - might have "### " prefix or not
+    const firstLine = lines[0].trim();
+    const nameMatch = firstLine.match(/^(?:###\s+)?skill-([a-z0-9-]+)$/i);
+    if (!nameMatch) throw new Error(`Invalid skill ID format: ${firstLine}`);
+
+    const id = nameMatch[1].toLowerCase();
+    const skill = {
+      id: id,
+      name: id, // Default name to id, can be overridden by explicit 'Name' field
+      description: '',
+      rules: [],
+      whenToUse: [],
+      processReference: '',
+      source: sourceMetadata
+    };
+
+    for (let i = 1; i < lines.length; i++) {
+      const line = lines[i].trim();
+      if (line.startsWith('- **Name:**')) {
+        skill.name = line.replace('- **Name:**', '').trim();
+      } else if (line.startsWith('- **Description:**')) {
+        skill.description = line.replace('- **Description:**', '').trim();
+      } else if (line.startsWith('- **Rules:**')) {
+        skill.rules = line.replace('- **Rules:**', '').split(',').map(s => s.trim()).filter(Boolean);
+      } else if (line.startsWith('- **When to use:**')) {
+        skill.whenToUse = line.replace('- **When to use:**', '').split(',').map(s => s.trim()).filter(Boolean);
+      } else if (line.startsWith('- **Process reference:**')) {
+        skill.processReference = line.replace('- **Process reference:**', '').trim();
+      }
+    }
+
+    if (!skill.description) throw new Error(`Skill '${skill.id}' is missing a description.`);
+
+    return skill;
+  }
+}
+