💫 Toolkit to help you get started with SDD or any other process!
Simplification
Den Delimarsky 🌺406521c66402
diff --git a/scripts/bash/update-agent-context.sh b/scripts/bash/update-agent-context.shindex d68250d9e..bba241576 100644--- a/scripts/bash/update-agent-context.sh+++ b/scripts/bash/update-agent-context.sh@@ -151,6 +151,7 @@ extract_plan_field() {grep "^\*\*${field_pattern}\*\*: " "$plan_file" 2>/dev/null | \head -1 | \sed "s|^\*\*${field_pattern}\*\*: ||" | \+ sed 's/^[ \t]*//;s/[ \t]*$//' | \grep -v "NEEDS CLARIFICATION" | \grep -v "^N/A$" || echo ""}@@ -194,6 +195,31 @@ parse_plan_data() {log_info "Found project type: $NEW_PROJECT_TYPE"fi}++format_technology_stack() {+ local lang="$1"+ local framework="$2"+ local parts=()++ # Add non-empty parts+ [[ -n "$lang" && "$lang" != "NEEDS CLARIFICATION" ]] && parts+=("$lang")+ [[ -n "$framework" && "$framework" != "NEEDS CLARIFICATION" && "$framework" != "N/A" ]] && parts+=("$framework")++ # Join with proper formatting+ if [[ ${#parts[@]} -eq 0 ]]; then+ echo ""+ elif [[ ${#parts[@]} -eq 1 ]]; then+ echo "${parts[0]}"+ else+ # Join multiple parts with " + "+ local result="${parts[0]}"+ for ((i=1; i<${#parts[@]}; i++)); do+ result="$result + ${parts[i]}"+ done+ echo "$result"+ fi+}+#==============================================================================# Template and Content Generation Functions#==============================================================================@@ -293,145 +319,9 @@ create_new_agent_file() {return 0}-update_active_technologies() {- local target_file="$1"- local temp_file="$2"-- # Find the Active Technologies section and add new entries- local tech_section_start- tech_section_start=$(grep -n "## Active Technologies" "$target_file" | cut -d: -f1)-- if [[ -z "$tech_section_start" ]]; then- return 0 # No Active Technologies section found- fi-- # Find the end of the Active Technologies section (next ## heading or empty line)- local tech_section_end- tech_section_end=$(tail -n +$((tech_section_start + 1)) "$target_file" | grep -n "^## \|^$" | head -1 | cut -d: -f1)-- if [[ -n "$tech_section_end" ]]; then- tech_section_end=$((tech_section_start + tech_section_end))- else- tech_section_end=$(wc -l < "$target_file")- fi-- # Extract existing technologies section- local existing_tech- existing_tech=$(sed -n "${tech_section_start},${tech_section_end}p" "$target_file")-- # Build list of new additions- local additions=()- if [[ -n "$NEW_LANG" ]] && ! echo "$existing_tech" | grep -q "$NEW_LANG"; then- additions+=("- $NEW_LANG + $NEW_FRAMEWORK ($CURRENT_BRANCH)")- fi-- if [[ -n "$NEW_DB" ]] && [[ "$NEW_DB" != "N/A" ]] && ! echo "$existing_tech" | grep -q "$NEW_DB"; then- additions+=("- $NEW_DB ($CURRENT_BRANCH)")- fi-- # If we have additions, update the section- if [[ ${#additions[@]} -gt 0 ]]; then- {- # Copy everything before the Active Technologies section- head -n $((tech_section_start)) "$target_file"-- # Copy existing tech section content- sed -n "$((tech_section_start + 1)),$((tech_section_end - 1))p" "$target_file"-- # Add new technologies- printf '%s\n' "${additions[@]}"- echo-- # Copy everything after the Active Technologies section- tail -n +$((tech_section_end + 1)) "$target_file"- } > "$temp_file"- else- cp "$target_file" "$temp_file"- fi-}-update_recent_changes() {- local temp_file="$1"- local temp_file2="$2"-- # Find Recent Changes section- local changes_section_start- changes_section_start=$(grep -n "## Recent Changes" "$temp_file" | cut -d: -f1)-- if [[ -z "$changes_section_start" ]]; then- return 0 # No Recent Changes section found- fi-- # Find the end of the Recent Changes section- local changes_section_end- changes_section_end=$(tail -n +$((changes_section_start + 1)) "$temp_file" | grep -n "^## \|^$" | head -1 | cut -d: -f1)-- if [[ -n "$changes_section_end" ]]; then- changes_section_end=$((changes_section_start + changes_section_end))- else- changes_section_end=$(wc -l < "$temp_file")- fi-- # Extract existing changes, keep only non-empty lines, and limit to 2 (so we can add 1 new one)- local existing_changes=()- while IFS= read -r line; do- if [[ -n "$line" ]] && [[ "$line" == "- "* ]]; then- existing_changes+=("$line")- fi- done < <(sed -n "$((changes_section_start + 1)),$((changes_section_end - 1))p" "$temp_file")-- # Keep only the first 2 existing changes- existing_changes=("${existing_changes[@]:0:2}")-- # Create updated Recent Changes section- {- # Copy everything before Recent Changes- head -n "$changes_section_start" "$temp_file"-- # Add new change at the top- echo "- $CURRENT_BRANCH: Added $NEW_LANG + $NEW_FRAMEWORK"-- # Add existing changes (up to 2)- printf '%s\n' "${existing_changes[@]}"- echo-- # Copy everything after Recent Changes section- tail -n +$((changes_section_end + 1)) "$temp_file"- } > "$temp_file2"-}-update_last_updated() {- local temp_file="$1"- local current_date="$2"-- # Update the "Last updated" timestamp- sed -i.bak "s/Last updated: [0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]/Last updated: $current_date/" "$temp_file"- rm -f "$temp_file.bak"-}-preserve_manual_additions() {- local target_file="$1"- local temp_file="$2"-- # Check if there are manual additions to preserve- local manual_start manual_end- manual_start=$(grep -n "<!-- MANUAL ADDITIONS START -->" "$target_file" 2>/dev/null | cut -d: -f1 || echo "")- manual_end=$(grep -n "<!-- MANUAL ADDITIONS END -->" "$target_file" 2>/dev/null | cut -d: -f1 || echo "")-- if [[ -n "$manual_start" ]] && [[ -n "$manual_end" ]]; then- # Extract manual additions- local manual_file="/tmp/manual_additions_$$"- sed -n "${manual_start},${manual_end}p" "$target_file" > "$manual_file"-- # Remove any existing manual additions from temp file- sed -i.bak '/<!-- MANUAL ADDITIONS START -->/,/<!-- MANUAL ADDITIONS END -->/d' "$temp_file"- rm -f "$temp_file.bak"-- # Append preserved manual additions- cat "$manual_file" >> "$temp_file"- rm -f "$manual_file"- fi-}update_existing_agent_file() {local target_file="$1"@@ -439,26 +329,105 @@ update_existing_agent_file() {log_info "Updating existing agent context file..."- local temp_file1="/tmp/agent_update_1_$$"- local temp_file2="/tmp/agent_update_2_$$"-- # Step 1: Update Active Technologies section- update_active_technologies "$target_file" "$temp_file1"-- # Step 2: Update Recent Changes section- update_recent_changes "$temp_file1" "$temp_file2"-- # Step 3: Update timestamp- update_last_updated "$temp_file2" "$current_date"-- # Step 4: Preserve manual additions- preserve_manual_additions "$target_file" "$temp_file2"+ # Use a single temporary file for atomic update+ local temp_file+ temp_file=$(mktemp) || {+ log_error "Failed to create temporary file"+ return 1+ }++ # Process the file in one pass+ local tech_stack=$(format_technology_stack "$NEW_LANG" "$NEW_FRAMEWORK")+ local new_tech_entries=()+ local new_change_entry=""++ # Prepare new technology entries+ if [[ -n "$tech_stack" ]] && ! grep -q "$tech_stack" "$target_file"; then+ new_tech_entries+=("- $tech_stack ($CURRENT_BRANCH)")+ fi++ if [[ -n "$NEW_DB" ]] && [[ "$NEW_DB" != "N/A" ]] && [[ "$NEW_DB" != "NEEDS CLARIFICATION" ]] && ! grep -q "$NEW_DB" "$target_file"; then+ new_tech_entries+=("- $NEW_DB ($CURRENT_BRANCH)")+ fi++ # Prepare new change entry+ if [[ -n "$tech_stack" ]]; then+ new_change_entry="- $CURRENT_BRANCH: Added $tech_stack"+ elif [[ -n "$NEW_DB" ]] && [[ "$NEW_DB" != "N/A" ]] && [[ "$NEW_DB" != "NEEDS CLARIFICATION" ]]; then+ new_change_entry="- $CURRENT_BRANCH: Added $NEW_DB"+ fi++ # Process file line by line+ local in_tech_section=false+ local in_changes_section=false+ local tech_entries_added=false+ local changes_entries_added=false+ local existing_changes_count=0++ while IFS= read -r line || [[ -n "$line" ]]; do+ # Handle Active Technologies section+ if [[ "$line" == "## Active Technologies" ]]; then+ echo "$line" >> "$temp_file"+ in_tech_section=true+ continue+ elif [[ $in_tech_section == true ]] && [[ "$line" =~ ^##[[:space:]] ]]; then+ # Add new tech entries before closing the section+ if [[ $tech_entries_added == false ]] && [[ ${#new_tech_entries[@]} -gt 0 ]]; then+ printf '%s\n' "${new_tech_entries[@]}" >> "$temp_file"+ tech_entries_added=true+ fi+ echo "$line" >> "$temp_file"+ in_tech_section=false+ continue+ elif [[ $in_tech_section == true ]] && [[ -z "$line" ]]; then+ # Add new tech entries before empty line in tech section+ if [[ $tech_entries_added == false ]] && [[ ${#new_tech_entries[@]} -gt 0 ]]; then+ printf '%s\n' "${new_tech_entries[@]}" >> "$temp_file"+ tech_entries_added=true+ fi+ echo "$line" >> "$temp_file"+ continue+ fi++ # Handle Recent Changes section+ if [[ "$line" == "## Recent Changes" ]]; then+ echo "$line" >> "$temp_file"+ # Add new change entry right after the heading+ if [[ -n "$new_change_entry" ]]; then+ echo "$new_change_entry" >> "$temp_file"+ fi+ in_changes_section=true+ changes_entries_added=true+ continue+ elif [[ $in_changes_section == true ]] && [[ "$line" =~ ^##[[:space:]] ]]; then+ echo "$line" >> "$temp_file"+ in_changes_section=false+ continue+ elif [[ $in_changes_section == true ]] && [[ "$line" == "- "* ]]; then+ # Keep only first 2 existing changes+ if [[ $existing_changes_count -lt 2 ]]; then+ echo "$line" >> "$temp_file"+ ((existing_changes_count++))+ fi+ continue+ fi++ # Update timestamp+ if [[ "$line" =~ \*\*Last\ updated\*\*:.*[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9] ]]; then+ echo "$line" | sed "s/[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]/$current_date/" >> "$temp_file"+ else+ echo "$line" >> "$temp_file"+ fi+ done < "$target_file"- # Move the final result to target- mv "$temp_file2" "$target_file"+ # Move temp file to target atomically+ if ! mv "$temp_file" "$target_file"; then+ log_error "Failed to update target file"+ rm -f "$temp_file"+ return 1+ fi- # Cleanup- rm -f "$temp_file1"+ return 0}#==============================================================================# Main Agent File Update Functiondiff --git a/scripts/powershell/update-agent-context.ps1 b/scripts/powershell/update-agent-context.ps1index 923a43781..9ea3220bb 100644--- a/scripts/powershell/update-agent-context.ps1+++ b/scripts/powershell/update-agent-context.ps1@@ -41,6 +41,23 @@ $newTesting = Get-PlanValue 'Testing'$newDb = Get-PlanValue 'Storage'$newProjectType = Get-PlanValue 'Project Type'+function Format-TechnologyStack($lang, $framework) {+ $parts = @()++ # Add non-empty parts (excluding "NEEDS CLARIFICATION" and "N/A")+ if ($lang -and $lang -ne 'NEEDS CLARIFICATION') { $parts += $lang }+ if ($framework -and $framework -ne 'NEEDS CLARIFICATION' -and $framework -ne 'N/A') { $parts += $framework }++ # Join with proper formatting+ if ($parts.Count -eq 0) {+ return ''+ } elseif ($parts.Count -eq 1) {+ return $parts[0]+ } else {+ return ($parts -join ' + ')+ }+}+function Initialize-AgentFile($targetFile, $agentName) {if (Test-Path $targetFile) { return }$template = Join-Path $paths.REPO_ROOT '.specify/templates/agent-file-template.md'@@ -48,7 +65,13 @@ function Initialize-AgentFile($targetFile, $agentName) {$content = Get-Content $template -Raw$content = $content.Replace('[PROJECT NAME]', (Split-Path $paths.REPO_ROOT -Leaf))$content = $content.Replace('[DATE]', (Get-Date -Format 'yyyy-MM-dd'))- $content = $content.Replace('[EXTRACTED FROM ALL PLAN.MD FILES]', "- $newLang + $newFramework ($($paths.CURRENT_BRANCH))")++ $techStack = Format-TechnologyStack $newLang $newFramework+ if ($techStack) {+ $content = $content.Replace('[EXTRACTED FROM ALL PLAN.MD FILES]', "- $techStack ($($paths.CURRENT_BRANCH))")+ } else {+ $content = $content.Replace('[EXTRACTED FROM ALL PLAN.MD FILES]', '')+ }if ($newProjectType -match 'web') { $structure = "backend/`nfrontend/`ntests/" } else { $structure = "src/`ntests/" }$content = $content.Replace('[ACTUAL STRUCTURE FROM PLANS]', $structure)if ($newLang -match 'Python') { $commands = 'cd src && pytest && ruff check .' }@@ -57,18 +80,38 @@ function Initialize-AgentFile($targetFile, $agentName) {else { $commands = "# Add commands for $newLang" }$content = $content.Replace('[ONLY COMMANDS FOR ACTIVE TECHNOLOGIES]', $commands)$content = $content.Replace('[LANGUAGE-SPECIFIC, ONLY FOR LANGUAGES IN USE]', "${newLang}: Follow standard conventions")- $content = $content.Replace('[LAST 3 FEATURES AND WHAT THEY ADDED]', "- $($paths.CURRENT_BRANCH): Added ${newLang} + ${newFramework}")++ $techStack = Format-TechnologyStack $newLang $newFramework+ if ($techStack) {+ $content = $content.Replace('[LAST 3 FEATURES AND WHAT THEY ADDED]', "- $($paths.CURRENT_BRANCH): Added $techStack")+ } else {+ $content = $content.Replace('[LAST 3 FEATURES AND WHAT THEY ADDED]', '')+ }$content | Set-Content $targetFile -Encoding UTF8}function Update-AgentFile($targetFile, $agentName) {if (-not (Test-Path $targetFile)) { Initialize-AgentFile $targetFile $agentName; return }$content = Get-Content $targetFile -Raw- if ($newLang -and ($content -notmatch [regex]::Escape($newLang))) { $content = $content -replace '(## Active Technologies\n)', "`$1- $newLang + $newFramework ($($paths.CURRENT_BRANCH))`n" }- if ($newDb -and $newDb -ne 'N/A' -and ($content -notmatch [regex]::Escape($newDb))) { $content = $content -replace '(## Active Technologies\n)', "`$1- $newDb ($($paths.CURRENT_BRANCH))`n" }++ $techStack = Format-TechnologyStack $newLang $newFramework+ if ($techStack -and ($content -notmatch [regex]::Escape($techStack))) {+ $content = $content -replace '(## Active Technologies\n)', "`$1- $techStack ($($paths.CURRENT_BRANCH))`n"+ }++ if ($newDb -and $newDb -ne 'N/A' -and $newDb -ne 'NEEDS CLARIFICATION' -and ($content -notmatch [regex]::Escape($newDb))) {+ $content = $content -replace '(## Active Technologies\n)', "`$1- $newDb ($($paths.CURRENT_BRANCH))`n"+ }+if ($content -match '## Recent Changes\n([\s\S]*?)(\n\n|$)') {$changesBlock = $matches[1].Trim().Split("`n")- $changesBlock = ,"- $($paths.CURRENT_BRANCH): Added ${newLang} + ${newFramework}" + $changesBlock++ if ($techStack) {+ $changesBlock = ,"- $($paths.CURRENT_BRANCH): Added $techStack" + $changesBlock+ } elseif ($newDb -and $newDb -ne 'N/A' -and $newDb -ne 'NEEDS CLARIFICATION') {+ $changesBlock = ,"- $($paths.CURRENT_BRANCH): Added $newDb" + $changesBlock+ }+$changesBlock = $changesBlock | Where-Object { $_ } | Select-Object -First 3$joined = ($changesBlock -join "`n")$content = [regex]::Replace($content, '## Recent Changes\n([\s\S]*?)(\n\n|$)', "## Recent Changes`n$joined`n`n")