visualize_system

Instructions

Implementation Reference

• index.js:812-863 (handler)

  Main handler for the visualize_system tool. Iterates over all lines, loops, and vibes data structures and builds a textual visualization string. Optionally includes rhythm patterns and a time-window rhythm diagram.

  visualizeSystem(args) {
    const { show_rhythms = true, time_window = 16 } = args;
  
    const lines = Array.from(this.lines.values());
    const loops = Array.from(this.loops.values());
    const vibes = Array.from(this.vibes.values());
  
    let visualization = '🎨 LINES-LOOPS-VIBES SYSTEM\n\n';
  
    if (lines.length > 0) {
      visualization += '〰️ LINES:\n';
      lines.forEach(line => {
        visualization += `  ${line.name}: ${line.from} → ${line.to}`;
        if (show_rhythms) visualization += ` [${line.rhythm}]`;
        visualization += '\n';
      });
      visualization += '\n';
    }
  
    if (loops.length > 0) {
      visualization += '🔄 LOOPS:\n';
      loops.forEach(loop => {
        visualization += `  ${loop.name}: ${loop.type}`;
        if (show_rhythms) visualization += ` [${loop.rhythm}]`;
        visualization += ` (${loop.iterations.length} iterations)\n`;
      });
      visualization += '\n';
    }
  
    if (vibes.length > 0) {
      visualization += '✨ VIBES:\n';
      vibes.forEach(vibe => {
        visualization += `  ${vibe.name}: ${vibe.energy} @ ${vibe.frequency}Hz`;
        if (show_rhythms) visualization += ` [${vibe.rhythm}]`;
        visualization += '\n';
      });
      visualization += '\n';
    }
  
    if (show_rhythms) {
      visualization += this.visualizeSystemRhythm(time_window);
    }
  
    return {
      content: [
        {
          type: 'text',
          text: visualization,
        },
      ],
    };
  }

• index.js:275-291 (schema)

  Schema registration for the visualize_system tool, defining its name, description, and input parameters (show_rhythms boolean, time_window number).

  {
    name: 'visualize_system',
    description: 'Visualize the entire lines-loops-vibes system',
    inputSchema: {
      type: 'object',
      properties: {
        show_rhythms: {
          type: 'boolean',
          description: 'Show rhythm patterns',
          default: true,
        },
        time_window: {
          type: 'number',
          description: 'Time window to visualize (in beats)',
        },
      },
    },

• index.js:349-358 (registration)

  Registration of visualize_system in the CallToolRequestSchema switch statement, dispatching to this.visualizeSystem(args).

      case 'visualize_system':
        return this.visualizeSystem(args);
      case 'save_data':
        return this.saveData(args);
      case 'load_data':
        return this.loadDataTool(args);
      default:
        throw new Error(`Unknown tool: ${name}`);
    }
  });

• index.js:1040-1055 (helper)

  Helper method that generates an ASCII rhythm visualization showing beat patterns for Lines, Loops, and Vibes over a given time window.

  visualizeSystemRhythm(timeWindow) {
    let rhythm = '🎵 SYSTEM RHYTHM (next ' + timeWindow + ' beats):\n';
    rhythm += '┌' + '─'.repeat(timeWindow * 2) + '┐\n';
  
    const types = ['Lines', 'Loops', 'Vibes'];
    types.forEach(type => {
      rhythm += '│';
      for (let i = 0; i < timeWindow; i++) {
        rhythm += i % 4 === 0 ? '█ ' : '░ ';
      }
      rhythm += '│ ' + type + '\n';
    });
  
    rhythm += '└' + '─'.repeat(timeWindow * 2) + '┘\n';
    return rhythm;
  }