stringray-ai 1.0.0

package/scripts/demo/reporting-demonstration.ts

@@ -0,0 +1,184 @@
+/**
+ * Comprehensive Reporting System Demonstration
+ * Shows the on-demand reporting system with actual framework activity
+ */
+
+import { frameworkLogger } from "./src/framework-logger.js";
+import { frameworkReportingSystem } from "./src/reporting/framework-reporting-system.js";
+import { AgentDelegator } from "./src/delegation/agent-delegator.js";
+import { StrRayStateManager } from "./src/state/state-manager.js";
+
+async function demonstrateReportingSystem() {
+  console.log("🎯 STRRAY FRAMEWORK ON-DEMAND REPORTING SYSTEM DEMONSTRATION");
+  console.log("============================================================");
+
+  console.log("\n🏗️ Phase 1: Setting up framework components...");
+  const stateManager = new StrRayStateManager();
+  const delegator = new AgentDelegator(stateManager);
+
+  console.log("✅ Framework components initialized");
+
+  console.log("\n🚀 Phase 2: Generating framework activity...");
+
+  // Simulate comprehensive framework activity
+  await frameworkLogger.log("test-runner", "reporting demo started", "info");
+
+  // Simulate agent delegations with different scenarios
+  const testScenarios = [
+    {
+      operation: "create",
+      description: "Create new component",
+      context: { fileCount: 1, changeVolume: 50, dependencies: 2 },
+    },
+    {
+      operation: "refactor",
+      description: "Large refactoring task",
+      context: {
+        fileCount: 15,
+        changeVolume: 500,
+        dependencies: 8,
+        riskLevel: "high" as const,
+      },
+    },
+    {
+      operation: "debug",
+      description: "Complex debugging task",
+      context: {
+        fileCount: 3,
+        changeVolume: 20,
+        dependencies: 5,
+        riskLevel: "critical" as const,
+      },
+    },
+    {
+      operation: "test",
+      description: "Testing optimization",
+      context: { fileCount: 25, changeVolume: 100, dependencies: 1 },
+    },
+  ];
+
+  console.log("🤖 Simulating agent orchestration...");
+  for (const scenario of testScenarios) {
+    console.log(`   Processing: ${scenario.description}`);
+
+    const result = await delegator.analyzeDelegation({
+      operation: scenario.operation,
+      description: scenario.description,
+      context: scenario.context,
+      sessionId: `demo-session-${Date.now()}`,
+    });
+
+    // Log the delegation result
+    await frameworkLogger.log(
+      "demo-runner",
+      `delegated-${scenario.operation}`,
+      "success",
+      {
+        agent: result.agents[0],
+        strategy: result.strategy,
+        complexity: result.complexity.score,
+      },
+    );
+  }
+
+  // Simulate context awareness operations
+  console.log("🧠 Simulating context awareness operations...");
+  await frameworkLogger.log(
+    "codebase-context-analyzer",
+    "analysis-start",
+    "info",
+  );
+  await frameworkLogger.log(
+    "codebase-context-analyzer",
+    "analysis-complete",
+    "success",
+    {
+      filesAnalyzed: 55,
+      language: "typescript",
+    },
+  );
+
+  await frameworkLogger.log("ast-code-parser", "file-analysis-start", "info");
+  await frameworkLogger.log(
+    "ast-code-parser",
+    "file-analysis-complete",
+    "success",
+    {
+      functions: 12,
+      classes: 3,
+      complexity: 25,
+    },
+  );
+
+  await frameworkLogger.log(
+    "complexity-analyzer",
+    "context-enhancement-failed",
+    "info",
+    {
+      operation: "refactor",
+      error: "Test enhancement scenario",
+    },
+  );
+
+  console.log("✅ Framework activity generation complete");
+
+  console.log("\n📊 Phase 3: Generating comprehensive reports...");
+
+  // Generate orchestration report
+  console.log("📋 Generating orchestration report...");
+  const orchestrationReport = await frameworkReportingSystem.generateReport({
+    type: "orchestration",
+    timeRange: { lastHours: 1 },
+    outputFormat: "markdown",
+    detailedMetrics: true,
+  });
+
+  // Generate agent usage report
+  console.log("🤖 Generating agent usage report...");
+  const agentReport = await frameworkReportingSystem.generateReport({
+    type: "agent-usage",
+    timeRange: { lastHours: 1 },
+    outputFormat: "markdown",
+    detailedMetrics: true,
+  });
+
+  // Generate full analysis report
+  console.log("🔍 Generating full analysis report...");
+  const fullReport = await frameworkReportingSystem.generateReport({
+    type: "full-analysis",
+    timeRange: { lastHours: 1 },
+    outputFormat: "markdown",
+    detailedMetrics: true,
+  });
+
+  console.log("\n🎉 REPORTS GENERATED SUCCESSFULLY!");
+  console.log("===================================");
+
+  console.log("\n📋 ORCHESTRATION REPORT:");
+  console.log("========================");
+  console.log(orchestrationReport);
+
+  console.log("\n🤖 AGENT USAGE REPORT:");
+  console.log("======================");
+  console.log(agentReport);
+
+  console.log("\n🔍 FULL ANALYSIS REPORT:");
+  console.log("========================");
+  console.log(fullReport);
+
+  console.log("\n✅ DEMONSTRATION COMPLETE!");
+  console.log("==========================");
+  console.log(
+    "The on-demand reporting system successfully captured and analyzed:",
+  );
+  console.log(`- ${testScenarios.length} agent delegations`);
+  console.log("- 4 context awareness operations");
+  console.log("- Real-time metrics and insights");
+  console.log("- Comprehensive framework health assessment");
+  console.log(
+    "\n🎯 The system provides detailed, actionable intelligence about framework operations!",
+  );
+}
+
+// Run the demonstration
+demonstrateReportingSystem().catch(console.error);

