mcp-with-ssh

Instructions

Implementation Reference

• src/server/tools/DecisionTools.ts:51-88 (handler)

  The main handler function for the 'log_decision' tool. It calls ProgressTracker.logDecision to log the decision and also tracks progress.

  export async function handleLogDecision(
    progressTracker: ProgressTracker,
    decision: {
      title: string;
      context: string;
      decision: string;
      alternatives?: string[] | string;
      consequences?: string[] | string;
    }
  ) {
    try {
      await progressTracker.logDecision(decision);
  
      // Also track this as progress
      await progressTracker.trackProgress('Decision Made', {
        description: decision.title,
      });
  
      return {
        content: [
          {
            type: 'text',
            text: `Decision logged: ${decision.title}`,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Error logging decision: ${error}`,
          },
        ],
        isError: true,
      };
    }
  }

• src/core/ProgressTracker.ts:321-361 (helper)

  Core helper method in ProgressTracker that implements the logic to append a formatted decision entry to 'decision-log.md'.

    async logDecision(decision: Decision): Promise<void> {
      const decisionLogPath = path.join(this.memoryBankDir, 'decision-log.md');
      
      try {
        let decisionLogContent = await FileUtils.readFile(decisionLogPath);
        
        const timestamp = new Date().toISOString().split('T')[0];
        const time = new Date().toLocaleTimeString();
        const userId = decision.userId || this.userId;
        const formattedUserId = this.formatUserId(userId);
        
        // Format alternatives and consequences
        const alternatives = Array.isArray(decision.alternatives) 
          ? decision.alternatives.map(alt => `  - ${alt}`).join('\n') 
          : decision.alternatives || 'None';
          
        const consequences = Array.isArray(decision.consequences) 
          ? decision.consequences.map(cons => `  - ${cons}`).join('\n') 
          : decision.consequences || 'None';
        
        const newDecision = `
  ## ${decision.title}
  - **Date:** ${timestamp} ${time}
  - **Author:** ${formattedUserId}
  - **Context:** ${decision.context}
  - **Decision:** ${decision.decision}
  - **Alternatives Considered:** 
  ${Array.isArray(decision.alternatives) ? alternatives : `  - ${alternatives}`}
  - **Consequences:** 
  ${Array.isArray(decision.consequences) ? consequences : `  - ${consequences}`}
  `;
        
        // Add the new decision to the end of the file
        decisionLogContent += newDecision;
        
        await FileUtils.writeFile(decisionLogPath, decisionLogContent);
      } catch (error) {
        console.error(`Error logging decision: ${error}`);
        throw new Error(`Failed to log decision: ${error}`);
      }
    }

• src/server/tools/DecisionTools.ts:10-41 (schema)

  Input schema for the log_decision tool defining the expected parameters.

  inputSchema: {
    type: 'object',
    properties: {
      title: {
        type: 'string',
        description: 'Decision title',
      },
      context: {
        type: 'string',
        description: 'Decision context',
      },
      decision: {
        type: 'string',
        description: 'The decision made',
      },
      alternatives: {
        type: 'array',
        items: {
          type: 'string',
        },
        description: 'Alternatives considered',
      },
      consequences: {
        type: 'array',
        items: {
          type: 'string',
        },
        description: 'Consequences of the decision',
      },
    },
    required: ['title', 'context', 'decision'],
  },

• src/server/tools/DecisionTools.ts:6-43 (registration)

  Registration of the log_decision tool with name, description, and schema reference.

  export const decisionTools = [
    {
      name: 'log_decision',
      description: 'Log a decision in the decision log',
      inputSchema: {
        type: 'object',
        properties: {
          title: {
            type: 'string',
            description: 'Decision title',
          },
          context: {
            type: 'string',
            description: 'Decision context',
          },
          decision: {
            type: 'string',
            description: 'The decision made',
          },
          alternatives: {
            type: 'array',
            items: {
              type: 'string',
            },
            description: 'Alternatives considered',
          },
          consequences: {
            type: 'array',
            items: {
              type: 'string',
            },
            description: 'Consequences of the decision',
          },
        },
        required: ['title', 'context', 'decision'],
      },
    },
  ];

• src/server/tools/index.ts:30-38 (registration)

  Registration of all tools including decisionTools in the MCP server's ListToolsRequestHandler.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [
      ...coreTools,
      ...progressTools,
      ...contextTools,
      ...decisionTools,
      ...modeTools,
    ],
  }));

• src/server/tools/index.ts:216-250 (handler)

  Dispatch handler in the main tool call switch statement that validates arguments and calls handleLogDecision.

  case 'log_decision': {
    const progressTracker = getProgressTracker();
    if (!progressTracker) {
      return {
        content: [
          {
            type: 'text',
            text: 'Memory Bank not found. Use initialize_memory_bank to create one.',
          },
        ],
        isError: true,
      };
    }
  
    const { title, context, decision, alternatives, consequences } = request.params.arguments as {
      title: string;
      context: string;
      decision: string;
      alternatives?: string[] | string;
      consequences?: string[] | string;
    };
    if (!title || !context || !decision) {
      throw new McpError(
        ErrorCode.InvalidParams,
        'Title, context, and decision are required'
      );
    }
    return handleLogDecision(progressTracker, {
      title,
      context,
      decision,
      alternatives,
      consequences,
    });
  }