Skip to content

AP Mapping v2.4.1 - Critical Installer Fix

Choose a tag to compare

@omayhemo omayhemo released this 22 Jul 21:07
· 34 commits to master since this release

AP Mapping v2.4.1 - Critical Installer Fix

Released: 2025-01-22

馃敡 Critical Fix for CLAUDE.md Merge System

This patch release fixes critical installer functionality for proper CLAUDE.md file handling across all 4 distinct CLAUDE.md files in the APM ecosystem.

What's Fixed

CLAUDE.md Merge System

  • Fixed merge_apm_section() function - APM content now properly merges into user's root CLAUDE.md
  • Fixed content preservation - User content after APM sections no longer lost during updates
  • Enhanced installer Step 10 - Always replaces .apm/CLAUDE.md while safely merging root CLAUDE.md
  • Added template.claude.md - Proper APM section template with merge tag boundaries
  • Complete 4-file support - All CLAUDE.md file types now handled correctly

Technical Improvements

  • Template System: Enhanced template.claude.md with proper <BEGIN-APM-CLAUDE-MERGE> boundaries
  • Content Safety: Fixed sed command that was losing content after APM merge tags
  • Installation Reliability: User's root CLAUDE.md customizations fully preserved during APM updates

Distribution Package

  • 216 templates ready for deployment
  • 288 total files in distribution
  • Complete parallel-sprint system from v2.4.0 included
  • Template-only distribution for clean installations

Installation

New Installation

Linux/WSL:

wget https://github.com/omayhemo/APM/releases/download/v2.4.1/apm-v2.4.1.tar.gz && tar -xzf apm-v2.4.1.tar.gz && cd apm-v2.4.1 && ./templates/install.sh

macOS:

curl -L https://github.com/omayhemo/APM/releases/download/v2.4.1/apm-v2.4.1.tar.gz  < /dev/null |  tar -xz && cd apm-v2.4.1 && ./templates/install.sh

Updating from Previous Version

.apm/agents/scripts/ap-manager.sh update

Critical for APM Users

This fix is essential for proper APM installation and updates. The v2.4.0 installer had a bug where user content after APM sections in root CLAUDE.md files could be lost. This has been completely resolved.

What's Included

  • Complete /parallel-sprint system for Scrum Masters
  • Revolutionary parallel development coordination
  • Enhanced installer with proper CLAUDE.md handling
  • All 216 templates for comprehensive APM functionality
  • 4-file CLAUDE.md system with intelligent merging

Upgrade Benefits

  • Safe Updates: Your root CLAUDE.md customizations are now fully preserved
  • Reliable Installation: No more lost content during APM installations
  • Complete Functionality: All parallel-sprint capabilities from v2.4.0
  • Template System: 216 templates ready for immediate deployment

This release ensures the complete APM experience with reliable installation and update processes.