package/scripts/demo/reporting-examples.ts

@@ -0,0 +1,105 @@
+/**
+ * StrRay Framework - On-Demand Reporting Examples
+ *
+ * Usage examples for the framework reporting system
+ */
+
+// Example 1: Generate a comprehensive orchestration report
+import { frameworkReportingSystem } from "./src/reporting/framework-reporting-system.js";
+
+async function generateOrchestrationReport() {
+  const report = await frameworkReportingSystem.generateReport({
+    type: "orchestration",
+    timeRange: { lastHours: 1 },
+    outputFormat: "markdown",
+    outputPath: "./reports/orchestration-report.md",
+    detailedMetrics: true,
+  });
+
+  console.log(
+    "Orchestration report generated:",
+    report.substring(0, 200) + "...",
+  );
+}
+
+// Example 2: Get real-time framework status
+async function getRealtimeStatus() {
+  const status = await frameworkReportingSystem.getRealtimeStatus();
+
+  console.log("Framework Status:");
+  console.log("- Active Components:", status.activeComponents);
+  console.log("- Health Score:", status.healthScore.toFixed(1) + "%");
+  console.log("- Recent Alerts:", status.alerts.length);
+}
+
+// Example 3: Schedule automated daily reports
+function setupAutomatedReporting() {
+  frameworkReportingSystem.scheduleAutomatedReports({
+    frequency: "daily",
+    types: ["orchestration", "agent-usage", "performance"],
+    outputDir: "./reports/daily/",
+    retentionDays: 30,
+  });
+
+  console.log("Automated daily reporting scheduled");
+}
+
+// Example 4: Create custom report template
+function createCustomReportTemplate() {
+  const template = frameworkReportingSystem.createCustomReport({
+    name: "Security Audit",
+    filters: {
+      components: ["security-auditor", "codex-injector"],
+      actions: ["scan", "validate", "inject"],
+      status: ["success", "error"],
+    },
+    aggregations: {
+      groupBy: "component",
+      metrics: ["count", "successRate"],
+    },
+    visualizations: ["pie-chart", "timeline"],
+  });
+
+  console.log("Custom report template:", template);
+}
+
+// CLI Usage Examples:
+// npm run report orchestration markdown ./reports/orchestration.md
+// npm run report agent-usage json
+// npm run report context-awareness html ./reports/context.html
+
+// Run examples
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const command = process.argv[2];
+
+  switch (command) {
+    case "orchestration":
+      generateOrchestrationReport();
+      break;
+    case "status":
+      getRealtimeStatus();
+      break;
+    case "schedule":
+      setupAutomatedReporting();
+      break;
+    case "custom":
+      console.log(createCustomReportTemplate());
+      break;
+    default:
+      console.log(`
+StrRay Framework Reporting System
+
+Usage: node reporting-examples.js <command>
+
+Commands:
+  orchestration  Generate orchestration report
+  status        Get real-time framework status
+  schedule      Setup automated reporting
+  custom        Show custom report template
+
+Examples:
+  node reporting-examples.js orchestration
+  node reporting-examples.js status
+      `);
+  }
+}

