framework-mcp 2.4.6 → 2.6.0

package/scripts/standardize-prompts.js

@@ -1,325 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-class PromptStandardizer {
-  constructor() {
-    this.safeguardManagerPath = path.join(__dirname, '..', 'src/core/safeguard-manager.ts');
-    this.backupPath = `${this.safeguardManagerPath}.backup.${Date.now()}`;
-    this.dryRun = false;
-    this.verbose = false;
-  }
-
-  /**
-   * Extract template objectives from safeguard 10.2
-   */
-  extractTemplateObjectives() {
-    const content = fs.readFileSync(this.safeguardManagerPath, 'utf-8');
-
-    // Find safeguard 10.2 and extract the objectives
-    const safeguard10_2Match = content.match(/"10\.2":\s*{[\s\S]*?systemPromptValidates:\s*{[\s\S]*?}\s*}/);
-    if (!safeguard10_2Match) {
-      throw new Error('Could not find safeguard 10.2 definition');
-    }
-
-    const safeguard10_2Text = safeguard10_2Match[0];
-
-    // Extract objectives for each capability
-    const extractObjective = (capability) => {
-      const regex = new RegExp(`systemPrompt${capability}:[\\s\\S]*?objective:\\s*"([^"]*)"`, 'i');
-      const match = safeguard10_2Text.match(regex);
-      if (!match) {
-        throw new Error(`Could not find ${capability} objective in safeguard 10.2`);
-      }
-      return match[1];
-    };
-
-    const template = {
-      Full: extractObjective('Full'),
-      Partial: extractObjective('Partial'),
-      Facilitates: extractObjective('Facilitates'),
-      Governance: extractObjective('Governance'),
-      Validates: extractObjective('Validates')
-    };
-
-    if (this.verbose) {
-      console.log('📋 Extracted template objectives:');
-      Object.entries(template).forEach(([key, value]) => {
-        console.log(`  ${key}: ${value.substring(0, 80)}...`);
-      });
-    }
-
-    return template;
-  }
-
-  /**
-   * Apply standardization using global replacements
-   */
-  standardizeContent(template) {
-    let content = fs.readFileSync(this.safeguardManagerPath, 'utf-8');
-    let totalReplacements = 0;
-
-    // Track changes
-    const stats = {
-      objectiveReplacements: 0,
-      guidelineReplacements: 0,
-      outputFormatReplacements: 0,
-      implementationSimplifications: 0
-    };
-
-    // Step 1: Replace all objectives with template objectives
-    const capabilities = ['Full', 'Partial', 'Facilitates', 'Governance', 'Validates'];
-
-    for (const capability of capabilities) {
-      const templateObjective = template[capability];
-
-      // Replace all objectives for this capability (excluding 10.2)
-      const objectiveRegex = new RegExp(
-        `(systemPrompt${capability}:[\\s\\S]*?objective:\\s*)"[^"]*"`,
-        'g'
-      );
-
-      let matches = 0;
-      content = content.replace(objectiveRegex, (match, prefix, offset) => {
-        // Skip if this is within safeguard 10.2
-        const before = content.substring(Math.max(0, offset - 500), offset);
-        if (before.includes('"10.2":')) {
-          return match; // Don't replace template safeguard
-        }
-        matches++;
-        return `${prefix}"${templateObjective}"`;
-      });
-
-      stats.objectiveReplacements += matches;
-      if (this.verbose && matches > 0) {
-        console.log(`  ✅ Updated ${matches} ${capability} objectives`);
-      }
-    }
-
-    // Step 2: Replace all guidelines with ["Future Use"] (excluding 10.2)
-    const guidelineRegex = /(systemPrompt(?:Full|Partial|Facilitates|Governance|Validates):[\s\S]*?guidelines:\s*)\[[\s\S]*?\]/g;
-
-    content = content.replace(guidelineRegex, (match, prefix, offset) => {
-      // Skip if this is within safeguard 10.2
-      const before = content.substring(Math.max(0, offset - 500), offset);
-      if (before.includes('"10.2":')) {
-        return match; // Don't replace template safeguard
-      }
-      stats.guidelineReplacements++;
-      return `${prefix}[\n        "Future Use"\n      ]`;
-    });
-
-    // Step 3: Replace all outputFormat with standardized version (excluding 10.2)
-    const outputFormatRegex = /(systemPrompt(?:Full|Partial|Facilitates|Governance|Validates):[\s\S]*?outputFormat:\s*)"[^"]*"/g;
-    const standardOutputFormat = 'Provide a structured assessment, confidence score, and evidence summary';
-
-    content = content.replace(outputFormatRegex, (match, prefix, offset) => {
-      // Skip if this is within safeguard 10.2
-      const before = content.substring(Math.max(0, offset - 500), offset);
-      if (before.includes('"10.2":')) {
-        return match; // Don't replace template safeguard
-      }
-      stats.outputFormatReplacements++;
-      return `${prefix}"${standardOutputFormat}"`;
-    });
-
-    // Step 4: Simplify implementation suggestions (excluding 10.2)
-    const implRegex = /(implementationSuggestions:\s*\[\s*)((?:\s*"[^"]*",?\s*)+)(\s*\])/g;
-
-    content = content.replace(implRegex, (match, prefix, suggestions, suffix, offset) => {
-      // Skip if this is within safeguard 10.2
-      const before = content.substring(Math.max(0, offset - 500), offset);
-      if (before.includes('"10.2":')) {
-        return match; // Don't replace template safeguard
-      }
-
-      // Extract individual suggestions
-      const suggestionMatches = suggestions.match(/"[^"]+"/g) || [];
-
-      if (suggestionMatches.length > 3) {
-        stats.implementationSimplifications++;
-        const simplified = suggestionMatches.slice(0, 3).join(',\n      ');
-        return `${prefix} // Gray - Implementation suggestions\n      ${simplified}\n    ${suffix}`;
-      }
-
-      return match; // Keep as is if 3 or fewer suggestions
-    });
-
-    if (this.verbose) {
-      console.log('📊 Transformation statistics:');
-      console.log(`  - Objective replacements: ${stats.objectiveReplacements}`);
-      console.log(`  - Guideline replacements: ${stats.guidelineReplacements}`);
-      console.log(`  - Output format replacements: ${stats.outputFormatReplacements}`);
-      console.log(`  - Implementation simplifications: ${stats.implementationSimplifications}`);
-    }
-
-    return { content, stats };
-  }
-
-  /**
-   * Create backup of original safeguard-manager.ts
-   */
-  createBackup() {
-    if (this.verbose) {
-      console.log(`📁 Creating backup: ${this.backupPath}`);
-    }
-    fs.copyFileSync(this.safeguardManagerPath, this.backupPath);
-  }
-
-  /**
-   * Save updated content
-   */
-  saveContent(content) {
-    if (this.dryRun) {
-      console.log('🔍 DRY RUN: Would save updated content to file');
-      return;
-    }
-
-    if (this.verbose) {
-      console.log('💾 Saving updated content...');
-    }
-
-    fs.writeFileSync(this.safeguardManagerPath, content);
-
-    if (this.verbose) {
-      console.log('✅ File saved successfully');
-    }
-  }
-
-  /**
-   * Validate transformation results
-   */
-  validateTransformation(content) {
-    if (this.verbose) {
-      console.log('🔍 Validating transformation...');
-    }
-
-    let isValid = true;
-    const errors = [];
-
-    // Count "Future Use" guidelines
-    const futureUseMatches = content.match(/guidelines:\s*\[\s*"Future Use"\s*\]/g);
-    const futureUseCount = futureUseMatches ? futureUseMatches.length : 0;
-
-    // Expected: 153 safeguards × 5 capabilities = 765
-    // But safeguard 10.2 already has 5, so we should see 760 from transformation + 5 existing = 765 total
-    const expectedTotal = 765;
-
-    if (futureUseCount !== expectedTotal) {
-      errors.push(`Expected ${expectedTotal} "Future Use" guidelines, found ${futureUseCount}`);
-      isValid = false;
-    }
-
-    // Count standardized output formats
-    const outputFormatMatches = content.match(/outputFormat:\s*"Provide a structured assessment, confidence score, and evidence summary"/g);
-    const outputFormatCount = outputFormatMatches ? outputFormatMatches.length : 0;
-
-    if (outputFormatCount !== expectedTotal) {
-      errors.push(`Expected ${expectedTotal} standardized output formats, found ${outputFormatCount}`);
-      isValid = false;
-    }
-
-    // Verify template objectives are applied
-    const fullObjectiveMatches = content.match(/The vendor has taken an assessment and has been mapped to FULL.*?FULLY\./g);
-    const fullObjectiveCount = fullObjectiveMatches ? fullObjectiveMatches.length : 0;
-
-    if (fullObjectiveCount !== 153) {
-      errors.push(`Expected 153 FULL template objectives, found ${fullObjectiveCount}`);
-      isValid = false;
-    }
-
-    if (errors.length > 0) {
-      console.error('❌ Validation errors:');
-      errors.forEach(error => console.error(`  - ${error}`));
-    } else {
-      console.log('✅ Validation passed: All transformations applied successfully');
-    }
-
-    return isValid;
-  }
-
-  /**
-   * Main transformation process
-   */
-  async run(options = {}) {
-    this.dryRun = options.dryRun || false;
-    this.verbose = options.verbose || false;
-
-    try {
-      console.log('🚀 Starting prompt standardization...');
-
-      // Create backup unless dry run
-      if (!this.dryRun) {
-        this.createBackup();
-      }
-
-      // Extract template objectives from 10.2
-      console.log('📋 Extracting template from safeguard 10.2...');
-      const template = this.extractTemplateObjectives();
-
-      // Apply standardization
-      console.log('🔄 Applying standardization to all safeguards (excluding 10.2)...');
-      const { content, stats } = this.standardizeContent(template);
-
-      // Validate if requested
-      if (options.validate) {
-        const isValid = this.validateTransformation(content);
-        if (!isValid) {
-          throw new Error('Validation failed - transformation incomplete');
-        }
-      }
-
-      // Save results
-      this.saveContent(content);
-
-      console.log('🎉 Standardization complete!');
-      console.log('📊 Summary:');
-      console.log(`  - Objective updates: ${stats.objectiveReplacements}`);
-      console.log(`  - Guideline standardizations: ${stats.guidelineReplacements}`);
-      console.log(`  - Output format standardizations: ${stats.outputFormatReplacements}`);
-      console.log(`  - Implementation simplifications: ${stats.implementationSimplifications}`);
-      if (!this.dryRun) {
-        console.log(`  - Backup: ${this.backupPath}`);
-      }
-
-    } catch (error) {
-      console.error('❌ Error during standardization:', error);
-      process.exit(1);
-    }
-  }
-}
-
-// CLI interface
-if (import.meta.url === `file://${process.argv[1]}`) {
-  const args = process.argv.slice(2);
-  const options = {
-    dryRun: args.includes('--dry-run'),
-    validate: args.includes('--validate'),
-    verbose: args.includes('--verbose')
-  };
-
-  if (args.includes('--help')) {
-    console.log(`
-Usage: npm run standardize-prompts [options]
-
-Options:
-  --dry-run    Show what would be changed without making actual changes
-  --validate   Run validation after transformation
-  --verbose    Show detailed progress information
-  --help       Show this help message
-
-Examples:
-  npm run standardize-prompts --dry-run --verbose
-  npm run standardize-prompts --validate --verbose
-`);
-    process.exit(0);
-  }
-
-  const standardizer = new PromptStandardizer();
-  standardizer.run(options).catch(console.error);
-}

package/scripts/validate-capability-prompts.js

@@ -1,110 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Validate that all 153 safeguards have complete capability-specific prompts
- * This script verifies the transformation was successful
- */
-
-import { SafeguardManager } from '../dist/core/safeguard-manager.js';
-
-function validateCapabilityPrompts() {
-  console.log('🔍 Starting capability prompt validation...');
-
-  const safeguardManager = new SafeguardManager();
-  const allSafeguards = safeguardManager.getAllSafeguards();
-  const safeguardIds = Object.keys(allSafeguards);
-
-  console.log(`📊 Found ${safeguardIds.length} safeguards to validate`);
-
-  const expectedFields = [
-    'systemPromptFull',
-    'systemPromptPartial',
-    'systemPromptFacilitates',
-    'systemPromptGovernance',
-    'systemPromptValidates'
-  ];
-
-  const requiredSubfields = ['role', 'context', 'objective', 'guidelines', 'outputFormat'];
-
-  let totalValidated = 0;
-  let errors = [];
-
-  for (const safeguardId of safeguardIds) {
-    const safeguard = allSafeguards[safeguardId];
-
-    // Check if all five capability prompts exist
-    for (const field of expectedFields) {
-      if (!safeguard[field]) {
-        errors.push(`❌ ${safeguardId}: Missing ${field}`);
-        continue;
-      }
-
-      // Check if each prompt has the required structure
-      const prompt = safeguard[field];
-      for (const subfield of requiredSubfields) {
-        if (!prompt[subfield]) {
-          errors.push(`❌ ${safeguardId}.${field}: Missing ${subfield}`);
-        }
-
-        if (subfield === 'guidelines' && (!Array.isArray(prompt[subfield]) || prompt[subfield].length === 0)) {
-          errors.push(`❌ ${safeguardId}.${field}: Guidelines must be non-empty array`);
-        }
-
-        if (subfield !== 'guidelines' && (!prompt[subfield] || typeof prompt[subfield] !== 'string')) {
-          errors.push(`❌ ${safeguardId}.${field}: ${subfield} must be non-empty string`);
-        }
-      }
-    }
-
-    // Check that old systemPrompt field is gone
-    if ('systemPrompt' in safeguard) {
-      errors.push(`❌ ${safeguardId}: Deprecated systemPrompt field still exists`);
-    }
-
-    totalValidated++;
-  }
-
-  // Report results
-  console.log(`\n📊 Validation Results:`);
-  console.log(`✅ Safeguards validated: ${totalValidated}`);
-  console.log(`❌ Errors found: ${errors.length}`);
-
-  if (errors.length > 0) {
-    console.log(`\n🚨 Validation Errors:`);
-    errors.forEach(error => console.log(error));
-    process.exit(1);
-  } else {
-    console.log(`\n🎉 All ${totalValidated} safeguards have complete capability-specific prompts!`);
-    console.log(`✅ All safeguards properly transformed`);
-    console.log(`✅ No deprecated systemPrompt fields found`);
-    console.log(`✅ All capability prompts have complete structure`);
-  }
-}
-
-// Validate specific prompt structure
-function validatePromptStructure(prompt, safeguardId, fieldName) {
-  const requiredFields = ['role', 'context', 'objective', 'guidelines', 'outputFormat'];
-  const errors = [];
-
-  for (const field of requiredFields) {
-    if (!prompt[field]) {
-      errors.push(`Missing ${field}`);
-    } else if (field === 'guidelines') {
-      if (!Array.isArray(prompt[field]) || prompt[field].length === 0) {
-        errors.push(`Guidelines must be non-empty array`);
-      }
-    } else if (typeof prompt[field] !== 'string' || prompt[field].trim() === '') {
-      errors.push(`${field} must be non-empty string`);
-    }
-  }
-
-  return errors;
-}
-
-// Export for testing
-export { validateCapabilityPrompts, validatePromptStructure };
-
-// Run validation if this file is executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  validateCapabilityPrompts();
-}

