mcp-taskflow 0.1.0

package/dist/data/rulesStore.js

@@ -0,0 +1,196 @@
+/**
+ * RulesStore - Project-specific coding rules management
+ *
+ * Provides:
+ * - Loading and saving project coding standards
+ * - Markdown-based rules storage
+ * - Validation and size limits
+ *
+ */
+import { fileExists } from './fileOperations.js';
+import { getDataPath } from '../config/pathResolver.js';
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * Project rules filename
+ */
+const RULES_FILENAME = 'taskflow-rules.md';
+/**
+ * Maximum rules file size (1MB) to prevent DoS
+ */
+const MAX_RULES_SIZE_BYTES = 1 * 1024 * 1024;
+/**
+ * Default rules template
+ */
+const DEFAULT_RULES_TEMPLATE = `# Project Coding Standards
+
+## Overview
+Document your project-specific coding standards, patterns, and conventions here.
+
+## Code Style
+- Formatting rules
+- Naming conventions
+- File organization
+
+## Architecture Patterns
+- Design patterns used
+- Module structure
+- Dependency guidelines
+
+## Security Guidelines
+- Security controls applicable
+- Authentication/authorization patterns
+- Data validation requirements
+
+## Testing Standards
+- Test coverage requirements
+- Testing patterns
+- Mock strategies
+
+## Documentation
+- Comment requirements
+- API documentation
+- README guidelines
+
+---
+
+**Last Updated**: ${new Date().toISOString().split('T')[0]}
+`;
+/**
+ * RulesStore - Manages project-specific coding rules
+ */
+export class RulesStore {
+    rulesFilePath;
+    /**
+     * Create a new RulesStore
+     *
+     * @param dataDir - Optional data directory override (for testing)
+     */
+    constructor(dataDir) {
+        this.rulesFilePath = getDataPath(RULES_FILENAME, dataDir);
+    }
+    /**
+     * Check if project rules exist
+     *
+     * @returns True if rules file exists
+     */
+    async rulesExistAsync() {
+        return await fileExists(this.rulesFilePath);
+    }
+    /**
+     * Load project rules
+     *
+     * @returns Rules content as markdown string
+     */
+    async loadRulesAsync() {
+        if (!(await this.rulesExistAsync())) {
+            throw new Error('Project rules not found. Initialize rules first.');
+        }
+        // Read rules file
+        // eslint-disable-next-line security/detect-non-literal-fs-filename
+        const content = await fs.readFile(this.rulesFilePath, 'utf-8');
+        // Validate size
+        if (content.length > MAX_RULES_SIZE_BYTES) {
+            throw new Error(`Rules file too large (${content.length} bytes, max ${MAX_RULES_SIZE_BYTES})`);
+        }
+        return content;
+    }
+    /**
+     * Save project rules
+     *
+     * Validates markdown content and size before saving
+     *
+     * @param content - Rules content as markdown string
+     */
+    async saveRulesAsync(content) {
+        // Validate content
+        if (content.trim().length === 0) {
+            throw new Error('Rules content cannot be empty');
+        }
+        // Validate size
+        const sizeBytes = Buffer.byteLength(content, 'utf-8');
+        if (sizeBytes > MAX_RULES_SIZE_BYTES) {
+            throw new Error(`Rules content too large (${sizeBytes} bytes, max ${MAX_RULES_SIZE_BYTES})`);
+        }
+        // Basic markdown validation (check for common markdown headers)
+        if (!content.includes('#')) {
+            console.warn('Rules content does not contain markdown headers');
+        }
+        // Write rules file atomically
+        // Use temp file + rename pattern for atomicity
+        const tempPath = `${this.rulesFilePath}.tmp`;
+        try {
+            // Ensure parent directory exists
+            const dirPath = this.rulesFilePath.substring(0, this.rulesFilePath.lastIndexOf(path.sep));
+            await fs.mkdir(dirPath, { recursive: true });
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            await fs.writeFile(tempPath, content, 'utf-8');
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            await fs.rename(tempPath, this.rulesFilePath);
+        }
+        catch (error) {
+            // Cleanup temp file on failure
+            try {
+                // eslint-disable-next-line security/detect-non-literal-fs-filename
+                await fs.unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw error;
+        }
+    }
+    /**
+     * Initialize project rules with default template
+     *
+     * Only creates file if it doesn't already exist
+     *
+     * @returns True if created, false if already exists
+     */
+    async initializeRulesAsync() {
+        if (await this.rulesExistAsync()) {
+            return false;
+        }
+        await this.saveRulesAsync(DEFAULT_RULES_TEMPLATE);
+        return true;
+    }
+    /**
+     * Update project rules (append or replace sections)
+     *
+     * @param updates - Markdown content to append or section replacements
+     * @param mode - 'append' to add to end, 'replace' to overwrite
+     */
+    async updateRulesAsync(updates, mode = 'append') {
+        // Validate updates content
+        if (updates.trim().length === 0) {
+            throw new Error('Rules content cannot be empty');
+        }
+        let content;
+        if (mode === 'replace') {
+            // Replace entire content
+            content = updates;
+        }
+        else {
+            // Append to existing content
+            const existing = await this.rulesExistAsync()
+                ? await this.loadRulesAsync()
+                : '';
+            content = existing ? `${existing}\n\n${updates}` : updates;
+        }
+        await this.saveRulesAsync(content);
+    }
+    /**
+     * Delete project rules
+     *
+     * @returns True if deleted, false if didn't exist
+     */
+    async deleteRulesAsync() {
+        if (!(await this.rulesExistAsync())) {
+            return false;
+        }
+        // eslint-disable-next-line security/detect-non-literal-fs-filename
+        await fs.unlink(this.rulesFilePath);
+        return true;
+    }
+}
+//# sourceMappingURL=rulesStore.js.map

package/dist/data/rulesStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulesStore.js","sourceRoot":"","sources":["../../src/data/rulesStore.ts"],"names":[],"mappings":"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"}