package/scripts/dependency-scan.cjs

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+/**
+ * Dependency Vulnerability Scanner
+ *
+ * Scans dependencies for known vulnerabilities and suggests fixes.
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+class DependencyScanner {
+  constructor() {
+    this.projectRoot = path.resolve('.');
+  }
+
+  scan() {
+    console.log('🔍 Scanning dependencies for vulnerabilities...\n');
+
+    try {
+      // Check for package-lock.json
+      const lockfilePath = path.join(this.projectRoot, 'package-lock.json');
+      if (!fs.existsSync(lockfilePath)) {
+        console.error('❌ Missing package-lock.json - run npm install first');
+        process.exit(1);
+      }
+
+      // Run npm audit
+      console.log('📊 Running npm audit...');
+      const auditOutput = execSync('npm audit --audit-level=moderate --json', {
+        encoding: 'utf-8',
+        cwd: this.projectRoot
+      });
+
+      const auditResult = JSON.parse(auditOutput);
+
+      if (auditResult.metadata && auditResult.metadata.vulnerabilities) {
+        const vuln = auditResult.metadata.vulnerabilities;
+        console.log(`📈 Audit Results:`);
+        console.log(`   Total Dependencies: ${auditResult.metadata.totalDependencies || 'Unknown'}`);
+        console.log(`   Vulnerabilities: ${vuln.total || 0}`);
+        console.log(`   - Critical: ${vuln.critical || 0}`);
+        console.log(`   - High: ${vuln.high || 0}`);
+        console.log(`   - Moderate: ${vuln.moderate || 0}`);
+        console.log(`   - Low: ${vuln.low || 0}\n`);
+
+        if ((vuln.critical || 0) > 0 || (vuln.high || 0) > 0) {
+          console.log('🚨 HIGH PRIORITY: Critical or High severity vulnerabilities found!');
+          console.log('💡 Run: npm audit fix');
+          console.log('💡 Or manually update vulnerable packages\n');
+        }
+
+        // Show actionable advice
+        if (auditResult.actions && auditResult.actions.length > 0) {
+          console.log('🔧 Recommended Actions:');
+          auditResult.actions.forEach((action, index) => {
+            console.log(`   ${index + 1}. ${action.message}`);
+            if (action.resolves && action.resolves.length > 0) {
+              action.resolves.forEach(resolve => {
+                console.log(`      - ${resolve.path} (${resolve.dev ? 'dev' : 'prod'})`);
+              });
+            }
+            console.log('');
+          });
+        }
+      }
+
+      // Check for outdated packages
+      console.log('📅 Checking for outdated packages...');
+      try {
+        const outdatedOutput = execSync('npm outdated --json', {
+          encoding: 'utf-8',
+          cwd: this.projectRoot
+        });
+
+        const outdated = JSON.parse(outdatedOutput);
+        const outdatedCount = Object.keys(outdated).length;
+
+        if (outdatedCount > 0) {
+          console.log(`⚠️  ${outdatedCount} packages are outdated:`);
+          Object.entries(outdated).forEach(([pkg, info]) => {
+            console.log(`   - ${pkg}: ${info.current} → ${info.latest}`);
+          });
+          console.log('\n💡 Run: npm update (or npm update <package> for specific packages)');
+        } else {
+          console.log('✅ All dependencies are up to date');
+        }
+      } catch (error) {
+        // npm outdated exits with code 1 when there are outdated packages
+        if (error.status === 1) {
+          const outdated = JSON.parse(error.stdout);
+          const outdatedCount = Object.keys(outdated).length;
+          console.log(`⚠️  ${outdatedCount} packages are outdated:`);
+          Object.entries(outdated).forEach(([pkg, info]) => {
+            console.log(`   - ${pkg}: ${info.current} → ${info.latest}`);
+          });
+          console.log('\n💡 Run: npm update (or npm update <package> for specific packages)');
+        }
+      }
+
+    } catch (error) {
+      console.error('❌ Error running dependency scan:', error.message);
+      process.exit(1);
+    }
+  }
+}
+
+// Run the scanner
+const scanner = new DependencyScanner();
+scanner.scan();