Overseer MCP Server

Instructions

Implementation Reference

• src/tools/secrets-template.ts:27-48 (handler)

  The `handleSecretsTemplate` function that executes the tool logic for 'overseer.secrets_template', currently implemented as a stub for a planned feature.

  export async function handleSecretsTemplate(
    args: {
      repo_name: string;
      template_type?: 'env-file' | 'vault' | 'aws-secrets-manager';
    },
    phaseManager: PhaseManager
  ): Promise<{
    success: boolean;
    files_created: string[];
    secrets_structure: Record<string, unknown>;
    instructions: string;
  }> {
    // Note: secrets_template is a planned feature for v1.1+
    // This tool will generate secure templates for managing secrets
    
    return {
      success: true,
      files_created: [],
      secrets_structure: {},
      instructions: `Secrets template generation for ${args.template_type || 'env-file'} is planned for v1.1.0. This tool will create secure templates for managing credentials and secrets.`,
    };
  }

• src/tools/secrets-template.ts:4-25 (schema)

  Defines the tool metadata, name, description, and input schema for 'overseer.secrets_template'.

  export function createSecretsTemplateTool(phaseManager: PhaseManager): Tool {
    return {
      name: 'overseer.secrets_template',
      description: 'Creates a template structure for managing secrets and credentials securely.',
      inputSchema: {
        type: 'object',
        required: ['repo_name'],
        properties: {
          repo_name: {
            type: 'string',
            description: 'Name of the repository',
          },
          template_type: {
            type: 'string',
            enum: ['env-file', 'vault', 'aws-secrets-manager'],
            default: 'env-file',
            description: 'Type of secrets template to create',
          },
        },
      },
    };
  }

• src/tools/index.ts:15-15 (registration)

  Imports the tool creator and handler functions specific to overseer.secrets_template.

  import { createSecretsTemplateTool, handleSecretsTemplate } from './secrets-template.js';

• src/tools/index.ts:39-39 (registration)

  Adds the overseer.secrets_template tool to the list of available tools in createTools.

  createSecretsTemplateTool(context.phaseManager),

• src/tools/index.ts:75-76 (registration)

  Registers the handler dispatch for 'overseer.secrets_template' in the central handleToolCall switch statement.

  case 'overseer.secrets_template':
    return await handleSecretsTemplate(args, context.phaseManager);