package/scripts/validate-documentation.sh

@@ -1,150 +0,0 @@
-#!/bin/bash
-
-echo "🔍 Framework MCP Documentation Validation"
-echo "========================================"
-echo
-
-# Check if we're in the right directory
-if [ ! -f "package.json" ]; then
-    echo "❌ Error: Run this script from the Framework MCP root directory"
-    exit 1
-fi
-
-# Build the project
-echo "📦 Building project..."
-npm run build
-if [ $? -ne 0 ]; then
-    echo "❌ Build failed"
-    exit 1
-fi
-echo "✅ Build successful"
-echo
-
-# Test HTTP server startup  
-echo "🚀 Testing HTTP server startup..."
-PORT=9004 node dist/interfaces/http/http-server.js &
-SERVER_PID=$!
-sleep 5
-
-# Test health endpoint
-echo "🏥 Testing health endpoint..."
-HEALTH=$(curl -s http://localhost:9004/health 2>/dev/null)
-if echo "$HEALTH" | jq -e '.status == "healthy"' > /dev/null 2>&1; then
-    echo "✅ Health endpoint working"
-    VERSION=$(echo "$HEALTH" | jq -r '.version')
-    echo "   Version: $VERSION"
-else
-    echo "❌ Health endpoint failed"
-    kill $SERVER_PID 2>/dev/null
-    exit 1
-fi
-
-# Test all API endpoints
-echo
-echo "🔧 Testing API endpoints..."
-
-# Test safeguards list
-SAFEGUARDS=$(curl -s http://localhost:9004/api/safeguards 2>/dev/null)
-TOTAL=$(echo "$SAFEGUARDS" | jq -r '.total' 2>/dev/null)
-if [ "$TOTAL" = "153" ]; then
-    echo "✅ Safeguards endpoint: $TOTAL safeguards"
-else
-    echo "❌ Safeguards endpoint failed (expected 153, got $TOTAL)"
-fi
-
-# Test safeguard details
-DETAILS=$(curl -s http://localhost:9004/api/safeguards/1.1 2>/dev/null)
-TITLE=$(echo "$DETAILS" | jq -r '.title' 2>/dev/null)
-if [[ "$TITLE" == "Establish and Maintain"* ]]; then
-    echo "✅ Safeguard details endpoint working"
-else
-    echo "❌ Safeguard details endpoint failed"
-fi
-
-# Test validate vendor mapping
-VALIDATION=$(curl -s -X POST http://localhost:9004/api/validate-vendor-mapping \
-    -H "Content-Type: application/json" \
-    -d '{"vendor_name":"Test Vendor","safeguard_id":"1.1","claimed_capability":"facilitates","supporting_text":"Our tool enhances existing asset management systems with additional discovery capabilities and detailed reporting features."}' 2>/dev/null)
-VALIDATION_STATUS=$(echo "$VALIDATION" | jq -r '.validation_status' 2>/dev/null)
-if [ "$VALIDATION_STATUS" != "null" ] && [ "$VALIDATION_STATUS" != "" ]; then
-    echo "✅ Validate vendor mapping endpoint working"
-else
-    echo "❌ Validate vendor mapping endpoint failed"
-fi
-
-# Test analyze vendor response
-ANALYSIS=$(curl -s -X POST http://localhost:9004/api/analyze-vendor-response \
-    -H "Content-Type: application/json" \
-    -d '{"vendor_name":"ServiceNow CMDB","safeguard_id":"1.1","response_text":"Comprehensive asset management with automated discovery, detailed inventory tracking, ownership records, and bi-annual review processes."}' 2>/dev/null)
-CAPABILITY=$(echo "$ANALYSIS" | jq -r '.determined_capability' 2>/dev/null)
-if [ "$CAPABILITY" != "null" ] && [ "$CAPABILITY" != "" ]; then
-    echo "✅ Analyze vendor response endpoint working"
-else
-    echo "❌ Analyze vendor response endpoint failed"  
-fi
-
-# Test deprecated endpoint removal
-DEPRECATED=$(curl -s http://localhost:9004/api/validate-coverage-claim 2>/dev/null)
-if echo "$DEPRECATED" | jq -e '.error' > /dev/null 2>&1; then
-    echo "✅ Deprecated validate-coverage-claim endpoint properly removed"
-else
-    echo "❌ Deprecated endpoint still accessible"
-fi
-
-# Cleanup
-kill $SERVER_PID 2>/dev/null
-echo
-
-# Documentation consistency checks
-echo "📚 Checking documentation consistency..."
-
-# Check tool count consistency
-README_TOOLS=$(grep -c "validate_vendor_mapping\|analyze_vendor_response\|get_safeguard_details\|list_available_safeguards" README.md)
-CLAUDE_TOOLS=$(grep -c "validate_vendor_mapping\|analyze_vendor_response\|get_safeguard_details\|list_available_safeguards" CLAUDE.md)
-COPILOT_TOOLS=$(grep -c "validate_vendor_mapping\|analyze_vendor_response\|get_safeguard_details\|list_available_safeguards" COPILOT_INTEGRATION.md)
-
-if [ "$README_TOOLS" -ge 4 ] && [ "$CLAUDE_TOOLS" -ge 4 ] && [ "$COPILOT_TOOLS" -ge 4 ]; then
-    echo "✅ All documentation references 4 tools consistently"
-else
-    echo "❌ Tool count inconsistency: README($README_TOOLS), CLAUDE($CLAUDE_TOOLS), COPILOT($COPILOT_TOOLS)"
-fi
-
-# Check version consistency
-VERSION_FILES=("package.json" "swagger.json" "CLAUDE.md" "COPILOT_INTEGRATION.md" "DEPLOYMENT_GUIDE.md")
-VERSION_ISSUES=()
-
-for file in "${VERSION_FILES[@]}"; do
-    if [ -f "$file" ]; then
-        if ! grep -q "1.4.0" "$file"; then
-            VERSION_ISSUES+=("$file")
-        fi
-    fi
-done
-
-if [ ${#VERSION_ISSUES[@]} -eq 0 ]; then
-    echo "✅ Version 1.4.0 consistent across all files"
-else
-    echo "❌ Version inconsistency in: ${VERSION_ISSUES[*]}"
-fi
-
-# Check for deprecated references
-DEPRECATED_FILES=$(grep -l "validate_coverage_claim" *.md 2>/dev/null || true)
-if [ -z "$DEPRECATED_FILES" ]; then
-    echo "✅ No deprecated validate_coverage_claim references in documentation"
-else
-    echo "❌ Deprecated references found in: $DEPRECATED_FILES"
-fi
-
-# Summary
-echo
-echo "📊 VALIDATION SUMMARY"
-echo "===================="
-echo "✅ Build: Successful"
-echo "✅ HTTP Server: Working"  
-echo "✅ All 4 API Endpoints: Functional"
-echo "✅ 153 CIS Safeguards: Available"
-echo "✅ Documentation: Consistent"
-echo "✅ Version 1.4.0: Aligned"
-echo "✅ Architecture: Clean (4 tools)"
-echo
-echo "🎉 Framework MCP v1.4.0 Ready for Release!"