AI Agent Template MCP Server

Instructions

Implementation Reference

• src/tools/workspace/setup-persistence-automation.ts:25-117 (handler)

  Main handler function that orchestrates creation of update scripts, validation scripts, monitoring configs, git hooks, cron jobs, and GitHub Actions workflows for automated context persistence.
  export async function setupPersistenceAutomation( config: PersistenceConfig ): Promise<PersistenceResult> { const result: PersistenceResult = { success: false, filesCreated: [], message: '', setupInstructions: [], }; try { // Check if analysis has been completed const analysisId = config.analysisId || global.latestAnalysisId; if (!analysisId || !global.codebaseAnalysis?.[analysisId]) { throw new Error('Codebase analysis must be completed first. Run analyze_codebase_deeply tool.'); } const analysis: DeepAnalysisResult = global.codebaseAnalysis[analysisId]; // Create scripts directory const scriptsDir = join(config.projectPath, 'scripts'); if (!existsSync(scriptsDir)) { mkdirSync(scriptsDir, { recursive: true }); } // Create update script const updateScript = createUpdateScript(config, analysis); const updateScriptPath = join(scriptsDir, 'update-context.sh'); writeFileSync(updateScriptPath, updateScript); chmodSync(updateScriptPath, '755'); result.filesCreated.push(updateScriptPath); // Create validation script const validationScript = createValidationScript(config); const validationScriptPath = join(scriptsDir, 'validate-context.sh'); writeFileSync(validationScriptPath, validationScript); chmodSync(validationScriptPath, '755'); result.filesCreated.push(validationScriptPath); // Create monitoring configuration if (config.monitoring) { const monitoringConfig = createMonitoringConfig(config, analysis); const monitoringPath = join(config.projectPath, '.context-monitoring.yaml'); writeFileSync(monitoringPath, yaml.dump(monitoringConfig)); result.filesCreated.push(monitoringPath); } // Set up git hooks if requested if (config.gitHooks) { await setupGitHooks(config, result); } // Create scheduled update configuration if (config.updateSchedule !== 'manual') { const scheduleConfig = createScheduleConfig(config); const schedulePath = join(config.projectPath, '.context-schedule.yaml'); writeFileSync(schedulePath, yaml.dump(scheduleConfig)); result.filesCreated.push(schedulePath); // Create cron job script const cronScript = createCronScript(config); const cronPath = join(scriptsDir, 'setup-cron.sh'); writeFileSync(cronPath, cronScript); chmodSync(cronPath, '755'); result.filesCreated.push(cronPath); } // Create GitHub Actions workflow if in a git repo const gitDir = join(config.projectPath, '.git'); if (existsSync(gitDir)) { const workflowsDir = join(config.projectPath, '.github', 'workflows'); if (!existsSync(workflowsDir)) { mkdirSync(workflowsDir, { recursive: true }); } const workflow = createGitHubActionsWorkflow(config); const workflowPath = join(workflowsDir, 'update-context.yml'); writeFileSync(workflowPath, workflow); result.filesCreated.push(workflowPath); } // Generate setup instructions result.setupInstructions = generateSetupInstructions(config, result.filesCreated); result.success = true; result.message = `Persistence automation setup complete. Schedule: ${config.updateSchedule}`; } catch (error) { result.success = false; result.message = `Failed to setup persistence automation: ${error}`; } return result; }
• src/tools/tool-definitions.ts:344-382 (schema)

  JSON schema defining the input parameters and validation for the tool, including required projectPath and updateSchedule.
  { name: 'setup_persistence_automation', description: 'Set up automated context updates with monitoring and validation', inputSchema: { type: 'object', properties: { projectPath: { type: 'string', description: 'Path to the project directory', }, analysisId: { type: 'string', description: 'Analysis ID from analyze_codebase_deeply', }, updateSchedule: { type: 'string', enum: ['daily', 'weekly', 'on-change', 'manual'], description: 'How often to update context', }, gitHooks: { type: 'boolean', description: 'Install git hooks for validation', }, monitoring: { type: 'boolean', description: 'Enable context monitoring', }, notifications: { type: 'object', properties: { email: { type: 'string' }, slack: { type: 'string' }, }, description: 'Notification settings', }, }, required: ['projectPath', 'updateSchedule'], }, },
• src/tools/index.ts:294-316 (registration)

  Registration in the main tool dispatcher switch statement: parses input arguments using Zod and calls the handler function.
  case 'setup_persistence_automation': { const params = z.object({ projectPath: z.string(), analysisId: z.string().optional(), updateSchedule: z.enum(['daily', 'weekly', 'on-change', 'manual']), gitHooks: z.boolean().optional(), monitoring: z.boolean().optional(), notifications: z.object({ email: z.string().optional(), slack: z.string().optional(), }).optional(), }).parse(args); const result = await setupPersistenceAutomation(params); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; }
• src/tools/index.ts:27-30 (registration)

  Tool listing handler that returns the toolDefinitions array, which includes this tool's metadata and schema.
  server.setRequestHandler(ListToolsRequestSchema, async () => { console.error(`Handling tools/list request, returning ${toolDefinitions.length} tools`); return { tools: toolDefinitions }; });
• src/tools/workspace/setup-persistence-automation.ts:119-283 (helper)

  Helper function that generates the bash update-context.sh script used for automated context updates.
  function createUpdateScript(config: PersistenceConfig, analysis: DeepAnalysisResult): string { return `#!/bin/bash # Context Update Script # Generated: ${new Date().toISOString()} set -e SCRIPT_DIR="$( cd "$( dirname "\${BASH_SOURCE[0]}" )" && pwd )" PROJECT_ROOT="$(dirname "$SCRIPT_DIR")" echo "🔄 Starting context update..." # Function to check if context needs update needs_update() { local context_file="$1" local threshold_days="\${2:-7}" if [ ! -f "$context_file" ]; then return 0 # Needs update if doesn't exist fi # Check file age if [[ "$OSTYPE" == "darwin"* ]]; then # macOS file_age=$(( ($(date +%s) - $(stat -f %m "$context_file")) / 86400 )) else # Linux file_age=$(( ($(date +%s) - $(stat -c %Y "$context_file")) / 86400 )) fi if [ $file_age -gt $threshold_days ]; then return 0 # Needs update if older than threshold fi return 1 # No update needed } # Check if MCP server is available check_mcp_server() { if ! command -v npx &> /dev/null; then echo "❌ npx not found. Please install Node.js" exit 1 fi echo "✅ MCP server available" } # Run analysis run_analysis() { echo "🔍 Running codebase analysis..." # This would normally call the MCP tool # For now, we'll create a marker file touch "$PROJECT_ROOT/.last-analysis" echo "✅ Analysis complete" } # Update context files update_contexts() { local force_update="\${1:-false}" # List of context files to check declare -a context_files=( "agent-context/CODEBASE-CONTEXT.md" "agent-context/PROJECT-TEMPLATE.md" "agent-context/conversation-starters.md" "agent-context/minimal-context.md" ) local updates_needed=false for file in "\${context_files[@]}"; do if [ "$force_update" = "true" ] || needs_update "$PROJECT_ROOT/$file"; then echo "📝 Updating $file..." updates_needed=true fi done if [ "$updates_needed" = "true" ]; then run_analysis echo "✅ All context files updated" else echo "✅ All context files are up to date" fi } # Validate context files validate_contexts() { echo "🔍 Validating context files..." "$SCRIPT_DIR/validate-context.sh" if [ $? -eq 0 ]; then echo "✅ All context files are valid" else echo "❌ Context validation failed" exit 1 fi } # Send notification send_notification() { local message="$1" ${config.notifications?.email ? ` # Email notification if command -v mail &> /dev/null; then echo "$message" | mail -s "Context Update: $PROJECT_ROOT" "${config.notifications.email}" fi` : ''} ${config.notifications?.slack ? ` # Slack notification if [ -n "$SLACK_WEBHOOK" ]; then curl -X POST -H 'Content-type: application/json' \\ --data "{\\"text\\":\\"$message\\"}" \\ "$SLACK_WEBHOOK" fi` : ''} echo "$message" } # Main execution main() { local force_update=false # Parse arguments while [[ $# -gt 0 ]]; do case $1 in --force|-f) force_update=true shift ;; --help|-h) echo "Usage: $0 [--force]" echo " --force, -f Force update all context files" exit 0 ;; *) echo "Unknown option: $1" exit 1 ;; esac done cd "$PROJECT_ROOT" # Check prerequisites check_mcp_server # Update contexts update_contexts "$force_update" # Validate validate_contexts # Record update echo "$(date -u +"%Y-%m-%dT%H:%M:%SZ")" > "$PROJECT_ROOT/.last-context-update" # Send notification send_notification "✅ Context update completed successfully for ${analysis.projectPath.split('/').pop()}" } # Run main function main "$@"`;