@fermindi/pwn-cli 0.1.1 → 0.3.0

package/src/patterns/registry.js

@@ -1,375 +1,375 @@
-/**
- * Pattern Registry - Manages pattern storage and retrieval
- *
- * Patterns are organized in categories:
- * - frontend/ (react, vue, svelte, styling, component-libs)
- * - backend/ (express, fastapi, database, auth)
- * - universal/ (typescript, testing, error-handling, git, build-tools)
- */
-
-import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, statSync } from 'fs';
-import { join, relative, basename, dirname } from 'path';
-
-/**
- * Pattern entry structure
- * @typedef {Object} Pattern
- * @property {string} id - Unique identifier (category/name)
- * @property {string} name - Human-readable name
- * @property {string} category - Pattern category (frontend, backend, universal)
- * @property {string} path - Relative path to pattern directory
- * @property {string} description - Pattern description
- * @property {string[]} triggers - Associated trigger IDs
- * @property {Object} metadata - Additional metadata
- * @property {number} metadata.usageCount - How many times pattern was applied
- * @property {string} metadata.lastUsed - ISO timestamp of last usage
- * @property {string} metadata.createdAt - ISO timestamp of creation
- */
-
-/**
- * PatternRegistry - Singleton for managing patterns
- */
-export class PatternRegistry {
-  constructor(workspacePath) {
-    this.workspacePath = workspacePath;
-    this.aiPath = join(workspacePath, '.ai');
-    this.patternsPath = join(this.aiPath, 'patterns');
-    this.registryPath = join(this.patternsPath, 'registry.json');
-    this.patterns = new Map();
-    this.loaded = false;
-  }
-
-  /**
-   * Initialize or load the registry
-   */
-  async load() {
-    if (this.loaded) return;
-
-    // Create patterns directory if it doesn't exist
-    if (!existsSync(this.patternsPath)) {
-      mkdirSync(this.patternsPath, { recursive: true });
-    }
-
-    // Load existing registry or scan for patterns
-    if (existsSync(this.registryPath)) {
-      try {
-        const data = JSON.parse(readFileSync(this.registryPath, 'utf8'));
-        for (const pattern of data.patterns || []) {
-          this.patterns.set(pattern.id, pattern);
-        }
-      } catch (error) {
-        console.warn('⚠️  Could not load registry, scanning patterns directory...');
-        await this.scan();
-      }
-    } else {
-      await this.scan();
-    }
-
-    this.loaded = true;
-  }
-
-  /**
-   * Scan patterns directory and build registry
-   */
-  async scan() {
-    this.patterns.clear();
-
-    const categories = ['frontend', 'backend', 'universal'];
-
-    for (const category of categories) {
-      const categoryPath = join(this.patternsPath, category);
-      if (!existsSync(categoryPath)) continue;
-
-      const entries = readdirSync(categoryPath, { withFileTypes: true });
-
-      for (const entry of entries) {
-        if (!entry.isDirectory()) continue;
-
-        const patternPath = join(categoryPath, entry.name);
-        const readmePath = join(patternPath, 'README.md');
-
-        const pattern = {
-          id: `${category}/${entry.name}`,
-          name: this.formatName(entry.name),
-          category,
-          path: relative(this.aiPath, patternPath),
-          description: this.extractDescription(readmePath),
-          triggers: [],
-          metadata: {
-            usageCount: 0,
-            lastUsed: null,
-            createdAt: new Date().toISOString()
-          }
-        };
-
-        this.patterns.set(pattern.id, pattern);
-      }
-    }
-
-    // Save the scanned registry
-    await this.save();
-  }
-
-  /**
-   * Extract description from README.md first line
-   */
-  extractDescription(readmePath) {
-    if (!existsSync(readmePath)) {
-      return 'No description available';
-    }
-
-    try {
-      const content = readFileSync(readmePath, 'utf8');
-      const lines = content.split('\n');
-
-      // Find first non-empty, non-heading line
-      for (const line of lines) {
-        const trimmed = line.trim();
-        if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('---')) {
-          return trimmed.slice(0, 100) + (trimmed.length > 100 ? '...' : '');
-        }
-      }
-
-      return 'Pattern documentation available';
-    } catch {
-      return 'No description available';
-    }
-  }
-
-  /**
-   * Format pattern name from directory name
-   */
-  formatName(dirName) {
-    return dirName
-      .split(/[-_]/)
-      .map(word => word.charAt(0).toUpperCase() + word.slice(1))
-      .join(' ');
-  }
-
-  /**
-   * Save registry to disk
-   */
-  async save() {
-    const data = {
-      version: '1.0.0',
-      lastUpdated: new Date().toISOString(),
-      patterns: Array.from(this.patterns.values())
-    };
-
-    writeFileSync(this.registryPath, JSON.stringify(data, null, 2));
-  }
-
-  /**
-   * Get a pattern by ID
-   * @param {string} id - Pattern ID (e.g., 'frontend/react')
-   * @returns {Pattern|null}
-   */
-  get(id) {
-    return this.patterns.get(id) || null;
-  }
-
-  /**
-   * Get all patterns
-   * @returns {Pattern[]}
-   */
-  getAll() {
-    return Array.from(this.patterns.values());
-  }
-
-  /**
-   * Get patterns by category
-   * @param {string} category - Category name
-   * @returns {Pattern[]}
-   */
-  getByCategory(category) {
-    return this.getAll().filter(p => p.category === category);
-  }
-
-  /**
-   * Search patterns by name or description
-   * @param {string} query - Search query
-   * @returns {Pattern[]}
-   */
-  search(query) {
-    const lowerQuery = query.toLowerCase();
-    return this.getAll().filter(p =>
-      p.name.toLowerCase().includes(lowerQuery) ||
-      p.description.toLowerCase().includes(lowerQuery) ||
-      p.id.toLowerCase().includes(lowerQuery)
-    );
-  }
-
-  /**
-   * Register a new pattern
-   * @param {Pattern} pattern - Pattern to register
-   */
-  async register(pattern) {
-    // Ensure required fields
-    if (!pattern.id || !pattern.name || !pattern.category) {
-      throw new Error('Pattern must have id, name, and category');
-    }
-
-    // Create pattern directory if it doesn't exist
-    const patternDir = join(this.patternsPath, pattern.path || pattern.id);
-    if (!existsSync(patternDir)) {
-      mkdirSync(patternDir, { recursive: true });
-
-      // Create README.md with description
-      const readmePath = join(patternDir, 'README.md');
-      writeFileSync(readmePath, `# ${pattern.name}\n\n${pattern.description || ''}\n`);
-    }
-
-    // Set metadata
-    pattern.metadata = pattern.metadata || {
-      usageCount: 0,
-      lastUsed: null,
-      createdAt: new Date().toISOString()
-    };
-
-    this.patterns.set(pattern.id, pattern);
-    await this.save();
-  }
-
-  /**
-   * Remove a pattern
-   * @param {string} id - Pattern ID
-   */
-  async remove(id) {
-    this.patterns.delete(id);
-    await this.save();
-  }
-
-  /**
-   * Record pattern usage
-   * @param {string} id - Pattern ID
-   */
-  async recordUsage(id) {
-    const pattern = this.patterns.get(id);
-    if (pattern) {
-      pattern.metadata.usageCount++;
-      pattern.metadata.lastUsed = new Date().toISOString();
-      await this.save();
-    }
-  }
-
-  /**
-   * Get pattern content (README.md)
-   * @param {string} id - Pattern ID
-   * @returns {string|null}
-   */
-  getContent(id) {
-    const pattern = this.patterns.get(id);
-    if (!pattern) return null;
-
-    // pattern.path is relative to aiPath (e.g., "patterns/frontend/react")
-    const readmePath = join(this.aiPath, pattern.path, 'README.md');
-    if (!existsSync(readmePath)) return null;
-
-    return readFileSync(readmePath, 'utf8');
-  }
-
-  /**
-   * Get all files in a pattern directory
-   * @param {string} id - Pattern ID
-   * @returns {Object[]} Array of {name, path, content}
-   */
-  getPatternFiles(id) {
-    const pattern = this.patterns.get(id);
-    if (!pattern) return [];
-
-    // pattern.path is relative to aiPath (e.g., "patterns/frontend/react")
-    const patternDir = join(this.aiPath, pattern.path);
-    if (!existsSync(patternDir)) return [];
-
-    const files = [];
-    const entries = readdirSync(patternDir, { withFileTypes: true });
-
-    for (const entry of entries) {
-      if (entry.isFile()) {
-        const filePath = join(patternDir, entry.name);
-        files.push({
-          name: entry.name,
-          path: relative(this.aiPath, filePath),
-          content: readFileSync(filePath, 'utf8')
-        });
-      }
-    }
-
-    return files;
-  }
-
-  /**
-   * Get usage statistics
-   * @returns {Object}
-   */
-  getStats() {
-    const patterns = this.getAll();
-    const byCategory = {};
-    let totalUsage = 0;
-    let mostUsed = null;
-
-    for (const pattern of patterns) {
-      // Count by category
-      byCategory[pattern.category] = (byCategory[pattern.category] || 0) + 1;
-
-      // Track total usage
-      totalUsage += pattern.metadata.usageCount;
-
-      // Track most used
-      if (!mostUsed || pattern.metadata.usageCount > mostUsed.metadata.usageCount) {
-        mostUsed = pattern;
-      }
-    }
-
-    return {
-      totalPatterns: patterns.length,
-      byCategory,
-      totalUsage,
-      mostUsed: mostUsed ? { id: mostUsed.id, count: mostUsed.metadata.usageCount } : null
-    };
-  }
-
-  /**
-   * Associate trigger with pattern
-   * @param {string} patternId - Pattern ID
-   * @param {string} triggerId - Trigger ID
-   */
-  async addTrigger(patternId, triggerId) {
-    const pattern = this.patterns.get(patternId);
-    if (pattern && !pattern.triggers.includes(triggerId)) {
-      pattern.triggers.push(triggerId);
-      await this.save();
-    }
-  }
-
-  /**
-   * Remove trigger from pattern
-   * @param {string} patternId - Pattern ID
-   * @param {string} triggerId - Trigger ID
-   */
-  async removeTrigger(patternId, triggerId) {
-    const pattern = this.patterns.get(patternId);
-    if (pattern) {
-      pattern.triggers = pattern.triggers.filter(t => t !== triggerId);
-      await this.save();
-    }
-  }
-}
-
-/**
- * Create a new PatternRegistry instance for the given workspace
- * @param {string} workspacePath - Path to workspace root
- * @returns {PatternRegistry}
- */
-export function createRegistry(workspacePath) {
-  return new PatternRegistry(workspacePath);
-}
-
-/**
- * Get pattern registry for current working directory
- * @returns {PatternRegistry}
- */
-export function getRegistry() {
-  return createRegistry(process.cwd());
-}
-
-export default { PatternRegistry, createRegistry, getRegistry };
+/**
+ * Pattern Registry - Manages pattern storage and retrieval
+ *
+ * Patterns are organized in categories:
+ * - frontend/ (react, vue, svelte, styling, component-libs)
+ * - backend/ (express, fastapi, database, auth)
+ * - universal/ (typescript, testing, error-handling, git, build-tools)
+ */
+
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, statSync } from 'fs';
+import { join, relative, basename, dirname } from 'path';
+
+/**
+ * Pattern entry structure
+ * @typedef {Object} Pattern
+ * @property {string} id - Unique identifier (category/name)
+ * @property {string} name - Human-readable name
+ * @property {string} category - Pattern category (frontend, backend, universal)
+ * @property {string} path - Relative path to pattern directory
+ * @property {string} description - Pattern description
+ * @property {string[]} triggers - Associated trigger IDs
+ * @property {Object} metadata - Additional metadata
+ * @property {number} metadata.usageCount - How many times pattern was applied
+ * @property {string} metadata.lastUsed - ISO timestamp of last usage
+ * @property {string} metadata.createdAt - ISO timestamp of creation
+ */
+
+/**
+ * PatternRegistry - Singleton for managing patterns
+ */
+export class PatternRegistry {
+  constructor(workspacePath) {
+    this.workspacePath = workspacePath;
+    this.aiPath = join(workspacePath, '.ai');
+    this.patternsPath = join(this.aiPath, 'patterns');
+    this.registryPath = join(this.patternsPath, 'registry.json');
+    this.patterns = new Map();
+    this.loaded = false;
+  }
+
+  /**
+   * Initialize or load the registry
+   */
+  async load() {
+    if (this.loaded) return;
+
+    // Create patterns directory if it doesn't exist
+    if (!existsSync(this.patternsPath)) {
+      mkdirSync(this.patternsPath, { recursive: true });
+    }
+
+    // Load existing registry or scan for patterns
+    if (existsSync(this.registryPath)) {
+      try {
+        const data = JSON.parse(readFileSync(this.registryPath, 'utf8'));
+        for (const pattern of data.patterns || []) {
+          this.patterns.set(pattern.id, pattern);
+        }
+      } catch (error) {
+        console.warn('⚠️  Could not load registry, scanning patterns directory...');
+        await this.scan();
+      }
+    } else {
+      await this.scan();
+    }
+
+    this.loaded = true;
+  }
+
+  /**
+   * Scan patterns directory and build registry
+   */
+  async scan() {
+    this.patterns.clear();
+
+    const categories = ['frontend', 'backend', 'universal'];
+
+    for (const category of categories) {
+      const categoryPath = join(this.patternsPath, category);
+      if (!existsSync(categoryPath)) continue;
+
+      const entries = readdirSync(categoryPath, { withFileTypes: true });
+
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+
+        const patternPath = join(categoryPath, entry.name);
+        const readmePath = join(patternPath, 'README.md');
+
+        const pattern = {
+          id: `${category}/${entry.name}`,
+          name: this.formatName(entry.name),
+          category,
+          path: relative(this.aiPath, patternPath),
+          description: this.extractDescription(readmePath),
+          triggers: [],
+          metadata: {
+            usageCount: 0,
+            lastUsed: null,
+            createdAt: new Date().toISOString()
+          }
+        };
+
+        this.patterns.set(pattern.id, pattern);
+      }
+    }
+
+    // Save the scanned registry
+    await this.save();
+  }
+
+  /**
+   * Extract description from README.md first line
+   */
+  extractDescription(readmePath) {
+    if (!existsSync(readmePath)) {
+      return 'No description available';
+    }
+
+    try {
+      const content = readFileSync(readmePath, 'utf8');
+      const lines = content.split('\n');
+
+      // Find first non-empty, non-heading line
+      for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('---')) {
+          return trimmed.slice(0, 100) + (trimmed.length > 100 ? '...' : '');
+        }
+      }
+
+      return 'Pattern documentation available';
+    } catch {
+      return 'No description available';
+    }
+  }
+
+  /**
+   * Format pattern name from directory name
+   */
+  formatName(dirName) {
+    return dirName
+      .split(/[-_]/)
+      .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+      .join(' ');
+  }
+
+  /**
+   * Save registry to disk
+   */
+  async save() {
+    const data = {
+      version: '1.0.0',
+      lastUpdated: new Date().toISOString(),
+      patterns: Array.from(this.patterns.values())
+    };
+
+    writeFileSync(this.registryPath, JSON.stringify(data, null, 2));
+  }
+
+  /**
+   * Get a pattern by ID
+   * @param {string} id - Pattern ID (e.g., 'frontend/react')
+   * @returns {Pattern|null}
+   */
+  get(id) {
+    return this.patterns.get(id) || null;
+  }
+
+  /**
+   * Get all patterns
+   * @returns {Pattern[]}
+   */
+  getAll() {
+    return Array.from(this.patterns.values());
+  }
+
+  /**
+   * Get patterns by category
+   * @param {string} category - Category name
+   * @returns {Pattern[]}
+   */
+  getByCategory(category) {
+    return this.getAll().filter(p => p.category === category);
+  }
+
+  /**
+   * Search patterns by name or description
+   * @param {string} query - Search query
+   * @returns {Pattern[]}
+   */
+  search(query) {
+    const lowerQuery = query.toLowerCase();
+    return this.getAll().filter(p =>
+      p.name.toLowerCase().includes(lowerQuery) ||
+      p.description.toLowerCase().includes(lowerQuery) ||
+      p.id.toLowerCase().includes(lowerQuery)
+    );
+  }
+
+  /**
+   * Register a new pattern
+   * @param {Pattern} pattern - Pattern to register
+   */
+  async register(pattern) {
+    // Ensure required fields
+    if (!pattern.id || !pattern.name || !pattern.category) {
+      throw new Error('Pattern must have id, name, and category');
+    }
+
+    // Create pattern directory if it doesn't exist
+    const patternDir = join(this.patternsPath, pattern.path || pattern.id);
+    if (!existsSync(patternDir)) {
+      mkdirSync(patternDir, { recursive: true });
+
+      // Create README.md with description
+      const readmePath = join(patternDir, 'README.md');
+      writeFileSync(readmePath, `# ${pattern.name}\n\n${pattern.description || ''}\n`);
+    }
+
+    // Set metadata
+    pattern.metadata = pattern.metadata || {
+      usageCount: 0,
+      lastUsed: null,
+      createdAt: new Date().toISOString()
+    };
+
+    this.patterns.set(pattern.id, pattern);
+    await this.save();
+  }
+
+  /**
+   * Remove a pattern
+   * @param {string} id - Pattern ID
+   */
+  async remove(id) {
+    this.patterns.delete(id);
+    await this.save();
+  }
+
+  /**
+   * Record pattern usage
+   * @param {string} id - Pattern ID
+   */
+  async recordUsage(id) {
+    const pattern = this.patterns.get(id);
+    if (pattern) {
+      pattern.metadata.usageCount++;
+      pattern.metadata.lastUsed = new Date().toISOString();
+      await this.save();
+    }
+  }
+
+  /**
+   * Get pattern content (README.md)
+   * @param {string} id - Pattern ID
+   * @returns {string|null}
+   */
+  getContent(id) {
+    const pattern = this.patterns.get(id);
+    if (!pattern) return null;
+
+    // pattern.path is relative to aiPath (e.g., "patterns/frontend/react")
+    const readmePath = join(this.aiPath, pattern.path, 'README.md');
+    if (!existsSync(readmePath)) return null;
+
+    return readFileSync(readmePath, 'utf8');
+  }
+
+  /**
+   * Get all files in a pattern directory
+   * @param {string} id - Pattern ID
+   * @returns {Object[]} Array of {name, path, content}
+   */
+  getPatternFiles(id) {
+    const pattern = this.patterns.get(id);
+    if (!pattern) return [];
+
+    // pattern.path is relative to aiPath (e.g., "patterns/frontend/react")
+    const patternDir = join(this.aiPath, pattern.path);
+    if (!existsSync(patternDir)) return [];
+
+    const files = [];
+    const entries = readdirSync(patternDir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (entry.isFile()) {
+        const filePath = join(patternDir, entry.name);
+        files.push({
+          name: entry.name,
+          path: relative(this.aiPath, filePath),
+          content: readFileSync(filePath, 'utf8')
+        });
+      }
+    }
+
+    return files;
+  }
+
+  /**
+   * Get usage statistics
+   * @returns {Object}
+   */
+  getStats() {
+    const patterns = this.getAll();
+    const byCategory = {};
+    let totalUsage = 0;
+    let mostUsed = null;
+
+    for (const pattern of patterns) {
+      // Count by category
+      byCategory[pattern.category] = (byCategory[pattern.category] || 0) + 1;
+
+      // Track total usage
+      totalUsage += pattern.metadata.usageCount;
+
+      // Track most used
+      if (!mostUsed || pattern.metadata.usageCount > mostUsed.metadata.usageCount) {
+        mostUsed = pattern;
+      }
+    }
+
+    return {
+      totalPatterns: patterns.length,
+      byCategory,
+      totalUsage,
+      mostUsed: mostUsed ? { id: mostUsed.id, count: mostUsed.metadata.usageCount } : null
+    };
+  }
+
+  /**
+   * Associate trigger with pattern
+   * @param {string} patternId - Pattern ID
+   * @param {string} triggerId - Trigger ID
+   */
+  async addTrigger(patternId, triggerId) {
+    const pattern = this.patterns.get(patternId);
+    if (pattern && !pattern.triggers.includes(triggerId)) {
+      pattern.triggers.push(triggerId);
+      await this.save();
+    }
+  }
+
+  /**
+   * Remove trigger from pattern
+   * @param {string} patternId - Pattern ID
+   * @param {string} triggerId - Trigger ID
+   */
+  async removeTrigger(patternId, triggerId) {
+    const pattern = this.patterns.get(patternId);
+    if (pattern) {
+      pattern.triggers = pattern.triggers.filter(t => t !== triggerId);
+      await this.save();
+    }
+  }
+}
+
+/**
+ * Create a new PatternRegistry instance for the given workspace
+ * @param {string} workspacePath - Path to workspace root
+ * @returns {PatternRegistry}
+ */
+export function createRegistry(workspacePath) {
+  return new PatternRegistry(workspacePath);
+}
+
+/**
+ * Get pattern registry for current working directory
+ * @returns {PatternRegistry}
+ */
+export function getRegistry() {
+  return createRegistry(process.cwd());
+}
+
+export default { PatternRegistry, createRegistry, getRegistry };