π« Toolkit to help you get started with SDD or any other process!
fix: replace shell-based context updates with marker-based upsert (#2259)
Manfred Riemfc3d1244c07c
diff --git a/pyproject.toml b/pyproject.tomlindex fc4b30635..dae79b0f6 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -28,7 +28,6 @@ packages = ["src/specify_cli"][tool.hatch.build.targets.wheel.force-include]# Bundle core assets so `specify init` works without network access (air-gapped / enterprise)# Page templates (exclude commands/ β bundled separately below to avoid duplication)-"templates/agent-file-template.md" = "specify_cli/core_pack/templates/agent-file-template.md""templates/checklist-template.md" = "specify_cli/core_pack/templates/checklist-template.md""templates/constitution-template.md" = "specify_cli/core_pack/templates/constitution-template.md""templates/plan-template.md" = "specify_cli/core_pack/templates/plan-template.md"diff --git a/scripts/bash/update-agent-context.sh b/scripts/bash/update-agent-context.shdeleted file mode 100644index 2f71bb893..000000000--- a/scripts/bash/update-agent-context.sh+++ /dev/null@@ -1,857 +0,0 @@-#!/usr/bin/env bash--# Update agent context files with information from plan.md-#-# This script maintains AI agent context files by parsing feature specifications-# and updating agent-specific configuration files with project information.-#-# MAIN FUNCTIONS:-# 1. Environment Validation-# - Verifies git repository structure and branch information-# - Checks for required plan.md files and templates-# - Validates file permissions and accessibility-#-# 2. Plan Data Extraction-# - Parses plan.md files to extract project metadata-# - Identifies language/version, frameworks, databases, and project types-# - Handles missing or incomplete specification data gracefully-#-# 3. Agent File Management-# - Creates new agent context files from templates when needed-# - Updates existing agent files with new project information-# - Preserves manual additions and custom configurations-# - Supports multiple AI agent formats and directory structures-#-# 4. Content Generation-# - Generates language-specific build/test commands-# - Creates appropriate project directory structures-# - Updates technology stacks and recent changes sections-# - Maintains consistent formatting and timestamps-#-# 5. Multi-Agent Support-# - Handles agent-specific file paths and naming conventions-# - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Junie, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, Tabnine CLI, Kiro CLI, Mistral Vibe, Kimi Code, Pi Coding Agent, iFlow CLI, Forge, Goose, Antigravity or Generic-# - Can update single agents or all existing agent files-# - Creates default Claude file if no agent files exist-#-# Usage: ./update-agent-context.sh [agent_type]-# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|junie|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|forge|goose|generic-# Leave empty to update all existing agent files--set -e--# Enable strict error handling-set -u-set -o pipefail--#==============================================================================-# Configuration and Global Variables-#==============================================================================--# Get script directory and load common functions-SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"-source "$SCRIPT_DIR/common.sh"--# Get all paths and variables from common functions-_paths_output=$(get_feature_paths) || { echo "ERROR: Failed to resolve feature paths" >&2; exit 1; }-eval "$_paths_output"-unset _paths_output--NEW_PLAN="$IMPL_PLAN" # Alias for compatibility with existing code-AGENT_TYPE="${1:-}"--# Agent-specific file paths-CLAUDE_FILE="$REPO_ROOT/CLAUDE.md"-GEMINI_FILE="$REPO_ROOT/GEMINI.md"-COPILOT_FILE="$REPO_ROOT/.github/copilot-instructions.md"-CURSOR_FILE="$REPO_ROOT/.cursor/rules/specify-rules.mdc"-QWEN_FILE="$REPO_ROOT/QWEN.md"-AGENTS_FILE="$REPO_ROOT/AGENTS.md"-WINDSURF_FILE="$REPO_ROOT/.windsurf/rules/specify-rules.md"-JUNIE_FILE="$REPO_ROOT/.junie/AGENTS.md"-KILOCODE_FILE="$REPO_ROOT/.kilocode/rules/specify-rules.md"-AUGGIE_FILE="$REPO_ROOT/.augment/rules/specify-rules.md"-ROO_FILE="$REPO_ROOT/.roo/rules/specify-rules.md"-CODEBUDDY_FILE="$REPO_ROOT/CODEBUDDY.md"-QODER_FILE="$REPO_ROOT/QODER.md"-# Amp, Kiro CLI, IBM Bob, Pi, Forge, and Goose all share AGENTS.md β use AGENTS_FILE to avoid-# updating the same file multiple times.-AMP_FILE="$AGENTS_FILE"-SHAI_FILE="$REPO_ROOT/SHAI.md"-TABNINE_FILE="$REPO_ROOT/TABNINE.md"-KIRO_FILE="$AGENTS_FILE"-AGY_FILE="$REPO_ROOT/.agent/rules/specify-rules.md"-BOB_FILE="$AGENTS_FILE"-VIBE_FILE="$REPO_ROOT/.vibe/agents/specify-agents.md"-KIMI_FILE="$REPO_ROOT/KIMI.md"-TRAE_FILE="$REPO_ROOT/.trae/rules/project_rules.md"-IFLOW_FILE="$REPO_ROOT/IFLOW.md"-FORGE_FILE="$AGENTS_FILE"--# Template file-TEMPLATE_FILE="$REPO_ROOT/.specify/templates/agent-file-template.md"--# Global variables for parsed plan data-NEW_LANG=""-NEW_FRAMEWORK=""-NEW_DB=""-NEW_PROJECT_TYPE=""--#==============================================================================-# Utility Functions-#==============================================================================--log_info() {- echo "INFO: $1"-}--log_success() {- echo "β $1"-}--log_error() {- echo "ERROR: $1" >&2-}--log_warning() {- echo "WARNING: $1" >&2-}--# Track temporary files for cleanup on interrupt-_CLEANUP_FILES=()--# Cleanup function for temporary files-cleanup() {- local exit_code=$?- # Disarm traps to prevent re-entrant loop- trap - EXIT INT TERM- if [ ${#_CLEANUP_FILES[@]} -gt 0 ]; then- for f in "${_CLEANUP_FILES[@]}"; do- rm -f "$f" "$f.bak" "$f.tmp"- done- fi- exit $exit_code-}--# Set up cleanup trap-trap cleanup EXIT INT TERM--#==============================================================================-# Validation Functions-#==============================================================================--validate_environment() {- # Check if we have a current branch/feature (git or non-git)- if [[ -z "$CURRENT_BRANCH" ]]; then- log_error "Unable to determine current feature"- if [[ "$HAS_GIT" == "true" ]]; then- log_info "Make sure you're on a feature branch"- else- log_info "Set SPECIFY_FEATURE environment variable or create a feature first"- fi- exit 1- fi-- # Check if plan.md exists- if [[ ! -f "$NEW_PLAN" ]]; then- log_error "No plan.md found at $NEW_PLAN"- log_info "Make sure you're working on a feature with a corresponding spec directory"- if [[ "$HAS_GIT" != "true" ]]; then- log_info "Use: export SPECIFY_FEATURE=your-feature-name or create a new feature first"- fi- exit 1- fi-- # Check if template exists (needed for new files)- if [[ ! -f "$TEMPLATE_FILE" ]]; then- log_warning "Template file not found at $TEMPLATE_FILE"- log_warning "Creating new agent files will fail"- fi-}--#==============================================================================-# Plan Parsing Functions-#==============================================================================--extract_plan_field() {- local field_pattern="$1"- local plan_file="$2"-- 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 ""-}--parse_plan_data() {- local plan_file="$1"-- if [[ ! -f "$plan_file" ]]; then- log_error "Plan file not found: $plan_file"- return 1- fi-- if [[ ! -r "$plan_file" ]]; then- log_error "Plan file is not readable: $plan_file"- return 1- fi-- log_info "Parsing plan data from $plan_file"-- NEW_LANG=$(extract_plan_field "Language/Version" "$plan_file")- NEW_FRAMEWORK=$(extract_plan_field "Primary Dependencies" "$plan_file")- NEW_DB=$(extract_plan_field "Storage" "$plan_file")- NEW_PROJECT_TYPE=$(extract_plan_field "Project Type" "$plan_file")-- # Log what we found- if [[ -n "$NEW_LANG" ]]; then- log_info "Found language: $NEW_LANG"- else- log_warning "No language information found in plan"- fi-- if [[ -n "$NEW_FRAMEWORK" ]]; then- log_info "Found framework: $NEW_FRAMEWORK"- fi-- if [[ -n "$NEW_DB" ]] && [[ "$NEW_DB" != "N/A" ]]; then- log_info "Found database: $NEW_DB"- fi-- if [[ -n "$NEW_PROJECT_TYPE" ]]; then- 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-#==============================================================================--get_project_structure() {- local project_type="$1"-- if [[ "$project_type" == *"web"* ]]; then- echo "backend/\\nfrontend/\\ntests/"- else- echo "src/\\ntests/"- fi-}--get_commands_for_language() {- local lang="$1"-- case "$lang" in- *"Python"*)- echo "cd src && pytest && ruff check ."- ;;- *"Rust"*)- echo "cargo test && cargo clippy"- ;;- *"JavaScript"*|*"TypeScript"*)- echo "npm test && npm run lint"- ;;- *)- echo "# Add commands for $lang"- ;;- esac-}--get_language_conventions() {- local lang="$1"- echo "$lang: Follow standard conventions"-}--# Escape sed replacement-side specials for | delimiter.-# & and \ are replacement-side specials; | is our sed delimiter.-_esc_sed() { printf '%s\n' "$1" | sed 's/[\\&|]/\\&/g'; }--create_new_agent_file() {- local target_file="$1"- local temp_file="$2"- local project_name- project_name=$(_esc_sed "$3")- local current_date="$4"-- if [[ ! -f "$TEMPLATE_FILE" ]]; then- log_error "Template not found at $TEMPLATE_FILE"- return 1- fi-- if [[ ! -r "$TEMPLATE_FILE" ]]; then- log_error "Template file is not readable: $TEMPLATE_FILE"- return 1- fi-- log_info "Creating new agent context file from template..."-- if ! cp "$TEMPLATE_FILE" "$temp_file"; then- log_error "Failed to copy template file"- return 1- fi-- # Replace template placeholders- local project_structure- project_structure=$(get_project_structure "$NEW_PROJECT_TYPE")- project_structure=$(_esc_sed "$project_structure")-- local commands- commands=$(get_commands_for_language "$NEW_LANG")-- local language_conventions- language_conventions=$(get_language_conventions "$NEW_LANG")-- local escaped_lang=$(_esc_sed "$NEW_LANG")- local escaped_framework=$(_esc_sed "$NEW_FRAMEWORK")- commands=$(_esc_sed "$commands")- language_conventions=$(_esc_sed "$language_conventions")- local escaped_branch=$(_esc_sed "$CURRENT_BRANCH")-- # Build technology stack and recent change strings conditionally- local tech_stack- if [[ -n "$escaped_lang" && -n "$escaped_framework" ]]; then- tech_stack="- $escaped_lang + $escaped_framework ($escaped_branch)"- elif [[ -n "$escaped_lang" ]]; then- tech_stack="- $escaped_lang ($escaped_branch)"- elif [[ -n "$escaped_framework" ]]; then- tech_stack="- $escaped_framework ($escaped_branch)"- else- tech_stack="- ($escaped_branch)"- fi-- local recent_change- if [[ -n "$escaped_lang" && -n "$escaped_framework" ]]; then- recent_change="- $escaped_branch: Added $escaped_lang + $escaped_framework"- elif [[ -n "$escaped_lang" ]]; then- recent_change="- $escaped_branch: Added $escaped_lang"- elif [[ -n "$escaped_framework" ]]; then- recent_change="- $escaped_branch: Added $escaped_framework"- else- recent_change="- $escaped_branch: Added"- fi-- local substitutions=(- "s|\[PROJECT NAME\]|$project_name|"- "s|\[DATE\]|$current_date|"- "s|\[EXTRACTED FROM ALL PLAN.MD FILES\]|$tech_stack|"- "s|\[ACTUAL STRUCTURE FROM PLANS\]|$project_structure|g"- "s|\[ONLY COMMANDS FOR ACTIVE TECHNOLOGIES\]|$commands|"- "s|\[LANGUAGE-SPECIFIC, ONLY FOR LANGUAGES IN USE\]|$language_conventions|"- "s|\[LAST 3 FEATURES AND WHAT THEY ADDED\]|$recent_change|"- )-- for substitution in "${substitutions[@]}"; do- if ! sed -i.bak -e "$substitution" "$temp_file"; then- log_error "Failed to perform substitution: $substitution"- rm -f "$temp_file" "$temp_file.bak"- return 1- fi- done-- # Convert literal \n sequences to actual newlines (portable β works on BSD + GNU)- awk '{gsub(/\\n/,"\n")}1' "$temp_file" > "$temp_file.tmp"- mv "$temp_file.tmp" "$temp_file"-- # Clean up backup files from sed -i.bak- rm -f "$temp_file.bak"-- # Prepend Cursor frontmatter for .mdc files so rules are auto-included- if [[ "$target_file" == *.mdc ]]; then- local frontmatter_file- frontmatter_file=$(mktemp) || return 1- _CLEANUP_FILES+=("$frontmatter_file")- printf '%s\n' "---" "description: Project Development Guidelines" "globs: [\"**/*\"]" "alwaysApply: true" "---" "" > "$frontmatter_file"- cat "$temp_file" >> "$frontmatter_file"- mv "$frontmatter_file" "$temp_file"- fi-- return 0-}-----update_existing_agent_file() {- local target_file="$1"- local current_date="$2"-- log_info "Updating existing agent context file..."-- # Use a single temporary file for atomic update- local temp_file- temp_file=$(mktemp) || {- log_error "Failed to create temporary file"- return 1- }- _CLEANUP_FILES+=("$temp_file")-- # 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-- # Check if sections exist in the file- local has_active_technologies=0- local has_recent_changes=0-- if grep -q "^## Active Technologies" "$target_file" 2>/dev/null; then- has_active_technologies=1- fi-- if grep -q "^## Recent Changes" "$target_file" 2>/dev/null; then- has_recent_changes=1- 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- local file_ended=false-- 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"-- # Post-loop check: if we're still in the Active Technologies section and haven't added new entries- if [[ $in_tech_section == true ]] && [[ $tech_entries_added == false ]] && [[ ${#new_tech_entries[@]} -gt 0 ]]; then- printf '%s\n' "${new_tech_entries[@]}" >> "$temp_file"- tech_entries_added=true- fi-- # If sections don't exist, add them at the end of the file- if [[ $has_active_technologies -eq 0 ]] && [[ ${#new_tech_entries[@]} -gt 0 ]]; then- echo "" >> "$temp_file"- echo "## Active Technologies" >> "$temp_file"- printf '%s\n' "${new_tech_entries[@]}" >> "$temp_file"- tech_entries_added=true- fi-- if [[ $has_recent_changes -eq 0 ]] && [[ -n "$new_change_entry" ]]; then- echo "" >> "$temp_file"- echo "## Recent Changes" >> "$temp_file"- echo "$new_change_entry" >> "$temp_file"- changes_entries_added=true- fi-- # Ensure Cursor .mdc files have YAML frontmatter for auto-inclusion- if [[ "$target_file" == *.mdc ]]; then- if ! head -1 "$temp_file" | grep -q '^---'; then- local frontmatter_file- frontmatter_file=$(mktemp) || { rm -f "$temp_file"; return 1; }- _CLEANUP_FILES+=("$frontmatter_file")- printf '%s\n' "---" "description: Project Development Guidelines" "globs: [\"**/*\"]" "alwaysApply: true" "---" "" > "$frontmatter_file"- cat "$temp_file" >> "$frontmatter_file"- mv "$frontmatter_file" "$temp_file"- fi- fi-- # 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-- return 0-}-#==============================================================================-# Main Agent File Update Function-#==============================================================================--update_agent_file() {- local target_file="$1"- local agent_name="$2"-- if [[ -z "$target_file" ]] || [[ -z "$agent_name" ]]; then- log_error "update_agent_file requires target_file and agent_name parameters"- return 1- fi-- log_info "Updating $agent_name context file: $target_file"-- local project_name- project_name=$(basename "$REPO_ROOT")- local current_date- current_date=$(date +%Y-%m-%d)-- # Create directory if it doesn't exist- local target_dir- target_dir=$(dirname "$target_file")- if [[ ! -d "$target_dir" ]]; then- if ! mkdir -p "$target_dir"; then- log_error "Failed to create directory: $target_dir"- return 1- fi- fi-- if [[ ! -f "$target_file" ]]; then- # Create new file from template- local temp_file- temp_file=$(mktemp) || {- log_error "Failed to create temporary file"- return 1- }- _CLEANUP_FILES+=("$temp_file")-- if create_new_agent_file "$target_file" "$temp_file" "$project_name" "$current_date"; then- if mv "$temp_file" "$target_file"; then- log_success "Created new $agent_name context file"- else- log_error "Failed to move temporary file to $target_file"- rm -f "$temp_file"- return 1- fi- else- log_error "Failed to create new agent file"- rm -f "$temp_file"- return 1- fi- else- # Update existing file- if [[ ! -r "$target_file" ]]; then- log_error "Cannot read existing file: $target_file"- return 1- fi-- if [[ ! -w "$target_file" ]]; then- log_error "Cannot write to existing file: $target_file"- return 1- fi-- if update_existing_agent_file "$target_file" "$current_date"; then- log_success "Updated existing $agent_name context file"- else- log_error "Failed to update existing agent file"- return 1- fi- fi-- return 0-}--#==============================================================================-# Agent Selection and Processing-#==============================================================================--update_specific_agent() {- local agent_type="$1"-- case "$agent_type" in- claude)- update_agent_file "$CLAUDE_FILE" "Claude Code" || return 1- ;;- gemini)- update_agent_file "$GEMINI_FILE" "Gemini CLI" || return 1- ;;- copilot)- update_agent_file "$COPILOT_FILE" "GitHub Copilot" || return 1- ;;- cursor-agent)- update_agent_file "$CURSOR_FILE" "Cursor IDE" || return 1- ;;- qwen)- update_agent_file "$QWEN_FILE" "Qwen Code" || return 1- ;;- opencode)- update_agent_file "$AGENTS_FILE" "opencode" || return 1- ;;- codex)- update_agent_file "$AGENTS_FILE" "Codex CLI" || return 1- ;;- windsurf)- update_agent_file "$WINDSURF_FILE" "Windsurf" || return 1- ;;- junie)- update_agent_file "$JUNIE_FILE" "Junie" || return 1- ;;- kilocode)- update_agent_file "$KILOCODE_FILE" "Kilo Code" || return 1- ;;- auggie)- update_agent_file "$AUGGIE_FILE" "Auggie CLI" || return 1- ;;- roo)- update_agent_file "$ROO_FILE" "Roo Code" || return 1- ;;- codebuddy)- update_agent_file "$CODEBUDDY_FILE" "CodeBuddy CLI" || return 1- ;;- qodercli)- update_agent_file "$QODER_FILE" "Qoder CLI" || return 1- ;;- amp)- update_agent_file "$AMP_FILE" "Amp" || return 1- ;;- shai)- update_agent_file "$SHAI_FILE" "SHAI" || return 1- ;;- tabnine)- update_agent_file "$TABNINE_FILE" "Tabnine CLI" || return 1- ;;- kiro-cli)- update_agent_file "$KIRO_FILE" "Kiro CLI" || return 1- ;;- agy)- update_agent_file "$AGY_FILE" "Antigravity" || return 1- ;;- bob)- update_agent_file "$BOB_FILE" "IBM Bob" || return 1- ;;- vibe)- update_agent_file "$VIBE_FILE" "Mistral Vibe" || return 1- ;;- kimi)- update_agent_file "$KIMI_FILE" "Kimi Code" || return 1- ;;- trae)- update_agent_file "$TRAE_FILE" "Trae" || return 1- ;;- pi)- update_agent_file "$AGENTS_FILE" "Pi Coding Agent" || return 1- ;;- iflow)- update_agent_file "$IFLOW_FILE" "iFlow CLI" || return 1- ;;- forge)- update_agent_file "$AGENTS_FILE" "Forge" || return 1- ;;- goose)- update_agent_file "$AGENTS_FILE" "Goose" || return 1- ;;- generic)- log_info "Generic agent: no predefined context file. Use the agent-specific update script for your agent."- ;;- *)- log_error "Unknown agent type '$agent_type'"- log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|junie|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|forge|goose|generic"- exit 1- ;;- esac-}--# Helper: skip non-existent files and files already updated (dedup by-# realpath so that variables pointing to the same file β e.g. AMP_FILE,-# KIRO_FILE, BOB_FILE all resolving to AGENTS_FILE β are only written once).-# Uses a linear array instead of associative array for bash 3.2 compatibility.-# Note: defined at top level because bash 3.2 does not support true-# nested/local functions. _updated_paths, _found_agent, and _all_ok are-# initialised exclusively inside update_all_existing_agents so that-# sourcing this script has no side effects on the caller's environment.--_update_if_new() {- local file="$1" name="$2"- [[ -f "$file" ]] || return 0- local real_path- real_path=$(realpath "$file" 2>/dev/null || echo "$file")- local p- if [[ ${#_updated_paths[@]} -gt 0 ]]; then- for p in "${_updated_paths[@]}"; do- [[ "$p" == "$real_path" ]] && return 0- done- fi- # Record the file as seen before attempting the update so that:- # (a) aliases pointing to the same path are not retried on failure- # (b) _found_agent reflects file existence, not update success- _updated_paths+=("$real_path")- _found_agent=true- update_agent_file "$file" "$name"-}--update_all_existing_agents() {- _found_agent=false- _updated_paths=()- local _all_ok=true-- _update_if_new "$CLAUDE_FILE" "Claude Code" || _all_ok=false- _update_if_new "$GEMINI_FILE" "Gemini CLI" || _all_ok=false- _update_if_new "$COPILOT_FILE" "GitHub Copilot" || _all_ok=false- _update_if_new "$CURSOR_FILE" "Cursor IDE" || _all_ok=false- _update_if_new "$QWEN_FILE" "Qwen Code" || _all_ok=false- _update_if_new "$AGENTS_FILE" "Codex/opencode/Amp/Kiro/Bob/Pi/Forge/Goose" || _all_ok=false- _update_if_new "$WINDSURF_FILE" "Windsurf" || _all_ok=false- _update_if_new "$JUNIE_FILE" "Junie" || _all_ok=false- _update_if_new "$KILOCODE_FILE" "Kilo Code" || _all_ok=false- _update_if_new "$AUGGIE_FILE" "Auggie CLI" || _all_ok=false- _update_if_new "$ROO_FILE" "Roo Code" || _all_ok=false- _update_if_new "$CODEBUDDY_FILE" "CodeBuddy CLI" || _all_ok=false- _update_if_new "$SHAI_FILE" "SHAI" || _all_ok=false- _update_if_new "$TABNINE_FILE" "Tabnine CLI" || _all_ok=false- _update_if_new "$QODER_FILE" "Qoder CLI" || _all_ok=false- _update_if_new "$AGY_FILE" "Antigravity" || _all_ok=false- _update_if_new "$VIBE_FILE" "Mistral Vibe" || _all_ok=false- _update_if_new "$KIMI_FILE" "Kimi Code" || _all_ok=false- _update_if_new "$TRAE_FILE" "Trae" || _all_ok=false- _update_if_new "$IFLOW_FILE" "iFlow CLI" || _all_ok=false-- # If no agent files exist, create a default Claude file- if [[ "$_found_agent" == false ]]; then- log_info "No existing agent files found, creating default Claude file..."- update_agent_file "$CLAUDE_FILE" "Claude Code" || return 1- fi-- [[ "$_all_ok" == true ]]-}-print_summary() {- echo- log_info "Summary of changes:"-- if [[ -n "$NEW_LANG" ]]; then- echo " - Added language: $NEW_LANG"- fi-- if [[ -n "$NEW_FRAMEWORK" ]]; then- echo " - Added framework: $NEW_FRAMEWORK"- fi-- if [[ -n "$NEW_DB" ]] && [[ "$NEW_DB" != "N/A" ]]; then- echo " - Added database: $NEW_DB"- fi-- echo- log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|junie|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|forge|goose|generic]"-}--#==============================================================================-# Main Execution-#==============================================================================--main() {- # Validate environment before proceeding- validate_environment-- log_info "=== Updating agent context files for feature $CURRENT_BRANCH ==="-- # Parse the plan file to extract project information- if ! parse_plan_data "$NEW_PLAN"; then- log_error "Failed to parse plan data"- exit 1- fi-- # Process based on agent type argument- local success=true-- if [[ -z "$AGENT_TYPE" ]]; then- # No specific agent provided - update all existing agent files- log_info "No agent specified, updating all existing agent files..."- if ! update_all_existing_agents; then- success=false- fi- else- # Specific agent provided - update only that agent- log_info "Updating specific agent: $AGENT_TYPE"- if ! update_specific_agent "$AGENT_TYPE"; then- success=false- fi- fi-- # Print summary- print_summary-- if [[ "$success" == true ]]; then- log_success "Agent context update completed successfully"- exit 0- else- log_error "Agent context update completed with errors"- exit 1- fi-}--# Execute main function if script is run directly-if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then- main "$@"-fidiff --git a/scripts/powershell/update-agent-context.ps1 b/scripts/powershell/update-agent-context.ps1deleted file mode 100644index 3ee45d383..000000000--- a/scripts/powershell/update-agent-context.ps1+++ /dev/null@@ -1,515 +0,0 @@-#!/usr/bin/env pwsh-<#!-.SYNOPSIS-Update agent context files with information from plan.md (PowerShell version)--.DESCRIPTION-Mirrors the behavior of scripts/bash/update-agent-context.sh:- 1. Environment Validation- 2. Plan Data Extraction- 3. Agent File Management (create from template or update existing)- 4. Content Generation (technology stack, recent changes, timestamp)- 5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, junie, kilocode, auggie, roo, codebuddy, amp, shai, tabnine, kiro-cli, agy, bob, vibe, qodercli, kimi, trae, pi, iflow, forge, goose, generic)--.PARAMETER AgentType-Optional agent key to update a single agent. If omitted, updates all existing agent files (creating a default Claude file if none exist).--.EXAMPLE-./update-agent-context.ps1 -AgentType claude--.EXAMPLE-./update-agent-context.ps1 # Updates all existing agent files--.NOTES-Relies on common helper functions in common.ps1-#>-param(- [Parameter(Position=0)]- [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','junie','kilocode','auggie','roo','codebuddy','amp','shai','tabnine','kiro-cli','agy','bob','vibe','qodercli','kimi','trae','pi','iflow','forge','goose','generic')]- [string]$AgentType-)--$ErrorActionPreference = 'Stop'--# Import common helpers-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path-. (Join-Path $ScriptDir 'common.ps1')--# Acquire environment paths-$envData = Get-FeaturePathsEnv-$REPO_ROOT = $envData.REPO_ROOT-$CURRENT_BRANCH = $envData.CURRENT_BRANCH-$HAS_GIT = $envData.HAS_GIT-$IMPL_PLAN = $envData.IMPL_PLAN-$NEW_PLAN = $IMPL_PLAN--# Agent file paths-$CLAUDE_FILE = Join-Path $REPO_ROOT 'CLAUDE.md'-$GEMINI_FILE = Join-Path $REPO_ROOT 'GEMINI.md'-$COPILOT_FILE = Join-Path $REPO_ROOT '.github/copilot-instructions.md'-$CURSOR_FILE = Join-Path $REPO_ROOT '.cursor/rules/specify-rules.mdc'-$QWEN_FILE = Join-Path $REPO_ROOT 'QWEN.md'-$AGENTS_FILE = Join-Path $REPO_ROOT 'AGENTS.md'-$WINDSURF_FILE = Join-Path $REPO_ROOT '.windsurf/rules/specify-rules.md'-$JUNIE_FILE = Join-Path $REPO_ROOT '.junie/AGENTS.md'-$KILOCODE_FILE = Join-Path $REPO_ROOT '.kilocode/rules/specify-rules.md'-$AUGGIE_FILE = Join-Path $REPO_ROOT '.augment/rules/specify-rules.md'-$ROO_FILE = Join-Path $REPO_ROOT '.roo/rules/specify-rules.md'-$CODEBUDDY_FILE = Join-Path $REPO_ROOT 'CODEBUDDY.md'-$QODER_FILE = Join-Path $REPO_ROOT 'QODER.md'-$AMP_FILE = Join-Path $REPO_ROOT 'AGENTS.md'-$SHAI_FILE = Join-Path $REPO_ROOT 'SHAI.md'-$TABNINE_FILE = Join-Path $REPO_ROOT 'TABNINE.md'-$KIRO_FILE = Join-Path $REPO_ROOT 'AGENTS.md'-$AGY_FILE = Join-Path $REPO_ROOT '.agent/rules/specify-rules.md'-$BOB_FILE = Join-Path $REPO_ROOT 'AGENTS.md'-$VIBE_FILE = Join-Path $REPO_ROOT '.vibe/agents/specify-agents.md'-$KIMI_FILE = Join-Path $REPO_ROOT 'KIMI.md'-$TRAE_FILE = Join-Path $REPO_ROOT '.trae/rules/project_rules.md'-$IFLOW_FILE = Join-Path $REPO_ROOT 'IFLOW.md'-$FORGE_FILE = Join-Path $REPO_ROOT 'AGENTS.md'-$GOOSE_FILE = Join-Path $REPO_ROOT 'AGENTS.md'--$TEMPLATE_FILE = Join-Path $REPO_ROOT '.specify/templates/agent-file-template.md'--# Parsed plan data placeholders-$script:NEW_LANG = ''-$script:NEW_FRAMEWORK = ''-$script:NEW_DB = ''-$script:NEW_PROJECT_TYPE = ''--function Write-Info {- param(- [Parameter(Mandatory=$true)]- [string]$Message- )- Write-Host "INFO: $Message"-}--function Write-Success {- param(- [Parameter(Mandatory=$true)]- [string]$Message- )- Write-Host "$([char]0x2713) $Message"-}--function Write-WarningMsg {- param(- [Parameter(Mandatory=$true)]- [string]$Message- )- Write-Warning $Message-}--function Write-Err {- param(- [Parameter(Mandatory=$true)]- [string]$Message- )- Write-Host "ERROR: $Message" -ForegroundColor Red-}--function Validate-Environment {- if (-not $CURRENT_BRANCH) {- Write-Err 'Unable to determine current feature'- if ($HAS_GIT) { Write-Info "Make sure you're on a feature branch" } else { Write-Info 'Set SPECIFY_FEATURE environment variable or create a feature first' }- exit 1- }- if (-not (Test-Path $NEW_PLAN)) {- Write-Err "No plan.md found at $NEW_PLAN"- Write-Info 'Ensure you are working on a feature with a corresponding spec directory'- if (-not $HAS_GIT) { Write-Info 'Use: $env:SPECIFY_FEATURE=your-feature-name or create a new feature first' }- exit 1- }- if (-not (Test-Path $TEMPLATE_FILE)) {- Write-Err "Template file not found at $TEMPLATE_FILE"- Write-Info 'Run specify init to scaffold .specify/templates, or add agent-file-template.md there.'- exit 1- }-}--function Extract-PlanField {- param(- [Parameter(Mandatory=$true)]- [string]$FieldPattern,- [Parameter(Mandatory=$true)]- [string]$PlanFile- )- if (-not (Test-Path $PlanFile)) { return '' }- # Lines like **Language/Version**: Python 3.12- $regex = "^\*\*$([Regex]::Escape($FieldPattern))\*\*: (.+)$"- Get-Content -LiteralPath $PlanFile -Encoding utf8 | ForEach-Object {- if ($_ -match $regex) {- $val = $Matches[1].Trim()- if ($val -notin @('NEEDS CLARIFICATION','N/A')) { return $val }- }- } | Select-Object -First 1-}--function Parse-PlanData {- param(- [Parameter(Mandatory=$true)]- [string]$PlanFile- )- if (-not (Test-Path $PlanFile)) { Write-Err "Plan file not found: $PlanFile"; return $false }- Write-Info "Parsing plan data from $PlanFile"- $script:NEW_LANG = Extract-PlanField -FieldPattern 'Language/Version' -PlanFile $PlanFile- $script:NEW_FRAMEWORK = Extract-PlanField -FieldPattern 'Primary Dependencies' -PlanFile $PlanFile- $script:NEW_DB = Extract-PlanField -FieldPattern 'Storage' -PlanFile $PlanFile- $script:NEW_PROJECT_TYPE = Extract-PlanField -FieldPattern 'Project Type' -PlanFile $PlanFile-- if ($NEW_LANG) { Write-Info "Found language: $NEW_LANG" } else { Write-WarningMsg 'No language information found in plan' }- if ($NEW_FRAMEWORK) { Write-Info "Found framework: $NEW_FRAMEWORK" }- if ($NEW_DB -and $NEW_DB -ne 'N/A') { Write-Info "Found database: $NEW_DB" }- if ($NEW_PROJECT_TYPE) { Write-Info "Found project type: $NEW_PROJECT_TYPE" }- return $true-}--function Format-TechnologyStack {- param(- [Parameter(Mandatory=$false)]- [string]$Lang,- [Parameter(Mandatory=$false)]- [string]$Framework- )- $parts = @()- if ($Lang -and $Lang -ne 'NEEDS CLARIFICATION') { $parts += $Lang }- if ($Framework -and $Framework -notin @('NEEDS CLARIFICATION','N/A')) { $parts += $Framework }- if (-not $parts) { return '' }- return ($parts -join ' + ')-}--function Get-ProjectStructure {- param(- [Parameter(Mandatory=$false)]- [string]$ProjectType- )- if ($ProjectType -match 'web') { return "backend/`nfrontend/`ntests/" } else { return "src/`ntests/" }-}--function Get-CommandsForLanguage {- param(- [Parameter(Mandatory=$false)]- [string]$Lang- )- switch -Regex ($Lang) {- 'Python' { return "cd src; pytest; ruff check ." }- 'Rust' { return "cargo test; cargo clippy" }- 'JavaScript|TypeScript' { return "npm test; npm run lint" }- default { return "# Add commands for $Lang" }- }-}--function Get-LanguageConventions {- param(- [Parameter(Mandatory=$false)]- [string]$Lang- )- if ($Lang) { "${Lang}: Follow standard conventions" } else { 'General: Follow standard conventions' }-}--function New-AgentFile {- param(- [Parameter(Mandatory=$true)]- [string]$TargetFile,- [Parameter(Mandatory=$true)]- [string]$ProjectName,- [Parameter(Mandatory=$true)]- [datetime]$Date- )- if (-not (Test-Path $TEMPLATE_FILE)) { Write-Err "Template not found at $TEMPLATE_FILE"; return $false }- $temp = New-TemporaryFile- Copy-Item -LiteralPath $TEMPLATE_FILE -Destination $temp -Force-- $projectStructure = Get-ProjectStructure -ProjectType $NEW_PROJECT_TYPE- $commands = Get-CommandsForLanguage -Lang $NEW_LANG- $languageConventions = Get-LanguageConventions -Lang $NEW_LANG-- $escaped_lang = $NEW_LANG- $escaped_framework = $NEW_FRAMEWORK- $escaped_branch = $CURRENT_BRANCH-- $content = Get-Content -LiteralPath $temp -Raw -Encoding utf8- $content = $content -replace '\[PROJECT NAME\]',$ProjectName- $content = $content -replace '\[DATE\]',$Date.ToString('yyyy-MM-dd')-- # Build the technology stack string safely- $techStackForTemplate = ""- if ($escaped_lang -and $escaped_framework) {- $techStackForTemplate = "- $escaped_lang + $escaped_framework ($escaped_branch)"- } elseif ($escaped_lang) {- $techStackForTemplate = "- $escaped_lang ($escaped_branch)"- } elseif ($escaped_framework) {- $techStackForTemplate = "- $escaped_framework ($escaped_branch)"- }-- $content = $content -replace '\[EXTRACTED FROM ALL PLAN.MD FILES\]',$techStackForTemplate- # For project structure we manually embed (keep newlines)- $escapedStructure = [Regex]::Escape($projectStructure)- $content = $content -replace '\[ACTUAL STRUCTURE FROM PLANS\]',$escapedStructure- # Replace escaped newlines placeholder after all replacements- $content = $content -replace '\[ONLY COMMANDS FOR ACTIVE TECHNOLOGIES\]',$commands- $content = $content -replace '\[LANGUAGE-SPECIFIC, ONLY FOR LANGUAGES IN USE\]',$languageConventions-- # Build the recent changes string safely- $recentChangesForTemplate = ""- if ($escaped_lang -and $escaped_framework) {- $recentChangesForTemplate = "- ${escaped_branch}: Added ${escaped_lang} + ${escaped_framework}"- } elseif ($escaped_lang) {- $recentChangesForTemplate = "- ${escaped_branch}: Added ${escaped_lang}"- } elseif ($escaped_framework) {- $recentChangesForTemplate = "- ${escaped_branch}: Added ${escaped_framework}"- }-- $content = $content -replace '\[LAST 3 FEATURES AND WHAT THEY ADDED\]',$recentChangesForTemplate- # Convert literal \n sequences introduced by Escape to real newlines- $content = $content -replace '\\n',[Environment]::NewLine-- # Prepend Cursor frontmatter for .mdc files so rules are auto-included- if ($TargetFile -match '\.mdc$') {- $frontmatter = @('---','description: Project Development Guidelines','globs: ["**/*"]','alwaysApply: true','---','') -join [Environment]::NewLine- $content = $frontmatter + $content- }-- $parent = Split-Path -Parent $TargetFile- if (-not (Test-Path $parent)) { New-Item -ItemType Directory -Path $parent | Out-Null }- Set-Content -LiteralPath $TargetFile -Value $content -NoNewline -Encoding utf8- Remove-Item $temp -Force- return $true-}--function Update-ExistingAgentFile {- param(- [Parameter(Mandatory=$true)]- [string]$TargetFile,- [Parameter(Mandatory=$true)]- [datetime]$Date- )- if (-not (Test-Path $TargetFile)) { return (New-AgentFile -TargetFile $TargetFile -ProjectName (Split-Path $REPO_ROOT -Leaf) -Date $Date) }-- $techStack = Format-TechnologyStack -Lang $NEW_LANG -Framework $NEW_FRAMEWORK- $newTechEntries = @()- if ($techStack) {- $escapedTechStack = [Regex]::Escape($techStack)- if (-not (Select-String -Pattern $escapedTechStack -Path $TargetFile -Quiet)) {- $newTechEntries += "- $techStack ($CURRENT_BRANCH)"- }- }- if ($NEW_DB -and $NEW_DB -notin @('N/A','NEEDS CLARIFICATION')) {- $escapedDB = [Regex]::Escape($NEW_DB)- if (-not (Select-String -Pattern $escapedDB -Path $TargetFile -Quiet)) {- $newTechEntries += "- $NEW_DB ($CURRENT_BRANCH)"- }- }- $newChangeEntry = ''- if ($techStack) { $newChangeEntry = "- ${CURRENT_BRANCH}: Added ${techStack}" }- elseif ($NEW_DB -and $NEW_DB -notin @('N/A','NEEDS CLARIFICATION')) { $newChangeEntry = "- ${CURRENT_BRANCH}: Added ${NEW_DB}" }-- $lines = Get-Content -LiteralPath $TargetFile -Encoding utf8- $output = New-Object System.Collections.Generic.List[string]- $inTech = $false; $inChanges = $false; $techAdded = $false; $changeAdded = $false; $existingChanges = 0-- for ($i=0; $i -lt $lines.Count; $i++) {- $line = $lines[$i]- if ($line -eq '## Active Technologies') {- $output.Add($line)- $inTech = $true- continue- }- if ($inTech -and $line -match '^##\s') {- if (-not $techAdded -and $newTechEntries.Count -gt 0) { $newTechEntries | ForEach-Object { $output.Add($_) }; $techAdded = $true }- $output.Add($line); $inTech = $false; continue- }- if ($inTech -and [string]::IsNullOrWhiteSpace($line)) {- if (-not $techAdded -and $newTechEntries.Count -gt 0) { $newTechEntries | ForEach-Object { $output.Add($_) }; $techAdded = $true }- $output.Add($line); continue- }- if ($line -eq '## Recent Changes') {- $output.Add($line)- if ($newChangeEntry) { $output.Add($newChangeEntry); $changeAdded = $true }- $inChanges = $true- continue- }- if ($inChanges -and $line -match '^##\s') { $output.Add($line); $inChanges = $false; continue }- if ($inChanges -and $line -match '^- ') {- if ($existingChanges -lt 2) { $output.Add($line); $existingChanges++ }- continue- }- if ($line -match '(\*\*)?Last updated(\*\*)?: .*\d{4}-\d{2}-\d{2}') {- $output.Add(($line -replace '\d{4}-\d{2}-\d{2}',$Date.ToString('yyyy-MM-dd')))- continue- }- $output.Add($line)- }-- # Post-loop check: if we're still in the Active Technologies section and haven't added new entries- if ($inTech -and -not $techAdded -and $newTechEntries.Count -gt 0) {- $newTechEntries | ForEach-Object { $output.Add($_) }- }-- # Ensure Cursor .mdc files have YAML frontmatter for auto-inclusion- if ($TargetFile -match '\.mdc$' -and $output.Count -gt 0 -and $output[0] -ne '---') {- $frontmatter = @('---','description: Project Development Guidelines','globs: ["**/*"]','alwaysApply: true','---','')- $output.InsertRange(0, $frontmatter)- }-- Set-Content -LiteralPath $TargetFile -Value ($output -join [Environment]::NewLine) -Encoding utf8- return $true-}--function Update-AgentFile {- param(- [Parameter(Mandatory=$true)]- [string]$TargetFile,- [Parameter(Mandatory=$true)]- [string]$AgentName- )- if (-not $TargetFile -or -not $AgentName) { Write-Err 'Update-AgentFile requires TargetFile and AgentName'; return $false }- Write-Info "Updating $AgentName context file: $TargetFile"- $projectName = Split-Path $REPO_ROOT -Leaf- $date = Get-Date-- $dir = Split-Path -Parent $TargetFile- if (-not (Test-Path $dir)) { New-Item -ItemType Directory -Path $dir | Out-Null }-- if (-not (Test-Path $TargetFile)) {- if (New-AgentFile -TargetFile $TargetFile -ProjectName $projectName -Date $date) { Write-Success "Created new $AgentName context file" } else { Write-Err 'Failed to create new agent file'; return $false }- } else {- try {- if (Update-ExistingAgentFile -TargetFile $TargetFile -Date $date) { Write-Success "Updated existing $AgentName context file" } else { Write-Err 'Failed to update agent file'; return $false }- } catch {- Write-Err "Cannot access or update existing file: $TargetFile. $_"- return $false- }- }- return $true-}--function Update-SpecificAgent {- param(- [Parameter(Mandatory=$true)]- [string]$Type- )- switch ($Type) {- 'claude' { Update-AgentFile -TargetFile $CLAUDE_FILE -AgentName 'Claude Code' }- 'gemini' { Update-AgentFile -TargetFile $GEMINI_FILE -AgentName 'Gemini CLI' }- 'copilot' { Update-AgentFile -TargetFile $COPILOT_FILE -AgentName 'GitHub Copilot' }- 'cursor-agent' { Update-AgentFile -TargetFile $CURSOR_FILE -AgentName 'Cursor IDE' }- 'qwen' { Update-AgentFile -TargetFile $QWEN_FILE -AgentName 'Qwen Code' }- 'opencode' { Update-AgentFile -TargetFile $AGENTS_FILE -AgentName 'opencode' }- 'codex' { Update-AgentFile -TargetFile $AGENTS_FILE -AgentName 'Codex CLI' }- 'windsurf' { Update-AgentFile -TargetFile $WINDSURF_FILE -AgentName 'Windsurf' }- 'junie' { Update-AgentFile -TargetFile $JUNIE_FILE -AgentName 'Junie' }- 'kilocode' { Update-AgentFile -TargetFile $KILOCODE_FILE -AgentName 'Kilo Code' }- 'auggie' { Update-AgentFile -TargetFile $AUGGIE_FILE -AgentName 'Auggie CLI' }- 'roo' { Update-AgentFile -TargetFile $ROO_FILE -AgentName 'Roo Code' }- 'codebuddy' { Update-AgentFile -TargetFile $CODEBUDDY_FILE -AgentName 'CodeBuddy CLI' }- 'qodercli' { Update-AgentFile -TargetFile $QODER_FILE -AgentName 'Qoder CLI' }- 'amp' { Update-AgentFile -TargetFile $AMP_FILE -AgentName 'Amp' }- 'shai' { Update-AgentFile -TargetFile $SHAI_FILE -AgentName 'SHAI' }- 'tabnine' { Update-AgentFile -TargetFile $TABNINE_FILE -AgentName 'Tabnine CLI' }- 'kiro-cli' { Update-AgentFile -TargetFile $KIRO_FILE -AgentName 'Kiro CLI' }- 'agy' { Update-AgentFile -TargetFile $AGY_FILE -AgentName 'Antigravity' }- 'bob' { Update-AgentFile -TargetFile $BOB_FILE -AgentName 'IBM Bob' }- 'vibe' { Update-AgentFile -TargetFile $VIBE_FILE -AgentName 'Mistral Vibe' }- 'kimi' { Update-AgentFile -TargetFile $KIMI_FILE -AgentName 'Kimi Code' }- 'trae' { Update-AgentFile -TargetFile $TRAE_FILE -AgentName 'Trae' }- 'pi' { Update-AgentFile -TargetFile $AGENTS_FILE -AgentName 'Pi Coding Agent' }- 'iflow' { Update-AgentFile -TargetFile $IFLOW_FILE -AgentName 'iFlow CLI' }- 'forge' { Update-AgentFile -TargetFile $FORGE_FILE -AgentName 'Forge' }- 'goose' { Update-AgentFile -TargetFile $GOOSE_FILE -AgentName 'Goose' }- 'generic' { Write-Info 'Generic agent: no predefined context file. Use the agent-specific update script for your agent.' }- default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|junie|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|forge|goose|generic'; return $false }- }-}--function Update-AllExistingAgents {- $found = $false- $ok = $true- $updatedPaths = @()-- # Helper function to update only if file exists and hasn't been updated yet- function Update-IfNew {- param(- [Parameter(Mandatory=$true)]- [string]$FilePath,- [Parameter(Mandatory=$true)]- [string]$AgentName- )-- if (-not (Test-Path $FilePath)) { return $true }-- # Get the real path to detect duplicates (e.g., AMP_FILE, KIRO_FILE, BOB_FILE all point to AGENTS.md)- $realPath = (Get-Item -LiteralPath $FilePath).FullName-- # Check if we've already updated this file- if ($updatedPaths -contains $realPath) {- return $true- }-- # Record the file as seen before attempting the update- # Use parent scope (1) to modify Update-AllExistingAgents' local variables- Set-Variable -Name updatedPaths -Value ($updatedPaths + $realPath) -Scope 1- Set-Variable -Name found -Value $true -Scope 1-- # Perform the update- return (Update-AgentFile -TargetFile $FilePath -AgentName $AgentName)- }-- if (-not (Update-IfNew -FilePath $CLAUDE_FILE -AgentName 'Claude Code')) { $ok = $false }- if (-not (Update-IfNew -FilePath $GEMINI_FILE -AgentName 'Gemini CLI')) { $ok = $false }- if (-not (Update-IfNew -FilePath $COPILOT_FILE -AgentName 'GitHub Copilot')) { $ok = $false }- if (-not (Update-IfNew -FilePath $CURSOR_FILE -AgentName 'Cursor IDE')) { $ok = $false }- if (-not (Update-IfNew -FilePath $QWEN_FILE -AgentName 'Qwen Code')) { $ok = $false }- if (-not (Update-IfNew -FilePath $AGENTS_FILE -AgentName 'Codex/opencode/Amp/Kiro/Bob/Pi/Forge/Goose')) { $ok = $false }- if (-not (Update-IfNew -FilePath $WINDSURF_FILE -AgentName 'Windsurf')) { $ok = $false }- if (-not (Update-IfNew -FilePath $JUNIE_FILE -AgentName 'Junie')) { $ok = $false }- if (-not (Update-IfNew -FilePath $KILOCODE_FILE -AgentName 'Kilo Code')) { $ok = $false }- if (-not (Update-IfNew -FilePath $AUGGIE_FILE -AgentName 'Auggie CLI')) { $ok = $false }- if (-not (Update-IfNew -FilePath $ROO_FILE -AgentName 'Roo Code')) { $ok = $false }- if (-not (Update-IfNew -FilePath $CODEBUDDY_FILE -AgentName 'CodeBuddy CLI')) { $ok = $false }- if (-not (Update-IfNew -FilePath $QODER_FILE -AgentName 'Qoder CLI')) { $ok = $false }- if (-not (Update-IfNew -FilePath $SHAI_FILE -AgentName 'SHAI')) { $ok = $false }- if (-not (Update-IfNew -FilePath $TABNINE_FILE -AgentName 'Tabnine CLI')) { $ok = $false }- if (-not (Update-IfNew -FilePath $AGY_FILE -AgentName 'Antigravity')) { $ok = $false }- if (-not (Update-IfNew -FilePath $VIBE_FILE -AgentName 'Mistral Vibe')) { $ok = $false }- if (-not (Update-IfNew -FilePath $KIMI_FILE -AgentName 'Kimi Code')) { $ok = $false }- if (-not (Update-IfNew -FilePath $TRAE_FILE -AgentName 'Trae')) { $ok = $false }- if (-not (Update-IfNew -FilePath $IFLOW_FILE -AgentName 'iFlow CLI')) { $ok = $false }-- if (-not $found) {- Write-Info 'No existing agent files found, creating default Claude file...'- if (-not (Update-AgentFile -TargetFile $CLAUDE_FILE -AgentName 'Claude Code')) { $ok = $false }- }- return $ok-}--function Print-Summary {- Write-Host ''- Write-Info 'Summary of changes:'- if ($NEW_LANG) { Write-Host " - Added language: $NEW_LANG" }- if ($NEW_FRAMEWORK) { Write-Host " - Added framework: $NEW_FRAMEWORK" }- if ($NEW_DB -and $NEW_DB -ne 'N/A') { Write-Host " - Added database: $NEW_DB" }- Write-Host ''- Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|junie|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|forge|goose|generic]'-}--function Main {- Validate-Environment- Write-Info "=== Updating agent context files for feature $CURRENT_BRANCH ==="- if (-not (Parse-PlanData -PlanFile $NEW_PLAN)) { Write-Err 'Failed to parse plan data'; exit 1 }- $success = $true- if ($AgentType) {- Write-Info "Updating specific agent: $AgentType"- if (-not (Update-SpecificAgent -Type $AgentType)) { $success = $false }- }- else {- Write-Info 'No agent specified, updating all existing agent files...'- if (-not (Update-AllExistingAgents)) { $success = $false }- }- Print-Summary- if ($success) { Write-Success 'Agent context update completed successfully'; exit 0 } else { Write-Err 'Agent context update completed with errors'; exit 1 }-}--Maindiff --git a/src/specify_cli/__init__.py b/src/specify_cli/__init__.pyindex 0608e7a8a..8c6fd02b9 100644--- a/src/specify_cli/__init__.py+++ b/src/specify_cli/__init__.py@@ -1261,15 +1261,11 @@ def init(manifest.save()# Write .specify/integration.json- script_ext = "sh" if selected_script == "sh" else "ps1"integration_json = project_path / ".specify" / "integration.json"integration_json.parent.mkdir(parents=True, exist_ok=True)integration_json.write_text(json.dumps({"integration": resolved_integration.key,"version": get_speckit_version(),- "scripts": {- "update-context": f".specify/integrations/{resolved_integration.key}/scripts/update-context.{script_ext}",- },}, indent=2) + "\n", encoding="utf-8")tracker.complete("integration", resolved_integration.config.get("name", resolved_integration.key))@@ -1373,6 +1369,7 @@ def init("ai": selected_ai,"integration": resolved_integration.key,"branch_numbering": branch_numbering or "sequential",+ "context_file": resolved_integration.context_file,"here": here,"preset": preset,"script": selected_script,@@ -1737,18 +1734,13 @@ def _read_integration_json(project_root: Path) -> dict[str, Any]:def _write_integration_json(project_root: Path,integration_key: str,- script_type: str,) -> None:"""Write ``.specify/integration.json`` for *integration_key*."""- script_ext = "sh" if script_type == "sh" else "ps1"dest = project_root / INTEGRATION_JSONdest.parent.mkdir(parents=True, exist_ok=True)dest.write_text(json.dumps({"integration": integration_key,"version": get_speckit_version(),- "scripts": {- "update-context": f".specify/integrations/{integration_key}/scripts/update-context.{script_ext}",- },}, indent=2) + "\n", encoding="utf-8")@@ -1936,7 +1928,7 @@ def integration_install(raw_options=integration_options,)manifest.save()- _write_integration_json(project_root, integration.key, selected_script)+ _write_integration_json(project_root, integration.key)_update_init_options_for_integration(project_root, integration, script_type=selected_script)except Exception as e:@@ -2013,6 +2005,7 @@ def _update_init_options_for_integration(opts = load_init_options(project_root)opts["integration"] = integration.keyopts["ai"] = integration.key+ opts["context_file"] = integration.context_fileif script_type:opts["script"] = script_typeif isinstance(integration, SkillsIntegration):@@ -2064,6 +2057,7 @@ def integration_uninstall(opts.pop("integration", None)opts.pop("ai", None)opts.pop("ai_skills", None)+ opts.pop("context_file", None)save_init_options(project_root, opts)raise typer.Exit(0)@@ -2082,6 +2076,10 @@ def integration_uninstall(removed, skipped = manifest.uninstall(project_root, force=force)+ # Remove managed context section from the agent context file+ if integration:+ integration.remove_context_section(project_root)+_remove_integration_json(project_root)# Update init-options.json to clear the integration@@ -2090,6 +2088,7 @@ def integration_uninstall(opts.pop("integration", None)opts.pop("ai", None)opts.pop("ai_skills", None)+ opts.pop("context_file", None)save_init_options(project_root, opts)name = (integration.config or {}).get("name", key) if integration else key@@ -2156,6 +2155,7 @@ def integration_switch()raise typer.Exit(1)removed, skipped = old_manifest.uninstall(project_root, force=force)+ current_integration.remove_context_section(project_root)if removed:console.print(f" Removed {len(removed)} file(s)")if skipped:@@ -2186,6 +2186,7 @@ def integration_switch(opts.pop("integration", None)opts.pop("ai", None)opts.pop("ai_skills", None)+ opts.pop("context_file", None)save_init_options(project_root, opts)# Ensure shared infrastructure is present (safe to run unconditionally;@@ -2212,7 +2213,7 @@ def integration_switch(raw_options=integration_options,)manifest.save()- _write_integration_json(project_root, target_integration.key, selected_script)+ _write_integration_json(project_root, target_integration.key)_update_init_options_for_integration(project_root, target_integration, script_type=selected_script)except Exception as e:@@ -2320,7 +2321,7 @@ def integration_upgrade(raw_options=integration_options,)new_manifest.save()- _write_integration_json(project_root, key, selected_script)+ _write_integration_json(project_root, key)_update_init_options_for_integration(project_root, integration, script_type=selected_script)except Exception as exc:# Don't teardown β setup overwrites in-place, so teardown woulddiff --git a/src/specify_cli/agents.py b/src/specify_cli/agents.pyindex 32fc6cdbf..1a0e5a831 100644--- a/src/specify_cli/agents.py+++ b/src/specify_cli/agents.py@@ -110,9 +110,9 @@ class CommandRegistrar:"""Normalize script paths in frontmatter to generated project locations.Rewrites known repo-relative and top-level script paths under the- `scripts` and `agent_scripts` keys (for example `../../scripts/`,- `../../templates/`, `../../memory/`, `scripts/`, `templates/`, and- `memory/`) to the `.specify/...` paths used in generated projects.+ ``scripts`` key (for example ``../../scripts/``,+ ``../../templates/``, ``../../memory/``, ``scripts/``, ``templates/``, and+ ``memory/``) to the ``.specify/...`` paths used in generated projects.Args:frontmatter: Frontmatter dictionary@@ -122,11 +122,8 @@ class CommandRegistrar:"""frontmatter = deepcopy(frontmatter)- for script_key in ("scripts", "agent_scripts"):- scripts = frontmatter.get(script_key)- if not isinstance(scripts, dict):- continue-+ scripts = frontmatter.get("scripts")+ if isinstance(scripts, dict):for key, script_path in scripts.items():if isinstance(script_path, str):scripts[key] = self.rewrite_project_relative_paths(script_path)@@ -333,11 +330,8 @@ class CommandRegistrar:frontmatter = {}scripts = frontmatter.get("scripts", {}) or {}- agent_scripts = frontmatter.get("agent_scripts", {}) or {}if not isinstance(scripts, dict):scripts = {}- if not isinstance(agent_scripts, dict):- agent_scripts = {}init_opts = load_init_options(project_root)if not isinstance(init_opts, dict):@@ -351,17 +345,14 @@ class CommandRegistrar:)secondary_variant = "sh" if default_variant == "ps" else "ps"- if default_variant in scripts or default_variant in agent_scripts:+ if default_variant in scripts:fallback_order.append(default_variant)- if secondary_variant in scripts or secondary_variant in agent_scripts:+ if secondary_variant in scripts:fallback_order.append(secondary_variant)for key in scripts:if key not in fallback_order:fallback_order.append(key)- for key in agent_scripts:- if key not in fallback_order:- fallback_order.append(key)script_variant = fallback_order[0] if fallback_order else None@@ -370,14 +361,12 @@ class CommandRegistrar:script_command = script_command.replace("{ARGS}", "$ARGUMENTS")body = body.replace("{SCRIPT}", script_command)- agent_script_command = (- agent_scripts.get(script_variant) if script_variant else None- )- if agent_script_command:- agent_script_command = agent_script_command.replace("{ARGS}", "$ARGUMENTS")- body = body.replace("{AGENT_SCRIPT}", agent_script_command)-body = body.replace("{ARGS}", "$ARGUMENTS").replace("__AGENT__", agent_name)++ # Resolve __CONTEXT_FILE__ from init-options+ context_file = init_opts.get("context_file") or ""+ body = body.replace("__CONTEXT_FILE__", context_file)+return CommandRegistrar.rewrite_project_relative_paths(body)def _convert_argument_placeholder(diff --git a/src/specify_cli/integrations/agy/scripts/update-context.ps1 b/src/specify_cli/integrations/agy/scripts/update-context.ps1deleted file mode 100644index 9eeb46165..000000000--- a/src/specify_cli/integrations/agy/scripts/update-context.ps1+++ /dev/null@@ -1,17 +0,0 @@-# update-context.ps1 β Antigravity (agy) integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.--$ErrorActionPreference = 'Stop'--$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType agydiff --git a/src/specify_cli/integrations/agy/scripts/update-context.sh b/src/specify_cli/integrations/agy/scripts/update-context.shdeleted file mode 100755index d7303f619..000000000--- a/src/specify_cli/integrations/agy/scripts/update-context.sh+++ /dev/null@@ -1,24 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Antigravity (agy) integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.--set -euo pipefail--_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" agydiff --git a/src/specify_cli/integrations/amp/scripts/update-context.ps1 b/src/specify_cli/integrations/amp/scripts/update-context.ps1deleted file mode 100644index c217b99f9..000000000--- a/src/specify_cli/integrations/amp/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Amp integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType ampdiff --git a/src/specify_cli/integrations/amp/scripts/update-context.sh b/src/specify_cli/integrations/amp/scripts/update-context.shdeleted file mode 100755index 56cbf6e78..000000000--- a/src/specify_cli/integrations/amp/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Amp integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" ampdiff --git a/src/specify_cli/integrations/auggie/scripts/update-context.ps1 b/src/specify_cli/integrations/auggie/scripts/update-context.ps1deleted file mode 100644index 49e7e6b5f..000000000--- a/src/specify_cli/integrations/auggie/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Auggie CLI integration: create/update .augment/rules/specify-rules.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType auggiediff --git a/src/specify_cli/integrations/auggie/scripts/update-context.sh b/src/specify_cli/integrations/auggie/scripts/update-context.shdeleted file mode 100755index 4cf80bba2..000000000--- a/src/specify_cli/integrations/auggie/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Auggie CLI integration: create/update .augment/rules/specify-rules.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" auggiediff --git a/src/specify_cli/integrations/base.py b/src/specify_cli/integrations/base.pyindex 2c01e25b0..4c71b165e 100644--- a/src/specify_cli/integrations/base.py+++ b/src/specify_cli/integrations/base.py@@ -84,6 +84,11 @@ class IntegrationBase(ABC):context_file: str | None = None"""Relative path to the agent context file (e.g. ``CLAUDE.md``)."""+ # -- Markers for managed context section ------------------------------++ CONTEXT_MARKER_START = "<!-- SPECKIT START -->"+ CONTEXT_MARKER_END = "<!-- SPECKIT END -->"+# -- Public API -------------------------------------------------------@classmethod@@ -380,22 +385,235 @@ class IntegrationBase(ABC):return created+ # -- Agent context file management ------------------------------------++ @staticmethod+ def _ensure_mdc_frontmatter(content: str) -> str:+ """Ensure ``.mdc`` content has YAML frontmatter with ``alwaysApply: true``.++ If frontmatter is missing, prepend it. If frontmatter exists but+ ``alwaysApply`` is absent or not ``true``, inject/fix it.++ Uses string/regex manipulation to preserve comments and formatting+ in existing frontmatter.+ """+ import re as _re++ leading_ws = len(content) - len(content.lstrip())+ leading = content[:leading_ws]+ stripped = content[leading_ws:]++ if not stripped.startswith("---"):+ return "---\nalwaysApply: true\n---\n\n" + content++ # Match frontmatter block: ---\n...\n---+ match = _re.match(+ r"^(---[ \t]*\r?\n)(.*?)(\r?\n---[ \t]*)(\r?\n|$)(.*)",+ stripped,+ _re.DOTALL,+ )+ if not match:+ return "---\nalwaysApply: true\n---\n\n" + content++ opening, fm_text, closing, sep, rest = match.groups()+ newline = "\r\n" if "\r\n" in opening else "\n"++ # Already correct?+ if _re.search(+ r"(?m)^[ \t]*alwaysApply[ \t]*:[ \t]*true[ \t]*(?:#.*)?$", fm_text+ ):+ return content++ # alwaysApply exists but wrong value β fix in place while preserving+ # indentation and any trailing inline comment.+ if _re.search(r"(?m)^[ \t]*alwaysApply[ \t]*:", fm_text):+ fm_text = _re.sub(+ r"(?m)^([ \t]*)alwaysApply[ \t]*:.*?([ \t]*(?:#.*)?)$",+ r"\1alwaysApply: true\2",+ fm_text,+ count=1,+ )+ elif fm_text.strip():+ fm_text = fm_text + newline + "alwaysApply: true"+ else:+ fm_text = "alwaysApply: true"++ return f"{leading}{opening}{fm_text}{closing}{sep}{rest}"++ @staticmethod+ def _build_context_section(plan_path: str = "") -> str:+ """Build the content for the managed section between markers.++ *plan_path* is the project-relative path to the current plan+ (e.g. ``"specs/<feature>/plan.md"``). When empty, the section+ contains only the generic directive without a concrete path.+ """+ lines = [+ "For additional context about technologies to be used, project structure,",+ "shell commands, and other important information, read the current plan",+ ]+ if plan_path:+ lines.append(f"at {plan_path}")+ return "\n".join(lines)++ def upsert_context_section(+ self,+ project_root: Path,+ plan_path: str = "",+ ) -> Path | None:+ """Create or update the managed section in the agent context file.++ If the context file does not exist it is created with just the+ managed section. If it exists, the content between+ ``<!-- SPECKIT START -->`` and ``<!-- SPECKIT END -->`` markers+ is replaced (or appended when no markers are found).++ Returns the path to the context file, or ``None`` when+ ``context_file`` is not set.+ """+ if not self.context_file:+ return None++ ctx_path = project_root / self.context_file+ section = (+ f"{self.CONTEXT_MARKER_START}\n"+ f"{self._build_context_section(plan_path)}\n"+ f"{self.CONTEXT_MARKER_END}\n"+ )++ if ctx_path.exists():+ content = ctx_path.read_text(encoding="utf-8")+ start_idx = content.find(self.CONTEXT_MARKER_START)+ end_idx = content.find(+ self.CONTEXT_MARKER_END,+ start_idx if start_idx != -1 else 0,+ )++ if start_idx != -1 and end_idx != -1 and end_idx > start_idx:+ # Replace existing section (include the end marker + newline)+ end_of_marker = end_idx + len(self.CONTEXT_MARKER_END)+ # Consume trailing line ending (CRLF or LF)+ if end_of_marker < len(content) and content[end_of_marker] == "\r":+ end_of_marker += 1+ if end_of_marker < len(content) and content[end_of_marker] == "\n":+ end_of_marker += 1+ new_content = content[:start_idx] + section + content[end_of_marker:]+ elif start_idx != -1:+ # Corrupted: start marker without end β replace from start through EOF+ new_content = content[:start_idx] + section+ elif end_idx != -1:+ # Corrupted: end marker without start β replace BOF through end marker+ end_of_marker = end_idx + len(self.CONTEXT_MARKER_END)+ if end_of_marker < len(content) and content[end_of_marker] == "\r":+ end_of_marker += 1+ if end_of_marker < len(content) and content[end_of_marker] == "\n":+ end_of_marker += 1+ new_content = section + content[end_of_marker:]+ else:+ # No markers found β append+ if content:+ if not content.endswith("\n"):+ content += "\n"+ new_content = content + "\n" + section+ else:+ new_content = section++ # Ensure .mdc files have required YAML frontmatter+ if ctx_path.suffix == ".mdc":+ new_content = self._ensure_mdc_frontmatter(new_content)+ else:+ ctx_path.parent.mkdir(parents=True, exist_ok=True)+ # Cursor .mdc files require YAML frontmatter to be loaded+ if ctx_path.suffix == ".mdc":+ new_content = self._ensure_mdc_frontmatter(section)+ else:+ new_content = section++ normalized = new_content.replace("\r\n", "\n").replace("\r", "\n")+ ctx_path.write_bytes(normalized.encode("utf-8"))+ return ctx_path++ def remove_context_section(self, project_root: Path) -> bool:+ """Remove the managed section from the agent context file.++ Returns ``True`` if the section was found and removed. If the+ file becomes empty (or whitespace-only) after removal it is+ deleted.+ """+ if not self.context_file:+ return False++ ctx_path = project_root / self.context_file+ if not ctx_path.exists():+ return False++ content = ctx_path.read_text(encoding="utf-8")+ start_idx = content.find(self.CONTEXT_MARKER_START)+ end_idx = content.find(+ self.CONTEXT_MARKER_END,+ start_idx if start_idx != -1 else 0,+ )++ # Only remove a complete, well-ordered managed section. If either+ # marker is missing, leave the file unchanged to avoid deleting+ # unrelated user-authored content.+ if start_idx == -1 or end_idx == -1 or end_idx <= start_idx:+ return False++ removal_start = start_idx+ removal_end = end_idx + len(self.CONTEXT_MARKER_END)++ # Consume trailing line ending (CRLF or LF)+ if removal_end < len(content) and content[removal_end] == "\r":+ removal_end += 1+ if removal_end < len(content) and content[removal_end] == "\n":+ removal_end += 1++ # Also strip a blank line before the section if present+ if removal_start > 0 and content[removal_start - 1] == "\n":+ if removal_start > 1 and content[removal_start - 2] == "\n":+ removal_start -= 1++ new_content = content[:removal_start] + content[removal_end:]++ # Normalize line endings before comparisons+ normalized = new_content.replace("\r\n", "\n").replace("\r", "\n")++ # For .mdc files, treat Speckit-generated frontmatter-only content as empty+ if ctx_path.suffix == ".mdc":+ import re+ # Delete the file if only YAML frontmatter remains (no body content)+ frontmatter_only = re.match(+ r"^---\n.*?\n---\s*$", normalized, re.DOTALL+ )+ if not normalized.strip() or frontmatter_only:+ ctx_path.unlink()+ return True++ if not normalized.strip():+ ctx_path.unlink()+ else:+ ctx_path.write_bytes(normalized.encode("utf-8"))++ return True+@staticmethoddef process_template(content: str,agent_name: str,script_type: str,arg_placeholder: str = "$ARGUMENTS",+ context_file: str = "",) -> str:"""Process a raw command template into agent-ready content.Performs the same transformations as the release script:1. Extract ``scripts.<script_type>`` value from YAML frontmatter2. Replace ``{SCRIPT}`` with the extracted script command- 3. Extract ``agent_scripts.<script_type>`` and replace ``{AGENT_SCRIPT}``- 4. Strip ``scripts:`` and ``agent_scripts:`` sections from frontmatter- 5. Replace ``{ARGS}`` and ``$ARGUMENTS`` with *arg_placeholder*- 6. Replace ``__AGENT__`` with *agent_name*+ 3. Strip ``scripts:`` section from frontmatter+ 4. Replace ``{ARGS}`` and ``$ARGUMENTS`` with *arg_placeholder*+ 5. Replace ``__AGENT__`` with *agent_name*+ 6. Replace ``__CONTEXT_FILE__`` with *context_file*7. Rewrite paths: ``scripts/`` β ``.specify/scripts/`` etc."""# 1. Extract script command from frontmatter@@ -421,25 +639,7 @@ class IntegrationBase(ABC):if script_command:content = content.replace("{SCRIPT}", script_command)- # 3. Extract agent_script command- agent_script_command = ""- in_agent_scripts = False- for line in content.splitlines():- if line.strip() == "agent_scripts:":- in_agent_scripts = True- continue- if in_agent_scripts and line and not line[0].isspace():- in_agent_scripts = False- if in_agent_scripts:- m = script_pattern.match(line)- if m:- agent_script_command = m.group(1).strip()- break-- if agent_script_command:- content = content.replace("{AGENT_SCRIPT}", agent_script_command)-- # 4. Strip scripts: and agent_scripts: sections from frontmatter+ # 3. Strip scripts: section from frontmatterlines = content.splitlines(keepends=True)output_lines: list[str] = []in_frontmatter = False@@ -457,23 +657,26 @@ class IntegrationBase(ABC):output_lines.append(line)continueif in_frontmatter:- if stripped in ("scripts:", "agent_scripts:"):+ if stripped == "scripts:":skip_section = Truecontinueif skip_section:if line[0:1].isspace():- continue # skip indented content under scripts/agent_scripts+ continue # skip indented content under scriptsskip_section = Falseoutput_lines.append(line)content = "".join(output_lines)- # 5. Replace {ARGS} and $ARGUMENTS+ # 4. Replace {ARGS} and $ARGUMENTScontent = content.replace("{ARGS}", arg_placeholder)content = content.replace("$ARGUMENTS", arg_placeholder)- # 6. Replace __AGENT__+ # 5. Replace __AGENT__content = content.replace("__AGENT__", agent_name)+ # 6. Replace __CONTEXT_FILE__+ content = content.replace("__CONTEXT_FILE__", context_file)+# 7. Rewrite paths β delegate to the shared implementation in# CommandRegistrar so extension-local paths are preserved and# boundary rules stay consistent across the codebase.@@ -526,6 +729,9 @@ class IntegrationBase(ABC):self.record_file_in_manifest(dst_file, project_root, manifest)created.append(dst_file)+ # Upsert managed context section into the agent context file+ self.upsert_context_section(project_root)+return createddef teardown(@@ -539,9 +745,11 @@ class IntegrationBase(ABC):Delegates to ``manifest.uninstall()`` which only removes fileswhose hash still matches the recorded value (unless *force*).+ Also removes the managed context section from the agent file.Returns ``(removed, skipped)`` file lists."""+ self.remove_context_section(project_root)return manifest.uninstall(project_root, force=force)# -- Convenience helpers for subclasses -------------------------------@@ -579,8 +787,8 @@ class MarkdownIntegration(IntegrationBase):(and optionally ``context_file``). Everything else is inherited.``setup()`` processes command templates (replacing ``{SCRIPT}``,- ``{ARGS}``, ``__AGENT__``, rewriting paths) and installs- integration-specific scripts (``update-context.sh`` / ``.ps1``).+ ``{ARGS}``, ``__AGENT__``, rewriting paths) and upserts the+ managed context section into the agent context file."""def build_exec_args(@@ -638,7 +846,8 @@ class MarkdownIntegration(IntegrationBase):for src_file in templates:raw = src_file.read_text(encoding="utf-8")processed = self.process_template(- raw, self.key, script_type, arg_placeholder+ raw, self.key, script_type, arg_placeholder,+ context_file=self.context_file or "",)dst_name = self.command_filename(src_file.stem)dst_file = self.write_file_and_record(@@ -646,7 +855,9 @@ class MarkdownIntegration(IntegrationBase):)created.append(dst_file)- created.extend(self.install_scripts(project_root, manifest))+ # Upsert managed context section into the agent context file+ self.upsert_context_section(project_root)+return created@@ -841,7 +1052,8 @@ class TomlIntegration(IntegrationBase):raw = src_file.read_text(encoding="utf-8")description = self._extract_description(raw)processed = self.process_template(- raw, self.key, script_type, arg_placeholder+ raw, self.key, script_type, arg_placeholder,+ context_file=self.context_file or "",)_, body = self._split_frontmatter(processed)toml_content = self._render_toml(description, body)@@ -851,7 +1063,9 @@ class TomlIntegration(IntegrationBase):)created.append(dst_file)- created.extend(self.install_scripts(project_root, manifest))+ # Upsert managed context section into the agent context file+ self.upsert_context_section(project_root)+return created@@ -1021,7 +1235,8 @@ class YamlIntegration(IntegrationBase):title = self._human_title(src_file.stem)processed = self.process_template(- raw, self.key, script_type, arg_placeholder+ raw, self.key, script_type, arg_placeholder,+ context_file=self.context_file or "",)_, body = self._split_frontmatter(processed)yaml_content = self._render_yaml(@@ -1033,7 +1248,9 @@ class YamlIntegration(IntegrationBase):)created.append(dst_file)- created.extend(self.install_scripts(project_root, manifest))+ # Upsert managed context section into the agent context file+ self.upsert_context_section(project_root)+return created@@ -1176,7 +1393,8 @@ class SkillsIntegration(IntegrationBase):# Process body through the standard template pipelineprocessed_body = self.process_template(- raw, self.key, script_type, arg_placeholder+ raw, self.key, script_type, arg_placeholder,+ context_file=self.context_file or "",)# Strip the processed frontmatter β we rebuild it for skills.# Preserve leading whitespace in the body to match release ZIP@@ -1220,5 +1438,7 @@ class SkillsIntegration(IntegrationBase):)created.append(dst)- created.extend(self.install_scripts(project_root, manifest))+ # Upsert managed context section into the agent context file+ self.upsert_context_section(project_root)+return createddiff --git a/src/specify_cli/integrations/bob/scripts/update-context.ps1 b/src/specify_cli/integrations/bob/scripts/update-context.ps1deleted file mode 100644index 188860899..000000000--- a/src/specify_cli/integrations/bob/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β IBM Bob integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType bobdiff --git a/src/specify_cli/integrations/bob/scripts/update-context.sh b/src/specify_cli/integrations/bob/scripts/update-context.shdeleted file mode 100755index 0228603fe..000000000--- a/src/specify_cli/integrations/bob/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β IBM Bob integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" bobdiff --git a/src/specify_cli/integrations/claude/scripts/update-context.ps1 b/src/specify_cli/integrations/claude/scripts/update-context.ps1deleted file mode 100644index 837974d47..000000000--- a/src/specify_cli/integrations/claude/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Claude Code integration: create/update CLAUDE.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType claudediff --git a/src/specify_cli/integrations/claude/scripts/update-context.sh b/src/specify_cli/integrations/claude/scripts/update-context.shdeleted file mode 100755index 4b83855a2..000000000--- a/src/specify_cli/integrations/claude/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Claude Code integration: create/update CLAUDE.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" claudediff --git a/src/specify_cli/integrations/codebuddy/scripts/update-context.ps1 b/src/specify_cli/integrations/codebuddy/scripts/update-context.ps1deleted file mode 100644index 0269392c0..000000000--- a/src/specify_cli/integrations/codebuddy/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β CodeBuddy integration: create/update CODEBUDDY.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType codebuddydiff --git a/src/specify_cli/integrations/codebuddy/scripts/update-context.sh b/src/specify_cli/integrations/codebuddy/scripts/update-context.shdeleted file mode 100755index d57ddc356..000000000--- a/src/specify_cli/integrations/codebuddy/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β CodeBuddy integration: create/update CODEBUDDY.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" codebuddydiff --git a/src/specify_cli/integrations/codex/scripts/update-context.ps1 b/src/specify_cli/integrations/codex/scripts/update-context.ps1deleted file mode 100644index d73a5a4d3..000000000--- a/src/specify_cli/integrations/codex/scripts/update-context.ps1+++ /dev/null@@ -1,17 +0,0 @@-# update-context.ps1 β Codex CLI integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.--$ErrorActionPreference = 'Stop'--$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType codexdiff --git a/src/specify_cli/integrations/codex/scripts/update-context.sh b/src/specify_cli/integrations/codex/scripts/update-context.shdeleted file mode 100755index 512d6e91d..000000000--- a/src/specify_cli/integrations/codex/scripts/update-context.sh+++ /dev/null@@ -1,24 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Codex CLI integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.--set -euo pipefail--_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" codexdiff --git a/src/specify_cli/integrations/copilot/__init__.py b/src/specify_cli/integrations/copilot/__init__.pyindex e389138a8..be7fc819f 100644--- a/src/specify_cli/integrations/copilot/__init__.py+++ b/src/specify_cli/integrations/copilot/__init__.py@@ -183,7 +183,10 @@ class CopilotIntegration(IntegrationBase):# 1. Process and write command files as .agent.mdfor src_file in templates:raw = src_file.read_text(encoding="utf-8")- processed = self.process_template(raw, self.key, script_type, arg_placeholder)+ processed = self.process_template(+ raw, self.key, script_type, arg_placeholder,+ context_file=self.context_file or "",+ )dst_name = self.command_filename(src_file.stem)dst_file = self.write_file_and_record(processed, dest / dst_name, project_root, manifest@@ -217,8 +220,8 @@ class CopilotIntegration(IntegrationBase):self.record_file_in_manifest(dst_settings, project_root, manifest)created.append(dst_settings)- # 4. Install integration-specific update-context scripts- created.extend(self.install_scripts(project_root, manifest))+ # 4. Upsert managed context section into the agent context file+ self.upsert_context_section(project_root)return createddiff --git a/src/specify_cli/integrations/copilot/scripts/update-context.ps1 b/src/specify_cli/integrations/copilot/scripts/update-context.ps1deleted file mode 100644index 26e746a78..000000000--- a/src/specify_cli/integrations/copilot/scripts/update-context.ps1+++ /dev/null@@ -1,32 +0,0 @@-# update-context.ps1 β Copilot integration: create/update .github/copilot-instructions.md-#-# This is the copilot-specific implementation that produces the GitHub-# Copilot instructions file. The shared dispatcher reads-# .specify/integration.json and calls this script.-#-# NOTE: This script is not yet active. It will be activated in Stage 7-# when the shared update-agent-context.ps1 replaces its switch statement-# with integration.json-based dispatch. The shared script must also be-# refactored to support SPECKIT_SOURCE_ONLY (guard the Main call) before-# dot-sourcing will work.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--# Invoke shared update-agent-context script as a separate process.-# Dot-sourcing is unsafe until that script guards its Main call.-& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType copilotdiff --git a/src/specify_cli/integrations/copilot/scripts/update-context.sh b/src/specify_cli/integrations/copilot/scripts/update-context.shdeleted file mode 100644index c7f3bc60b..000000000--- a/src/specify_cli/integrations/copilot/scripts/update-context.sh+++ /dev/null@@ -1,37 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Copilot integration: create/update .github/copilot-instructions.md-#-# This is the copilot-specific implementation that produces the GitHub-# Copilot instructions file. The shared dispatcher reads-# .specify/integration.json and calls this script.-#-# NOTE: This script is not yet active. It will be activated in Stage 7-# when the shared update-agent-context.sh replaces its case statement-# with integration.json-based dispatch. The shared script must also be-# refactored to support SPECKIT_SOURCE_ONLY (guard the main logic)-# before sourcing will work.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--# Invoke shared update-agent-context script as a separate process.-# Sourcing is unsafe until that script guards its main logic.-exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" copilotdiff --git a/src/specify_cli/integrations/cursor_agent/scripts/update-context.ps1 b/src/specify_cli/integrations/cursor_agent/scripts/update-context.ps1deleted file mode 100644index 4ce50a487..000000000--- a/src/specify_cli/integrations/cursor_agent/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Cursor integration: create/update .cursor/rules/specify-rules.mdc-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType cursor-agentdiff --git a/src/specify_cli/integrations/cursor_agent/scripts/update-context.sh b/src/specify_cli/integrations/cursor_agent/scripts/update-context.shdeleted file mode 100755index 597ca2289..000000000--- a/src/specify_cli/integrations/cursor_agent/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Cursor integration: create/update .cursor/rules/specify-rules.mdc-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" cursor-agentdiff --git a/src/specify_cli/integrations/forge/__init__.py b/src/specify_cli/integrations/forge/__init__.pyindex e1c4d9da6..a941d4c33 100644--- a/src/specify_cli/integrations/forge/__init__.py+++ b/src/specify_cli/integrations/forge/__init__.py@@ -130,7 +130,10 @@ class ForgeIntegration(MarkdownIntegration):for src_file in templates:raw = src_file.read_text(encoding="utf-8")# Process template with standard MarkdownIntegration logic- processed = self.process_template(raw, self.key, script_type, arg_placeholder)+ processed = self.process_template(+ raw, self.key, script_type, arg_placeholder,+ context_file=self.context_file or "",+ )# FORGE-SPECIFIC: Ensure any remaining $ARGUMENTS placeholders are# converted to {{parameters}}@@ -145,8 +148,8 @@ class ForgeIntegration(MarkdownIntegration):)created.append(dst_file)- # Install integration-specific update-context scripts- created.extend(self.install_scripts(project_root, manifest))+ # Upsert managed context section into the agent context file+ self.upsert_context_section(project_root)return createddiff --git a/src/specify_cli/integrations/forge/scripts/update-context.ps1 b/src/specify_cli/integrations/forge/scripts/update-context.ps1deleted file mode 100644index 474a9c6d0..000000000--- a/src/specify_cli/integrations/forge/scripts/update-context.ps1+++ /dev/null@@ -1,33 +0,0 @@-# update-context.ps1 β Forge integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--$sharedScript = "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1"--# Always delegate to the shared updater; fail clearly if it is unavailable.-if (-not (Test-Path $sharedScript)) {- Write-Error "Error: shared agent context updater not found: $sharedScript"- Write-Error "Forge integration requires support in scripts/powershell/update-agent-context.ps1."- exit 1-}--& $sharedScript -AgentType forge-exit $LASTEXITCODEdiff --git a/src/specify_cli/integrations/forge/scripts/update-context.sh b/src/specify_cli/integrations/forge/scripts/update-context.shdeleted file mode 100755index 2a5c46e1d..000000000--- a/src/specify_cli/integrations/forge/scripts/update-context.sh+++ /dev/null@@ -1,38 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Forge integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--shared_script="$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh"--# Always delegate to the shared updater; fail clearly if it is unavailable.-if [ ! -x "$shared_script" ]; then- echo "Error: shared agent context updater not found or not executable:" >&2- echo " $shared_script" >&2- echo "Forge integration requires support in scripts/bash/update-agent-context.sh." >&2- exit 1-fi--exec "$shared_script" forgediff --git a/src/specify_cli/integrations/gemini/scripts/update-context.ps1 b/src/specify_cli/integrations/gemini/scripts/update-context.ps1deleted file mode 100644index 51c9e0bc8..000000000--- a/src/specify_cli/integrations/gemini/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Gemini CLI integration: create/update GEMINI.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType geminidiff --git a/src/specify_cli/integrations/gemini/scripts/update-context.sh b/src/specify_cli/integrations/gemini/scripts/update-context.shdeleted file mode 100644index c4e5003a5..000000000--- a/src/specify_cli/integrations/gemini/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Gemini CLI integration: create/update GEMINI.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" geminidiff --git a/src/specify_cli/integrations/generic/__init__.py b/src/specify_cli/integrations/generic/__init__.pyindex 4107c4869..fdaee4ed0 100644--- a/src/specify_cli/integrations/generic/__init__.py+++ b/src/specify_cli/integrations/generic/__init__.py@@ -31,7 +31,7 @@ class GenericIntegration(MarkdownIntegration):"args": "$ARGUMENTS","extension": ".md",}- context_file = None+ context_file = "AGENTS.md"@classmethoddef options(cls) -> list[IntegrationOption]:@@ -122,12 +122,17 @@ class GenericIntegration(MarkdownIntegration):for src_file in templates:raw = src_file.read_text(encoding="utf-8")- processed = self.process_template(raw, self.key, script_type, arg_placeholder)+ processed = self.process_template(+ raw, self.key, script_type, arg_placeholder,+ context_file=self.context_file or "",+ )dst_name = self.command_filename(src_file.stem)dst_file = self.write_file_and_record(processed, dest / dst_name, project_root, manifest)created.append(dst_file)- created.extend(self.install_scripts(project_root, manifest))+ # Upsert managed context section into the agent context file+ self.upsert_context_section(project_root)+return createddiff --git a/src/specify_cli/integrations/generic/scripts/update-context.ps1 b/src/specify_cli/integrations/generic/scripts/update-context.ps1deleted file mode 100644index 2e9467f80..000000000--- a/src/specify_cli/integrations/generic/scripts/update-context.ps1+++ /dev/null@@ -1,17 +0,0 @@-# update-context.ps1 β Generic integration: create/update context file-#-# Thin wrapper that delegates to the shared update-agent-context script.--$ErrorActionPreference = 'Stop'--$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType genericdiff --git a/src/specify_cli/integrations/generic/scripts/update-context.sh b/src/specify_cli/integrations/generic/scripts/update-context.shdeleted file mode 100755index d8ad30a7b..000000000--- a/src/specify_cli/integrations/generic/scripts/update-context.sh+++ /dev/null@@ -1,24 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Generic integration: create/update context file-#-# Thin wrapper that delegates to the shared update-agent-context script.--set -euo pipefail--_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" genericdiff --git a/src/specify_cli/integrations/goose/scripts/update-context.ps1 b/src/specify_cli/integrations/goose/scripts/update-context.ps1deleted file mode 100644index eeb31f629..000000000--- a/src/specify_cli/integrations/goose/scripts/update-context.ps1+++ /dev/null@@ -1,33 +0,0 @@-# update-context.ps1 β Goose integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--$sharedScript = "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1"--# Always delegate to the shared updater; fail clearly if it is unavailable.-if (-not (Test-Path $sharedScript)) {- Write-Error "Error: shared agent context updater not found: $sharedScript"- Write-Error "Goose integration requires support in scripts/powershell/update-agent-context.ps1."- exit 1-}--& $sharedScript -AgentType goose-exit $LASTEXITCODEdiff --git a/src/specify_cli/integrations/goose/scripts/update-context.sh b/src/specify_cli/integrations/goose/scripts/update-context.shdeleted file mode 100755index 759ae3045..000000000--- a/src/specify_cli/integrations/goose/scripts/update-context.sh+++ /dev/null@@ -1,38 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Goose integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--shared_script="$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh"--# Always delegate to the shared updater; fail clearly if it is unavailable.-if [ ! -x "$shared_script" ]; then- echo "Error: shared agent context updater not found or not executable:" >&2- echo " $shared_script" >&2- echo "Goose integration requires support in scripts/bash/update-agent-context.sh." >&2- exit 1-fi--exec "$shared_script" goosediff --git a/src/specify_cli/integrations/iflow/scripts/update-context.ps1 b/src/specify_cli/integrations/iflow/scripts/update-context.ps1deleted file mode 100644index b502d4182..000000000--- a/src/specify_cli/integrations/iflow/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β iFlow CLI integration: create/update IFLOW.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType iflowdiff --git a/src/specify_cli/integrations/iflow/scripts/update-context.sh b/src/specify_cli/integrations/iflow/scripts/update-context.shdeleted file mode 100755index 508040207..000000000--- a/src/specify_cli/integrations/iflow/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β iFlow CLI integration: create/update IFLOW.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" iflowdiff --git a/src/specify_cli/integrations/junie/scripts/update-context.ps1 b/src/specify_cli/integrations/junie/scripts/update-context.ps1deleted file mode 100644index 5a3243213..000000000--- a/src/specify_cli/integrations/junie/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Junie integration: create/update .junie/AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType juniediff --git a/src/specify_cli/integrations/junie/scripts/update-context.sh b/src/specify_cli/integrations/junie/scripts/update-context.shdeleted file mode 100755index f4c8ba6c0..000000000--- a/src/specify_cli/integrations/junie/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Junie integration: create/update .junie/AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" juniediff --git a/src/specify_cli/integrations/kilocode/scripts/update-context.ps1 b/src/specify_cli/integrations/kilocode/scripts/update-context.ps1deleted file mode 100644index d87e7ef59..000000000--- a/src/specify_cli/integrations/kilocode/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Kilo Code integration: create/update .kilocode/rules/specify-rules.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType kilocodediff --git a/src/specify_cli/integrations/kilocode/scripts/update-context.sh b/src/specify_cli/integrations/kilocode/scripts/update-context.shdeleted file mode 100755index 132c0403f..000000000--- a/src/specify_cli/integrations/kilocode/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Kilo Code integration: create/update .kilocode/rules/specify-rules.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" kilocodediff --git a/src/specify_cli/integrations/kimi/scripts/update-context.ps1 b/src/specify_cli/integrations/kimi/scripts/update-context.ps1deleted file mode 100644index aa6678d05..000000000--- a/src/specify_cli/integrations/kimi/scripts/update-context.ps1+++ /dev/null@@ -1,17 +0,0 @@-# update-context.ps1 β Kimi Code integration: create/update KIMI.md-#-# Thin wrapper that delegates to the shared update-agent-context script.--$ErrorActionPreference = 'Stop'--$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType kimidiff --git a/src/specify_cli/integrations/kimi/scripts/update-context.sh b/src/specify_cli/integrations/kimi/scripts/update-context.shdeleted file mode 100755index 2f81bc2a4..000000000--- a/src/specify_cli/integrations/kimi/scripts/update-context.sh+++ /dev/null@@ -1,24 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Kimi Code integration: create/update KIMI.md-#-# Thin wrapper that delegates to the shared update-agent-context script.--set -euo pipefail--_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" kimidiff --git a/src/specify_cli/integrations/kiro_cli/scripts/update-context.ps1 b/src/specify_cli/integrations/kiro_cli/scripts/update-context.ps1deleted file mode 100644index 7dd2b35fb..000000000--- a/src/specify_cli/integrations/kiro_cli/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Kiro CLI integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType kiro-clidiff --git a/src/specify_cli/integrations/kiro_cli/scripts/update-context.sh b/src/specify_cli/integrations/kiro_cli/scripts/update-context.shdeleted file mode 100755index fa258edc7..000000000--- a/src/specify_cli/integrations/kiro_cli/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Kiro CLI integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" kiro-clidiff --git a/src/specify_cli/integrations/opencode/scripts/update-context.ps1 b/src/specify_cli/integrations/opencode/scripts/update-context.ps1deleted file mode 100644index 4bba02b45..000000000--- a/src/specify_cli/integrations/opencode/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β opencode integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType opencodediff --git a/src/specify_cli/integrations/opencode/scripts/update-context.sh b/src/specify_cli/integrations/opencode/scripts/update-context.shdeleted file mode 100755index 24c7e6025..000000000--- a/src/specify_cli/integrations/opencode/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β opencode integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" opencodediff --git a/src/specify_cli/integrations/pi/scripts/update-context.ps1 b/src/specify_cli/integrations/pi/scripts/update-context.ps1deleted file mode 100644index 6362118a5..000000000--- a/src/specify_cli/integrations/pi/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Pi Coding Agent integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType pidiff --git a/src/specify_cli/integrations/pi/scripts/update-context.sh b/src/specify_cli/integrations/pi/scripts/update-context.shdeleted file mode 100755index 1ad84c95a..000000000--- a/src/specify_cli/integrations/pi/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Pi Coding Agent integration: create/update AGENTS.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" pidiff --git a/src/specify_cli/integrations/qodercli/scripts/update-context.ps1 b/src/specify_cli/integrations/qodercli/scripts/update-context.ps1deleted file mode 100644index 1fa007a16..000000000--- a/src/specify_cli/integrations/qodercli/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Qoder CLI integration: create/update QODER.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType qoderclidiff --git a/src/specify_cli/integrations/qodercli/scripts/update-context.sh b/src/specify_cli/integrations/qodercli/scripts/update-context.shdeleted file mode 100755index d371ad795..000000000--- a/src/specify_cli/integrations/qodercli/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Qoder CLI integration: create/update QODER.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" qoderclidiff --git a/src/specify_cli/integrations/qwen/scripts/update-context.ps1 b/src/specify_cli/integrations/qwen/scripts/update-context.ps1deleted file mode 100644index 24e4c90fa..000000000--- a/src/specify_cli/integrations/qwen/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Qwen Code integration: create/update QWEN.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType qwendiff --git a/src/specify_cli/integrations/qwen/scripts/update-context.sh b/src/specify_cli/integrations/qwen/scripts/update-context.shdeleted file mode 100755index d1c62eb16..000000000--- a/src/specify_cli/integrations/qwen/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Qwen Code integration: create/update QWEN.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" qwendiff --git a/src/specify_cli/integrations/roo/scripts/update-context.ps1 b/src/specify_cli/integrations/roo/scripts/update-context.ps1deleted file mode 100644index d1dec923e..000000000--- a/src/specify_cli/integrations/roo/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Roo Code integration: create/update .roo/rules/specify-rules.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType roodiff --git a/src/specify_cli/integrations/roo/scripts/update-context.sh b/src/specify_cli/integrations/roo/scripts/update-context.shdeleted file mode 100755index 8fe255cb1..000000000--- a/src/specify_cli/integrations/roo/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Roo Code integration: create/update .roo/rules/specify-rules.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" roodiff --git a/src/specify_cli/integrations/shai/scripts/update-context.ps1 b/src/specify_cli/integrations/shai/scripts/update-context.ps1deleted file mode 100644index 2c621c76a..000000000--- a/src/specify_cli/integrations/shai/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β SHAI integration: create/update SHAI.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType shaidiff --git a/src/specify_cli/integrations/shai/scripts/update-context.sh b/src/specify_cli/integrations/shai/scripts/update-context.shdeleted file mode 100755index 093b9d1f7..000000000--- a/src/specify_cli/integrations/shai/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β SHAI integration: create/update SHAI.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" shaidiff --git a/src/specify_cli/integrations/tabnine/scripts/update-context.ps1 b/src/specify_cli/integrations/tabnine/scripts/update-context.ps1deleted file mode 100644index 0ffb3a164..000000000--- a/src/specify_cli/integrations/tabnine/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Tabnine CLI integration: create/update TABNINE.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType tabninediff --git a/src/specify_cli/integrations/tabnine/scripts/update-context.sh b/src/specify_cli/integrations/tabnine/scripts/update-context.shdeleted file mode 100644index fe5050b6e..000000000--- a/src/specify_cli/integrations/tabnine/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Tabnine CLI integration: create/update TABNINE.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" tabninediff --git a/src/specify_cli/integrations/trae/scripts/update-context.ps1 b/src/specify_cli/integrations/trae/scripts/update-context.ps1deleted file mode 100644index ae9a3d1cd..000000000--- a/src/specify_cli/integrations/trae/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Trae integration: create/update .trae/rules/project_rules.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType traediff --git a/src/specify_cli/integrations/trae/scripts/update-context.sh b/src/specify_cli/integrations/trae/scripts/update-context.shdeleted file mode 100755index 32e5c16b2..000000000--- a/src/specify_cli/integrations/trae/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Trae integration: create/update .trae/rules/project_rules.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" traediff --git a/src/specify_cli/integrations/vibe/scripts/update-context.ps1 b/src/specify_cli/integrations/vibe/scripts/update-context.ps1deleted file mode 100644index d82ce3389..000000000--- a/src/specify_cli/integrations/vibe/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Mistral Vibe integration: create/update .vibe/agents/specify-agents.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType vibediff --git a/src/specify_cli/integrations/vibe/scripts/update-context.sh b/src/specify_cli/integrations/vibe/scripts/update-context.shdeleted file mode 100755index f924cdb89..000000000--- a/src/specify_cli/integrations/vibe/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Mistral Vibe integration: create/update .vibe/agents/specify-agents.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" vibediff --git a/src/specify_cli/integrations/windsurf/scripts/update-context.ps1 b/src/specify_cli/integrations/windsurf/scripts/update-context.ps1deleted file mode 100644index b5fe1d0c0..000000000--- a/src/specify_cli/integrations/windsurf/scripts/update-context.ps1+++ /dev/null@@ -1,23 +0,0 @@-# update-context.ps1 β Windsurf integration: create/update .windsurf/rules/specify-rules.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--$ErrorActionPreference = 'Stop'--# Derive repo root from script location (walks up to find .specify/)-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition-$repoRoot = try { git rev-parse --show-toplevel 2>$null } catch { $null }-# If git did not return a repo root, or the git root does not contain .specify,-# fall back to walking up from the script directory to find the initialized project root.-if (-not $repoRoot -or -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = $scriptDir- $fsRoot = [System.IO.Path]::GetPathRoot($repoRoot)- while ($repoRoot -and $repoRoot -ne $fsRoot -and -not (Test-Path (Join-Path $repoRoot '.specify'))) {- $repoRoot = Split-Path -Parent $repoRoot- }-}--& "$repoRoot/.specify/scripts/powershell/update-agent-context.ps1" -AgentType windsurfdiff --git a/src/specify_cli/integrations/windsurf/scripts/update-context.sh b/src/specify_cli/integrations/windsurf/scripts/update-context.shdeleted file mode 100755index b9a78d320..000000000--- a/src/specify_cli/integrations/windsurf/scripts/update-context.sh+++ /dev/null@@ -1,28 +0,0 @@-#!/usr/bin/env bash-# update-context.sh β Windsurf integration: create/update .windsurf/rules/specify-rules.md-#-# Thin wrapper that delegates to the shared update-agent-context script.-# Activated in Stage 7 when the shared script uses integration.json dispatch.-#-# Until then, this delegates to the shared script as a subprocess.--set -euo pipefail--# Derive repo root from script location (walks up to find .specify/)-_script_dir="$(cd "$(dirname "$0")" && pwd)"-_root="$_script_dir"-while [ "$_root" != "/" ] && [ ! -d "$_root/.specify" ]; do _root="$(dirname "$_root")"; done-if [ -z "${REPO_ROOT:-}" ]; then- if [ -d "$_root/.specify" ]; then- REPO_ROOT="$_root"- else- git_root="$(git rev-parse --show-toplevel 2>/dev/null || true)"- if [ -n "$git_root" ] && [ -d "$git_root/.specify" ]; then- REPO_ROOT="$git_root"- else- REPO_ROOT="$_root"- fi- fi-fi--exec "$REPO_ROOT/.specify/scripts/bash/update-agent-context.sh" windsurfdiff --git a/templates/agent-file-template.md b/templates/agent-file-template.mddeleted file mode 100644index 4cc7fd667..000000000--- a/templates/agent-file-template.md+++ /dev/null@@ -1,28 +0,0 @@-# [PROJECT NAME] Development Guidelines--Auto-generated from all feature plans. Last updated: [DATE]--## Active Technologies--[EXTRACTED FROM ALL PLAN.MD FILES]--## Project Structure--```text-[ACTUAL STRUCTURE FROM PLANS]-```--## Commands--[ONLY COMMANDS FOR ACTIVE TECHNOLOGIES]--## Code Style--[LANGUAGE-SPECIFIC, ONLY FOR LANGUAGES IN USE]--## Recent Changes--[LAST 3 FEATURES AND WHAT THEY ADDED]--<!-- MANUAL ADDITIONS START -->-<!-- MANUAL ADDITIONS END -->diff --git a/templates/commands/plan.md b/templates/commands/plan.mdindex 4f1e9ed29..04db94ffa 100644--- a/templates/commands/plan.md+++ b/templates/commands/plan.md@@ -11,9 +11,6 @@ handoffs:scripts:sh: scripts/bash/setup-plan.sh --jsonps: scripts/powershell/setup-plan.ps1 -Json-agent_scripts:- sh: scripts/bash/update-agent-context.sh __AGENT__- ps: scripts/powershell/update-agent-context.ps1 -AgentType __AGENT__---## User Input@@ -145,15 +142,11 @@ You **MUST** consider the user input before proceeding (if not empty).- Skip if project is purely internal (build scripts, one-off tools, etc.)3. **Agent context update**:- - Run `{AGENT_SCRIPT}`- - These scripts detect which AI agent is in use- - Update the appropriate agent-specific context file- - Add only new technology from current plan- - Preserve manual additions between markers+ - Update the plan reference between the `<!-- SPECKIT START -->` and `<!-- SPECKIT END -->` markers in `__CONTEXT_FILE__` to point to the plan file created in step 1 (the IMPL_PLAN path)-**Output**: data-model.md, /contracts/*, quickstart.md, agent-specific file+**Output**: data-model.md, /contracts/*, quickstart.md, updated agent context file## Key rules-- Use absolute paths+- Use absolute paths for filesystem operations; use project-relative paths for references in documentation and agent context files- ERROR on gate failures or unresolved clarificationsdiff --git a/tests/integrations/test_cli.py b/tests/integrations/test_cli.pyindex bd73ccd66..04a91682e 100644--- a/tests/integrations/test_cli.py+++ b/tests/integrations/test_cli.py@@ -56,14 +56,19 @@ class TestInitIntegrationFlag:data = json.loads((project / ".specify" / "integration.json").read_text(encoding="utf-8"))assert data["integration"] == "copilot"- assert "scripts" in data- assert "update-context" in data["scripts"]opts = json.loads((project / ".specify" / "init-options.json").read_text(encoding="utf-8"))assert opts["integration"] == "copilot"+ assert opts["context_file"] == ".github/copilot-instructions.md"assert (project / ".specify" / "integrations" / "copilot.manifest.json").exists()- assert (project / ".specify" / "integrations" / "copilot" / "scripts" / "update-context.sh").exists()++ # Context section should be upserted into the copilot instructions file+ ctx_file = project / ".github" / "copilot-instructions.md"+ assert ctx_file.exists()+ ctx_content = ctx_file.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" in ctx_content+ assert "<!-- SPECKIT END -->" in ctx_contentshared_manifest = project / ".specify" / "integrations" / "speckit.manifest.json"assert shared_manifest.exists()diff --git a/tests/integrations/test_integration_base_markdown.py b/tests/integrations/test_integration_base_markdown.pyindex 3700d35de..f22bb298b 100644--- a/tests/integrations/test_integration_base_markdown.py+++ b/tests/integrations/test_integration_base_markdown.py@@ -99,7 +99,23 @@ class MarkdownIntegrationTests:assert "__AGENT__" not in content, f"{f.name} has unprocessed __AGENT__"assert "{ARGS}" not in content, f"{f.name} has unprocessed {{ARGS}}"assert "\nscripts:\n" not in content, f"{f.name} has unstripped scripts: block"- assert "\nagent_scripts:\n" not in content, f"{f.name} has unstripped agent_scripts: block"++ def test_plan_references_correct_context_file(self, tmp_path):+ """The generated plan command must reference this integration's context file."""+ i = get_integration(self.KEY)+ if not i.context_file:+ return+ m = IntegrationManifest(self.KEY, tmp_path)+ i.setup(tmp_path, m)+ plan_file = i.commands_dest(tmp_path) / i.command_filename("plan")+ assert plan_file.exists(), f"Plan file {plan_file} not created"+ content = plan_file.read_text(encoding="utf-8")+ assert i.context_file in content, (+ f"Plan command should reference {i.context_file!r} but it was not found in {plan_file.name}"+ )+ assert "__CONTEXT_FILE__" not in content, (+ f"Plan command has unprocessed __CONTEXT_FILE__ placeholder in {plan_file.name}"+ )def test_all_files_tracked_in_manifest(self, tmp_path):i = get_integration(self.KEY)@@ -132,30 +148,35 @@ class MarkdownIntegrationTests:assert modified_file.exists()assert modified_file in skipped- # -- Scripts ------------------------------------------------------------ def test_setup_installs_update_context_scripts(self, tmp_path):- i = get_integration(self.KEY)- m = IntegrationManifest(self.KEY, tmp_path)- created = i.setup(tmp_path, m)- scripts_dir = tmp_path / ".specify" / "integrations" / self.KEY / "scripts"- assert scripts_dir.is_dir(), f"Scripts directory not created for {self.KEY}"- assert (scripts_dir / "update-context.sh").exists()- assert (scripts_dir / "update-context.ps1").exists()+ # -- Context section ---------------------------------------------------- def test_scripts_tracked_in_manifest(self, tmp_path):+ def test_setup_upserts_context_section(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)i.setup(tmp_path, m)- script_rels = [k for k in m.files if "update-context" in k]- assert len(script_rels) >= 2-- def test_sh_script_is_executable(self, tmp_path):+ if i.context_file:+ ctx_path = tmp_path / i.context_file+ assert ctx_path.exists(), f"Context file {i.context_file} not created for {self.KEY}"+ content = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" in content+ assert "<!-- SPECKIT END -->" in content+ assert "read the current plan" in content++ def test_teardown_removes_context_section(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)i.setup(tmp_path, m)- sh = tmp_path / ".specify" / "integrations" / self.KEY / "scripts" / "update-context.sh"- assert os.access(sh, os.X_OK)+ m.save()+ if i.context_file:+ ctx_path = tmp_path / i.context_file+ # Add user content around the section+ content = ctx_path.read_text(encoding="utf-8")+ ctx_path.write_text("# My Rules\n\n" + content + "\n# Footer\n", encoding="utf-8")+ i.teardown(tmp_path, m)+ remaining = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" not in remaining+ assert "<!-- SPECKIT END -->" not in remaining+ assert "# My Rules" in remaining# -- CLI auto-promote -------------------------------------------------@@ -203,6 +224,30 @@ class MarkdownIntegrationTests:commands = sorted(cmd_dir.glob("speckit.*"))assert len(commands) > 0, f"No command files in {cmd_dir}"+ def test_init_options_includes_context_file(self, tmp_path):+ """init-options.json must include context_file for the active integration."""+ import json+ from typer.testing import CliRunner+ from specify_cli import app++ project = tmp_path / f"opts-{self.KEY}"+ project.mkdir()+ old_cwd = os.getcwd()+ try:+ os.chdir(project)+ result = CliRunner().invoke(app, [+ "init", "--here", "--integration", self.KEY, "--script", "sh",+ "--no-git", "--ignore-agent-tools",+ ], catch_exceptions=False)+ finally:+ os.chdir(old_cwd)+ assert result.exit_code == 0+ opts = json.loads((project / ".specify" / "init-options.json").read_text())+ i = get_integration(self.KEY)+ assert opts.get("context_file") == i.context_file, (+ f"Expected context_file={i.context_file!r}, got {opts.get('context_file')!r}"+ )+# -- Complete file inventory ------------------------------------------COMMAND_STEMS = [@@ -220,10 +265,6 @@ class MarkdownIntegrationTests:for stem in self.COMMAND_STEMS:files.append(f"{cmd_dir}/speckit.{stem}.md")- # Integration scripts- files.append(f".specify/integrations/{self.KEY}/scripts/update-context.ps1")- files.append(f".specify/integrations/{self.KEY}/scripts/update-context.sh")-# Framework filesfiles.append(f".specify/integration.json")files.append(f".specify/init-options.json")@@ -232,14 +273,14 @@ class MarkdownIntegrationTests:if script_variant == "sh":for name in ["check-prerequisites.sh", "common.sh", "create-new-feature.sh",- "setup-plan.sh", "update-agent-context.sh"]:+ "setup-plan.sh"]:files.append(f".specify/scripts/bash/{name}")else:for name in ["check-prerequisites.ps1", "common.ps1", "create-new-feature.ps1",- "setup-plan.ps1", "update-agent-context.ps1"]:+ "setup-plan.ps1"]:files.append(f".specify/scripts/powershell/{name}")- for name in ["agent-file-template.md", "checklist-template.md",+ for name in ["checklist-template.md","constitution-template.md", "plan-template.md","spec-template.md", "tasks-template.md"]:files.append(f".specify/templates/{name}")@@ -248,6 +289,11 @@ class MarkdownIntegrationTests:# Bundled workflowfiles.append(".specify/workflows/speckit/workflow.yml")files.append(".specify/workflows/workflow-registry.json")++ # Agent context file (if set)+ if i.context_file:+ files.append(i.context_file)+return sorted(files)def test_complete_file_inventory_sh(self, tmp_path):diff --git a/tests/integrations/test_integration_base_skills.py b/tests/integrations/test_integration_base_skills.pyindex 72d32278b..c8c152a84 100644--- a/tests/integrations/test_integration_base_skills.py+++ b/tests/integrations/test_integration_base_skills.py@@ -173,6 +173,23 @@ class SkillsIntegrationTests:body = parts[2].strip() if len(parts) >= 3 else ""assert len(body) > 0, f"{f} has empty body"+ def test_plan_references_correct_context_file(self, tmp_path):+ """The generated plan skill must reference this integration's context file."""+ i = get_integration(self.KEY)+ if not i.context_file:+ return+ m = IntegrationManifest(self.KEY, tmp_path)+ i.setup(tmp_path, m)+ plan_file = i.skills_dest(tmp_path) / "speckit-plan" / "SKILL.md"+ assert plan_file.exists(), f"Plan skill {plan_file} not created"+ content = plan_file.read_text(encoding="utf-8")+ assert i.context_file in content, (+ f"Plan skill should reference {i.context_file!r} but it was not found"+ )+ assert "__CONTEXT_FILE__" not in content, (+ "Plan skill has unprocessed __CONTEXT_FILE__ placeholder"+ )+def test_all_files_tracked_in_manifest(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)@@ -217,30 +234,34 @@ class SkillsIntegrationTests:assert (foreign_dir / "SKILL.md").exists(), "Foreign skill was removed"- # -- Scripts ----------------------------------------------------------+ # -- Context section ---------------------------------------------------- def test_setup_installs_update_context_scripts(self, tmp_path):+ def test_setup_upserts_context_section(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)i.setup(tmp_path, m)- scripts_dir = tmp_path / ".specify" / "integrations" / self.KEY / "scripts"- assert scripts_dir.is_dir(), f"Scripts directory not created for {self.KEY}"- assert (scripts_dir / "update-context.sh").exists()- assert (scripts_dir / "update-context.ps1").exists()-- def test_scripts_tracked_in_manifest(self, tmp_path):+ if i.context_file:+ ctx_path = tmp_path / i.context_file+ assert ctx_path.exists(), f"Context file {i.context_file} not created for {self.KEY}"+ content = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" in content+ assert "<!-- SPECKIT END -->" in content+ assert "read the current plan" in content++ def test_teardown_removes_context_section(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)i.setup(tmp_path, m)- script_rels = [k for k in m.files if "update-context" in k]- assert len(script_rels) >= 2-- def test_sh_script_is_executable(self, tmp_path):- i = get_integration(self.KEY)- m = IntegrationManifest(self.KEY, tmp_path)- i.setup(tmp_path, m)- sh = tmp_path / ".specify" / "integrations" / self.KEY / "scripts" / "update-context.sh"- assert os.access(sh, os.X_OK)+ m.save()+ if i.context_file:+ ctx_path = tmp_path / i.context_file+ content = ctx_path.read_text(encoding="utf-8")+ ctx_path.write_text("# My Rules\n\n" + content + "\n# Footer\n", encoding="utf-8")+ i.teardown(tmp_path, m)+ remaining = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" not in remaining+ assert "<!-- SPECKIT END -->" not in remaining+ assert "# My Rules" in remaining# -- CLI auto-promote -------------------------------------------------@@ -286,6 +307,30 @@ class SkillsIntegrationTests:skills_dir = i.skills_dest(project)assert skills_dir.is_dir(), f"Skills directory {skills_dir} not created"+ def test_init_options_includes_context_file(self, tmp_path):+ """init-options.json must include context_file for the active integration."""+ import json+ from typer.testing import CliRunner+ from specify_cli import app++ project = tmp_path / f"opts-{self.KEY}"+ project.mkdir()+ old_cwd = os.getcwd()+ try:+ os.chdir(project)+ result = CliRunner().invoke(app, [+ "init", "--here", "--integration", self.KEY, "--script", "sh",+ "--no-git", "--ignore-agent-tools",+ ], catch_exceptions=False)+ finally:+ os.chdir(old_cwd)+ assert result.exit_code == 0+ opts = json.loads((project / ".specify" / "init-options.json").read_text())+ i = get_integration(self.KEY)+ assert opts.get("context_file") == i.context_file, (+ f"Expected context_file={i.context_file!r}, got {opts.get('context_file')!r}"+ )+# -- IntegrationOption ------------------------------------------------def test_options_include_skills_flag(self):@@ -316,8 +361,6 @@ class SkillsIntegrationTests:".specify/init-options.json",".specify/integration.json",f".specify/integrations/{self.KEY}.manifest.json",- f".specify/integrations/{self.KEY}/scripts/update-context.ps1",- f".specify/integrations/{self.KEY}/scripts/update-context.sh",".specify/integrations/speckit.manifest.json",".specify/memory/constitution.md",]@@ -328,7 +371,6 @@ class SkillsIntegrationTests:".specify/scripts/bash/common.sh",".specify/scripts/bash/create-new-feature.sh",".specify/scripts/bash/setup-plan.sh",- ".specify/scripts/bash/update-agent-context.sh",]else:files += [@@ -336,11 +378,9 @@ class SkillsIntegrationTests:".specify/scripts/powershell/common.ps1",".specify/scripts/powershell/create-new-feature.ps1",".specify/scripts/powershell/setup-plan.ps1",- ".specify/scripts/powershell/update-agent-context.ps1",]# Templatesfiles += [- ".specify/templates/agent-file-template.md",".specify/templates/checklist-template.md",".specify/templates/constitution-template.md",".specify/templates/plan-template.md",@@ -352,6 +392,9 @@ class SkillsIntegrationTests:".specify/workflows/speckit/workflow.yml",".specify/workflows/workflow-registry.json",]+ # Agent context file (if set)+ if i.context_file:+ files.append(i.context_file)return sorted(files)def test_complete_file_inventory_sh(self, tmp_path):diff --git a/tests/integrations/test_integration_base_toml.py b/tests/integrations/test_integration_base_toml.pyindex e80f9abc1..ca66b2123 100644--- a/tests/integrations/test_integration_base_toml.py+++ b/tests/integrations/test_integration_base_toml.py@@ -310,6 +310,23 @@ class TomlIntegrationTests:raise AssertionError(f"{f.name} is not valid TOML: {exc}") from excassert "prompt" in parsed, f"{f.name} parsed TOML has no 'prompt' key"+ def test_plan_references_correct_context_file(self, tmp_path):+ """The generated plan command must reference this integration's context file."""+ i = get_integration(self.KEY)+ if not i.context_file:+ return+ m = IntegrationManifest(self.KEY, tmp_path)+ i.setup(tmp_path, m)+ plan_file = i.commands_dest(tmp_path) / i.command_filename("plan")+ assert plan_file.exists(), f"Plan file {plan_file} not created"+ content = plan_file.read_text(encoding="utf-8")+ assert i.context_file in content, (+ f"Plan command should reference {i.context_file!r} but it was not found in {plan_file.name}"+ )+ assert "__CONTEXT_FILE__" not in content, (+ f"Plan command has unprocessed __CONTEXT_FILE__ placeholder in {plan_file.name}"+ )+def test_all_files_tracked_in_manifest(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)@@ -341,37 +358,34 @@ class TomlIntegrationTests:assert modified_file.exists()assert modified_file in skipped- # -- Scripts ------------------------------------------------------------ def test_setup_installs_update_context_scripts(self, tmp_path):- i = get_integration(self.KEY)- m = IntegrationManifest(self.KEY, tmp_path)- created = i.setup(tmp_path, m)- scripts_dir = tmp_path / ".specify" / "integrations" / self.KEY / "scripts"- assert scripts_dir.is_dir(), f"Scripts directory not created for {self.KEY}"- assert (scripts_dir / "update-context.sh").exists()- assert (scripts_dir / "update-context.ps1").exists()+ # -- Context section ---------------------------------------------------- def test_scripts_tracked_in_manifest(self, tmp_path):+ def test_setup_upserts_context_section(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)i.setup(tmp_path, m)- script_rels = [k for k in m.files if "update-context" in k]- assert len(script_rels) >= 2-- def test_sh_script_is_executable(self, tmp_path):+ if i.context_file:+ ctx_path = tmp_path / i.context_file+ assert ctx_path.exists(), f"Context file {i.context_file} not created for {self.KEY}"+ content = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" in content+ assert "<!-- SPECKIT END -->" in content+ assert "read the current plan" in content++ def test_teardown_removes_context_section(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)i.setup(tmp_path, m)- sh = (- tmp_path- / ".specify"- / "integrations"- / self.KEY- / "scripts"- / "update-context.sh"- )- assert os.access(sh, os.X_OK)+ m.save()+ if i.context_file:+ ctx_path = tmp_path / i.context_file+ content = ctx_path.read_text(encoding="utf-8")+ ctx_path.write_text("# My Rules\n\n" + content + "\n# Footer\n", encoding="utf-8")+ i.teardown(tmp_path, m)+ remaining = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" not in remaining+ assert "<!-- SPECKIT END -->" not in remaining+ assert "# My Rules" in remaining# -- CLI auto-promote -------------------------------------------------@@ -441,6 +455,30 @@ class TomlIntegrationTests:commands = sorted(cmd_dir.glob("speckit.*.toml"))assert len(commands) > 0, f"No command files in {cmd_dir}"+ def test_init_options_includes_context_file(self, tmp_path):+ """init-options.json must include context_file for the active integration."""+ import json+ from typer.testing import CliRunner+ from specify_cli import app++ project = tmp_path / f"opts-{self.KEY}"+ project.mkdir()+ old_cwd = os.getcwd()+ try:+ os.chdir(project)+ result = CliRunner().invoke(app, [+ "init", "--here", "--integration", self.KEY, "--script", "sh",+ "--no-git", "--ignore-agent-tools",+ ], catch_exceptions=False)+ finally:+ os.chdir(old_cwd)+ assert result.exit_code == 0+ opts = json.loads((project / ".specify" / "init-options.json").read_text())+ i = get_integration(self.KEY)+ assert opts.get("context_file") == i.context_file, (+ f"Expected context_file={i.context_file!r}, got {opts.get('context_file')!r}"+ )+# -- Complete file inventory ------------------------------------------COMMAND_STEMS = [@@ -465,10 +503,6 @@ class TomlIntegrationTests:for stem in self.COMMAND_STEMS:files.append(f"{cmd_dir}/speckit.{stem}.toml")- # Integration scripts- files.append(f".specify/integrations/{self.KEY}/scripts/update-context.ps1")- files.append(f".specify/integrations/{self.KEY}/scripts/update-context.sh")-# Framework filesfiles.append(".specify/integration.json")files.append(".specify/init-options.json")@@ -481,7 +515,6 @@ class TomlIntegrationTests:"common.sh","create-new-feature.sh","setup-plan.sh",- "update-agent-context.sh",]:files.append(f".specify/scripts/bash/{name}")else:@@ -490,12 +523,10 @@ class TomlIntegrationTests:"common.ps1","create-new-feature.ps1","setup-plan.ps1",- "update-agent-context.ps1",]:files.append(f".specify/scripts/powershell/{name}")for name in [- "agent-file-template.md","checklist-template.md","constitution-template.md","plan-template.md",@@ -508,6 +539,11 @@ class TomlIntegrationTests:# Bundled workflowfiles.append(".specify/workflows/speckit/workflow.yml")files.append(".specify/workflows/workflow-registry.json")++ # Agent context file (if set)+ if i.context_file:+ files.append(i.context_file)+return sorted(files)def test_complete_file_inventory_sh(self, tmp_path):diff --git a/tests/integrations/test_integration_base_yaml.py b/tests/integrations/test_integration_base_yaml.pyindex e4c31b3c8..08f088576 100644--- a/tests/integrations/test_integration_base_yaml.py+++ b/tests/integrations/test_integration_base_yaml.py@@ -189,6 +189,23 @@ class YamlIntegrationTests:assert "scripts:" not in parsed["prompt"]assert "---" not in parsed["prompt"]+ def test_plan_references_correct_context_file(self, tmp_path):+ """The generated plan command must reference this integration's context file."""+ i = get_integration(self.KEY)+ if not i.context_file:+ return+ m = IntegrationManifest(self.KEY, tmp_path)+ i.setup(tmp_path, m)+ plan_file = i.commands_dest(tmp_path) / i.command_filename("plan")+ assert plan_file.exists(), f"Plan file {plan_file} not created"+ content = plan_file.read_text(encoding="utf-8")+ assert i.context_file in content, (+ f"Plan command should reference {i.context_file!r} but it was not found in {plan_file.name}"+ )+ assert "__CONTEXT_FILE__" not in content, (+ f"Plan command has unprocessed __CONTEXT_FILE__ placeholder in {plan_file.name}"+ )+def test_all_files_tracked_in_manifest(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)@@ -220,37 +237,34 @@ class YamlIntegrationTests:assert modified_file.exists()assert modified_file in skipped- # -- Scripts ------------------------------------------------------------ def test_setup_installs_update_context_scripts(self, tmp_path):- i = get_integration(self.KEY)- m = IntegrationManifest(self.KEY, tmp_path)- created = i.setup(tmp_path, m)- scripts_dir = tmp_path / ".specify" / "integrations" / self.KEY / "scripts"- assert scripts_dir.is_dir(), f"Scripts directory not created for {self.KEY}"- assert (scripts_dir / "update-context.sh").exists()- assert (scripts_dir / "update-context.ps1").exists()+ # -- Context section ---------------------------------------------------- def test_scripts_tracked_in_manifest(self, tmp_path):+ def test_setup_upserts_context_section(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)i.setup(tmp_path, m)- script_rels = [k for k in m.files if "update-context" in k]- assert len(script_rels) >= 2-- def test_sh_script_is_executable(self, tmp_path):+ if i.context_file:+ ctx_path = tmp_path / i.context_file+ assert ctx_path.exists(), f"Context file {i.context_file} not created for {self.KEY}"+ content = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" in content+ assert "<!-- SPECKIT END -->" in content+ assert "read the current plan" in content++ def test_teardown_removes_context_section(self, tmp_path):i = get_integration(self.KEY)m = IntegrationManifest(self.KEY, tmp_path)i.setup(tmp_path, m)- sh = (- tmp_path- / ".specify"- / "integrations"- / self.KEY- / "scripts"- / "update-context.sh"- )- assert os.access(sh, os.X_OK)+ m.save()+ if i.context_file:+ ctx_path = tmp_path / i.context_file+ content = ctx_path.read_text(encoding="utf-8")+ ctx_path.write_text("# My Rules\n\n" + content + "\n# Footer\n", encoding="utf-8")+ i.teardown(tmp_path, m)+ remaining = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" not in remaining+ assert "<!-- SPECKIT END -->" not in remaining+ assert "# My Rules" in remaining# -- CLI auto-promote -------------------------------------------------@@ -320,6 +334,30 @@ class YamlIntegrationTests:commands = sorted(cmd_dir.glob("speckit.*.yaml"))assert len(commands) > 0, f"No command files in {cmd_dir}"+ def test_init_options_includes_context_file(self, tmp_path):+ """init-options.json must include context_file for the active integration."""+ import json+ from typer.testing import CliRunner+ from specify_cli import app++ project = tmp_path / f"opts-{self.KEY}"+ project.mkdir()+ old_cwd = os.getcwd()+ try:+ os.chdir(project)+ result = CliRunner().invoke(app, [+ "init", "--here", "--integration", self.KEY, "--script", "sh",+ "--no-git", "--ignore-agent-tools",+ ], catch_exceptions=False)+ finally:+ os.chdir(old_cwd)+ assert result.exit_code == 0+ opts = json.loads((project / ".specify" / "init-options.json").read_text())+ i = get_integration(self.KEY)+ assert opts.get("context_file") == i.context_file, (+ f"Expected context_file={i.context_file!r}, got {opts.get('context_file')!r}"+ )+# -- Complete file inventory ------------------------------------------COMMAND_STEMS = [@@ -344,10 +382,6 @@ class YamlIntegrationTests:for stem in self.COMMAND_STEMS:files.append(f"{cmd_dir}/speckit.{stem}.yaml")- # Integration scripts- files.append(f".specify/integrations/{self.KEY}/scripts/update-context.ps1")- files.append(f".specify/integrations/{self.KEY}/scripts/update-context.sh")-# Framework filesfiles.append(".specify/integration.json")files.append(".specify/init-options.json")@@ -360,7 +394,6 @@ class YamlIntegrationTests:"common.sh","create-new-feature.sh","setup-plan.sh",- "update-agent-context.sh",]:files.append(f".specify/scripts/bash/{name}")else:@@ -369,12 +402,10 @@ class YamlIntegrationTests:"common.ps1","create-new-feature.ps1","setup-plan.ps1",- "update-agent-context.ps1",]:files.append(f".specify/scripts/powershell/{name}")for name in [- "agent-file-template.md","checklist-template.md","constitution-template.md","plan-template.md",@@ -387,6 +418,11 @@ class YamlIntegrationTests:# Bundled workflowfiles.append(".specify/workflows/speckit/workflow.yml")files.append(".specify/workflows/workflow-registry.json")++ # Agent context file (if set)+ if i.context_file:+ files.append(i.context_file)+return sorted(files)def test_complete_file_inventory_sh(self, tmp_path):diff --git a/tests/integrations/test_integration_catalog.py b/tests/integrations/test_integration_catalog.pyindex 3d0a14acd..6d82a6c39 100644--- a/tests/integrations/test_integration_catalog.py+++ b/tests/integrations/test_integration_catalog.py@@ -285,7 +285,7 @@ VALID_DESCRIPTOR = {"commands": [{"name": "speckit.specify", "file": "templates/speckit.specify.md"},],- "scripts": ["update-context.sh"],+ "scripts": [],},}@@ -305,7 +305,7 @@ class TestIntegrationDescriptor:assert desc.description == "Integration for My Agent"assert desc.requires_speckit_version == ">=0.6.0"assert len(desc.commands) == 1- assert desc.scripts == ["update-context.sh"]+ assert desc.scripts == []def test_missing_schema_version(self, tmp_path):data = {**VALID_DESCRIPTOR}diff --git a/tests/integrations/test_integration_claude.py b/tests/integrations/test_integration_claude.pyindex d3b01097f..153983dcf 100644--- a/tests/integrations/test_integration_claude.py+++ b/tests/integrations/test_integration_claude.py@@ -62,19 +62,17 @@ class TestClaudeIntegration:assert parsed["disable-model-invocation"] is Falseassert parsed["metadata"]["source"] == "templates/commands/plan.md"- def test_setup_installs_update_context_scripts(self, tmp_path):+ def test_setup_upserts_context_section(self, tmp_path):integration = get_integration("claude")manifest = IntegrationManifest("claude", tmp_path)- created = integration.setup(tmp_path, manifest, script_type="sh")-- scripts_dir = tmp_path / ".specify" / "integrations" / "claude" / "scripts"- assert scripts_dir.is_dir()- assert (scripts_dir / "update-context.sh").exists()- assert (scripts_dir / "update-context.ps1").exists()-- tracked = {path.resolve().relative_to(tmp_path.resolve()).as_posix() for path in created}- assert ".specify/integrations/claude/scripts/update-context.sh" in tracked- assert ".specify/integrations/claude/scripts/update-context.ps1" in tracked+ integration.setup(tmp_path, manifest, script_type="sh")++ ctx_path = tmp_path / integration.context_file+ assert ctx_path.exists()+ content = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" in content+ assert "<!-- SPECKIT END -->" in content+ assert "read the current plan" in contentdef test_ai_flag_auto_promotes_and_enables_skills(self, tmp_path):from typer.testing import CliRunnerdiff --git a/tests/integrations/test_integration_copilot.py b/tests/integrations/test_integration_copilot.pyindex 34a9d5494..642b1e530 100644--- a/tests/integrations/test_integration_copilot.py+++ b/tests/integrations/test_integration_copilot.py@@ -143,7 +143,20 @@ class TestCopilotIntegration:assert "__AGENT__" not in content, f"{agent_file.name} has unprocessed __AGENT__"assert "{ARGS}" not in content, f"{agent_file.name} has unprocessed {{ARGS}}"assert "\nscripts:\n" not in content- assert "\nagent_scripts:\n" not in content++ def test_plan_references_correct_context_file(self, tmp_path):+ """The generated plan command must reference copilot's context file."""+ from specify_cli.integrations.copilot import CopilotIntegration+ copilot = CopilotIntegration()+ m = IntegrationManifest("copilot", tmp_path)+ copilot.setup(tmp_path, m)+ plan_file = tmp_path / ".github" / "agents" / "speckit.plan.agent.md"+ assert plan_file.exists()+ content = plan_file.read_text(encoding="utf-8")+ assert copilot.context_file in content, (+ f"Plan command should reference {copilot.context_file!r}"+ )+ assert "__CONTEXT_FILE__" not in contentdef test_complete_file_inventory_sh(self, tmp_path):"""Every file produced by specify init --integration copilot --script sh."""@@ -181,18 +194,15 @@ class TestCopilotIntegration:".github/prompts/speckit.tasks.prompt.md",".github/prompts/speckit.taskstoissues.prompt.md",".vscode/settings.json",+ ".github/copilot-instructions.md",".specify/integration.json",".specify/init-options.json",".specify/integrations/copilot.manifest.json",".specify/integrations/speckit.manifest.json",- ".specify/integrations/copilot/scripts/update-context.ps1",- ".specify/integrations/copilot/scripts/update-context.sh",".specify/scripts/bash/check-prerequisites.sh",".specify/scripts/bash/common.sh",".specify/scripts/bash/create-new-feature.sh",".specify/scripts/bash/setup-plan.sh",- ".specify/scripts/bash/update-agent-context.sh",- ".specify/templates/agent-file-template.md",".specify/templates/checklist-template.md",".specify/templates/constitution-template.md",".specify/templates/plan-template.md",@@ -243,18 +253,15 @@ class TestCopilotIntegration:".github/prompts/speckit.tasks.prompt.md",".github/prompts/speckit.taskstoissues.prompt.md",".vscode/settings.json",+ ".github/copilot-instructions.md",".specify/integration.json",".specify/init-options.json",".specify/integrations/copilot.manifest.json",".specify/integrations/speckit.manifest.json",- ".specify/integrations/copilot/scripts/update-context.ps1",- ".specify/integrations/copilot/scripts/update-context.sh",".specify/scripts/powershell/check-prerequisites.ps1",".specify/scripts/powershell/common.ps1",".specify/scripts/powershell/create-new-feature.ps1",".specify/scripts/powershell/setup-plan.ps1",- ".specify/scripts/powershell/update-agent-context.ps1",- ".specify/templates/agent-file-template.md",".specify/templates/checklist-template.md",".specify/templates/constitution-template.md",".specify/templates/plan-template.md",diff --git a/tests/integrations/test_integration_cursor_agent.py b/tests/integrations/test_integration_cursor_agent.pyindex 3384fdc14..352a0475b 100644--- a/tests/integrations/test_integration_cursor_agent.py+++ b/tests/integrations/test_integration_cursor_agent.py@@ -1,5 +1,10 @@"""Tests for CursorAgentIntegration."""+from pathlib import Path++from specify_cli.integrations import get_integration+from specify_cli.integrations.manifest import IntegrationManifest+from .test_integration_base_skills import SkillsIntegrationTests@@ -11,6 +16,81 @@ class TestCursorAgentIntegration(SkillsIntegrationTests):CONTEXT_FILE = ".cursor/rules/specify-rules.mdc"+class TestCursorMdcFrontmatter:+ """Verify .mdc frontmatter handling in upsert/remove context section."""++ def _setup(self, tmp_path: Path):+ i = get_integration("cursor-agent")+ m = IntegrationManifest("cursor-agent", tmp_path)+ return i, m++ def test_new_mdc_gets_frontmatter(self, tmp_path):+ """A freshly created .mdc file includes alwaysApply: true."""+ i, m = self._setup(tmp_path)+ i.setup(tmp_path, m)+ ctx = (tmp_path / i.context_file).read_text(encoding="utf-8")+ assert ctx.startswith("---\n")+ assert "alwaysApply: true" in ctx++ def test_existing_mdc_without_frontmatter_gets_it(self, tmp_path):+ """An existing .mdc without frontmatter gets it added."""+ i, m = self._setup(tmp_path)+ ctx_path = tmp_path / i.context_file+ ctx_path.parent.mkdir(parents=True, exist_ok=True)+ ctx_path.write_text("# User rules\n", encoding="utf-8")+ i.upsert_context_section(tmp_path)+ content = ctx_path.read_text(encoding="utf-8")+ assert content.lstrip().startswith("---")+ assert "alwaysApply: true" in content+ assert "# User rules" in content++ def test_existing_mdc_with_frontmatter_preserves_it(self, tmp_path):+ """An existing .mdc with custom frontmatter is preserved."""+ i, m = self._setup(tmp_path)+ ctx_path = tmp_path / i.context_file+ ctx_path.parent.mkdir(parents=True, exist_ok=True)+ ctx_path.write_text(+ "---\nalwaysApply: true\ncustomKey: hello\n---\n\n# Rules\n",+ encoding="utf-8",+ )+ i.upsert_context_section(tmp_path)+ content = ctx_path.read_text(encoding="utf-8")+ assert "alwaysApply: true" in content+ assert "customKey: hello" in content+ assert "<!-- SPECKIT START -->" in content++ def test_existing_mdc_wrong_alwaysapply_fixed(self, tmp_path):+ """An .mdc with alwaysApply: false gets corrected."""+ i, m = self._setup(tmp_path)+ ctx_path = tmp_path / i.context_file+ ctx_path.parent.mkdir(parents=True, exist_ok=True)+ ctx_path.write_text(+ "---\nalwaysApply: false\n---\n\n# Rules\n",+ encoding="utf-8",+ )+ i.upsert_context_section(tmp_path)+ content = ctx_path.read_text(encoding="utf-8")+ assert "alwaysApply: true" in content+ assert "alwaysApply: false" not in content++ def test_upsert_idempotent_no_duplicate_frontmatter(self, tmp_path):+ """Repeated upserts don't duplicate frontmatter."""+ i, m = self._setup(tmp_path)+ i.upsert_context_section(tmp_path)+ i.upsert_context_section(tmp_path)+ content = (tmp_path / i.context_file).read_text(encoding="utf-8")+ assert content.count("alwaysApply") == 1++ def test_remove_deletes_mdc_with_only_frontmatter(self, tmp_path):+ """Removing the section from a Speckit-only .mdc deletes the file."""+ i, m = self._setup(tmp_path)+ i.upsert_context_section(tmp_path)+ ctx_path = tmp_path / i.context_file+ assert ctx_path.exists()+ i.remove_context_section(tmp_path)+ assert not ctx_path.exists()++class TestCursorAgentAutoPromote:"""--ai cursor-agent auto-promotes to integration path."""diff --git a/tests/integrations/test_integration_forge.py b/tests/integrations/test_integration_forge.pyindex 7affd0d16..613ede91c 100644--- a/tests/integrations/test_integration_forge.py+++ b/tests/integrations/test_integration_forge.py@@ -73,19 +73,16 @@ class TestForgeIntegration:for f in command_files:assert f.name.endswith(".md")- def test_setup_installs_update_scripts(self, tmp_path):+ def test_setup_upserts_context_section(self, tmp_path):from specify_cli.integrations.forge import ForgeIntegrationforge = ForgeIntegration()m = IntegrationManifest("forge", tmp_path)- created = forge.setup(tmp_path, m)- script_files = [f for f in created if "scripts" in f.parts]- assert len(script_files) > 0- sh_script = tmp_path / ".specify" / "integrations" / "forge" / "scripts" / "update-context.sh"- ps_script = tmp_path / ".specify" / "integrations" / "forge" / "scripts" / "update-context.ps1"- assert sh_script in created- assert ps_script in created- assert sh_script.exists()- assert ps_script.exists()+ forge.setup(tmp_path, m)+ ctx_path = tmp_path / forge.context_file+ assert ctx_path.exists()+ content = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" in content+ assert "<!-- SPECKIT END -->" in contentdef test_all_created_files_tracked_in_manifest(self, tmp_path):from specify_cli.integrations.forge import ForgeIntegration@@ -159,7 +156,20 @@ class TestForgeIntegration:assert "$ARGUMENTS" not in content, f"{cmd_file.name} has unprocessed $ARGUMENTS"# Frontmatter sections should be strippedassert "\nscripts:\n" not in content- assert "\nagent_scripts:\n" not in content++ def test_plan_references_correct_context_file(self, tmp_path):+ """The generated plan command must reference forge's context file."""+ from specify_cli.integrations.forge import ForgeIntegration+ forge = ForgeIntegration()+ m = IntegrationManifest("forge", tmp_path)+ forge.setup(tmp_path, m)+ plan_file = tmp_path / ".forge" / "commands" / "speckit.plan.md"+ assert plan_file.exists()+ content = plan_file.read_text(encoding="utf-8")+ assert forge.context_file in content, (+ f"Plan command should reference {forge.context_file!r}"+ )+ assert "__CONTEXT_FILE__" not in contentdef test_forge_specific_transformations(self, tmp_path):"""Test Forge-specific processing: name injection and handoffs stripping."""diff --git a/tests/integrations/test_integration_generic.py b/tests/integrations/test_integration_generic.pyindex 74034ef10..8ca32078b 100644--- a/tests/integrations/test_integration_generic.py+++ b/tests/integrations/test_integration_generic.py@@ -31,9 +31,9 @@ class TestGenericIntegration:i = get_integration("generic")assert i.config["requires_cli"] is False- def test_context_file_is_none(self):+ def test_context_file_is_agents_md(self):i = get_integration("generic")- assert i.context_file is None+ assert i.context_file == "AGENTS.md"# -- Options ----------------------------------------------------------@@ -158,30 +158,31 @@ class TestGenericIntegration:cmd_files = [f for f in created if "scripts" not in f.parts]assert len(cmd_files) > 0- # -- Scripts ----------------------------------------------------------+ # -- Context section ---------------------------------------------------- def test_setup_installs_update_context_scripts(self, tmp_path):+ def test_setup_upserts_context_section(self, tmp_path):i = get_integration("generic")m = IntegrationManifest("generic", tmp_path)i.setup(tmp_path, m, parsed_options={"commands_dir": ".custom/cmds"})- scripts_dir = tmp_path / ".specify" / "integrations" / "generic" / "scripts"- assert scripts_dir.is_dir(), "Scripts directory not created for generic"- assert (scripts_dir / "update-context.sh").exists()- assert (scripts_dir / "update-context.ps1").exists()-- def test_scripts_tracked_in_manifest(self, tmp_path):- i = get_integration("generic")- m = IntegrationManifest("generic", tmp_path)- i.setup(tmp_path, m, parsed_options={"commands_dir": ".custom/cmds"})- script_rels = [k for k in m.files if "update-context" in k]- assert len(script_rels) >= 2-- def test_sh_script_is_executable(self, tmp_path):+ if i.context_file:+ ctx_path = tmp_path / i.context_file+ assert ctx_path.exists()+ content = ctx_path.read_text(encoding="utf-8")+ assert "<!-- SPECKIT START -->" in content+ assert "<!-- SPECKIT END -->" in content++ def test_plan_references_correct_context_file(self, tmp_path):+ """The generated plan command must reference generic's context file."""i = get_integration("generic")m = IntegrationManifest("generic", tmp_path)i.setup(tmp_path, m, parsed_options={"commands_dir": ".custom/cmds"})- sh = tmp_path / ".specify" / "integrations" / "generic" / "scripts" / "update-context.sh"- assert os.access(sh, os.X_OK)+ plan_file = tmp_path / ".custom" / "cmds" / "speckit.plan.md"+ assert plan_file.exists()+ content = plan_file.read_text(encoding="utf-8")+ assert i.context_file in content, (+ f"Plan command should reference {i.context_file!r}"+ )+ assert "__CONTEXT_FILE__" not in content# -- CLI --------------------------------------------------------------@@ -198,6 +199,28 @@ class TestGenericIntegration:# The integration path validates via setup()assert result.exit_code != 0+ def test_init_options_includes_context_file(self, tmp_path):+ """init-options.json must include context_file for the generic integration."""+ import json+ from typer.testing import CliRunner+ from specify_cli import app++ project = tmp_path / "opts-generic"+ project.mkdir()+ old_cwd = os.getcwd()+ try:+ os.chdir(project)+ result = CliRunner().invoke(app, [+ "init", "--here", "--integration", "generic",+ "--ai-commands-dir", ".myagent/commands",+ "--script", "sh", "--no-git",+ ], catch_exceptions=False)+ finally:+ os.chdir(old_cwd)+ assert result.exit_code == 0+ opts = json.loads((project / ".specify" / "init-options.json").read_text())+ assert opts.get("context_file") == "AGENTS.md"+def test_complete_file_inventory_sh(self, tmp_path):"""Every file produced by specify init --integration generic --ai-commands-dir ... --script sh."""from typer.testing import CliRunner@@ -221,6 +244,7 @@ class TestGenericIntegration:for p in project.rglob("*") if p.is_file())expected = sorted([+ "AGENTS.md",".myagent/commands/speckit.analyze.md",".myagent/commands/speckit.checklist.md",".myagent/commands/speckit.clarify.md",@@ -233,16 +257,12 @@ class TestGenericIntegration:".specify/init-options.json",".specify/integration.json",".specify/integrations/generic.manifest.json",- ".specify/integrations/generic/scripts/update-context.ps1",- ".specify/integrations/generic/scripts/update-context.sh",".specify/integrations/speckit.manifest.json",".specify/memory/constitution.md",".specify/scripts/bash/check-prerequisites.sh",".specify/scripts/bash/common.sh",".specify/scripts/bash/create-new-feature.sh",".specify/scripts/bash/setup-plan.sh",- ".specify/scripts/bash/update-agent-context.sh",- ".specify/templates/agent-file-template.md",".specify/templates/checklist-template.md",".specify/templates/constitution-template.md",".specify/templates/plan-template.md",@@ -279,6 +299,7 @@ class TestGenericIntegration:for p in project.rglob("*") if p.is_file())expected = sorted([+ "AGENTS.md",".myagent/commands/speckit.analyze.md",".myagent/commands/speckit.checklist.md",".myagent/commands/speckit.clarify.md",@@ -291,16 +312,12 @@ class TestGenericIntegration:".specify/init-options.json",".specify/integration.json",".specify/integrations/generic.manifest.json",- ".specify/integrations/generic/scripts/update-context.ps1",- ".specify/integrations/generic/scripts/update-context.sh",".specify/integrations/speckit.manifest.json",".specify/memory/constitution.md",".specify/scripts/powershell/check-prerequisites.ps1",".specify/scripts/powershell/common.ps1",".specify/scripts/powershell/create-new-feature.ps1",".specify/scripts/powershell/setup-plan.ps1",- ".specify/scripts/powershell/update-agent-context.ps1",- ".specify/templates/agent-file-template.md",".specify/templates/checklist-template.md",".specify/templates/constitution-template.md",".specify/templates/plan-template.md",diff --git a/tests/test_agent_config_consistency.py b/tests/test_agent_config_consistency.pyindex 9cfe1ddbc..75e80fdf3 100644--- a/tests/test_agent_config_consistency.py+++ b/tests/test_agent_config_consistency.py@@ -1,6 +1,5 @@"""Consistency checks for agent configuration across runtime surfaces."""-import refrom pathlib import Pathfrom specify_cli import AGENT_CONFIG, AI_ASSISTANT_ALIASES, AI_ASSISTANT_HELP@@ -61,20 +60,6 @@ class TestAgentConfigConsistency:assert "sha256sum -c -" in post_create_textassert "KIRO_SKIP_KIRO_INSTALLER_VERIFY" not in post_create_text- def test_agent_context_scripts_use_kiro_cli(self):- """Agent context scripts should advertise kiro-cli and not legacy q agent key."""- bash_text = (- REPO_ROOT / "scripts" / "bash" / "update-agent-context.sh"- ).read_text(encoding="utf-8")- pwsh_text = (- REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1"- ).read_text(encoding="utf-8")-- assert "kiro-cli" in bash_text- assert "kiro-cli" in pwsh_text- assert "Amazon Q Developer CLI" not in bash_text- assert "Amazon Q Developer CLI" not in pwsh_text-# --- Tabnine CLI consistency checks ---def test_runtime_config_includes_tabnine(self):@@ -96,20 +81,6 @@ class TestAgentConfigConsistency:assert cfg["args"] == "{{args}}"assert cfg["extension"] == ".toml"- def test_agent_context_scripts_include_tabnine(self):- """Agent context scripts should support tabnine agent type."""- bash_text = (- REPO_ROOT / "scripts" / "bash" / "update-agent-context.sh"- ).read_text(encoding="utf-8")- pwsh_text = (- REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1"- ).read_text(encoding="utf-8")-- assert "tabnine" in bash_text- assert "TABNINE_FILE" in bash_text- assert "tabnine" in pwsh_text- assert "TABNINE_FILE" in pwsh_text-def test_ai_help_includes_tabnine(self):"""CLI help text for --ai should include tabnine."""assert "tabnine" in AI_ASSISTANT_HELP@@ -132,18 +103,6 @@ class TestAgentConfigConsistency:assert kimi_cfg["dir"] == ".kimi/skills"assert kimi_cfg["extension"] == "/SKILL.md"- def test_kimi_in_powershell_validate_set(self):- """PowerShell update-agent-context script should include 'kimi' in ValidateSet."""- ps_text = (- REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1"- ).read_text(encoding="utf-8")-- validate_set_match = re.search(r"\[ValidateSet\(([^)]*)\)\]", ps_text)- assert validate_set_match is not None- validate_set_values = re.findall(r"'([^']+)'", validate_set_match.group(1))-- assert "kimi" in validate_set_values-def test_ai_help_includes_kimi(self):"""CLI help text for --ai should include kimi."""assert "kimi" in AI_ASSISTANT_HELP@@ -168,32 +127,6 @@ class TestAgentConfigConsistency:assert trae_cfg["args"] == "$ARGUMENTS"assert trae_cfg["extension"] == "/SKILL.md"- def test_trae_in_agent_context_scripts(self):- """Agent context scripts should support trae agent type."""- bash_text = (- REPO_ROOT / "scripts" / "bash" / "update-agent-context.sh"- ).read_text(encoding="utf-8")- pwsh_text = (- REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1"- ).read_text(encoding="utf-8")-- assert "trae" in bash_text- assert "TRAE_FILE" in bash_text- assert "trae" in pwsh_text- assert "TRAE_FILE" in pwsh_text-- def test_trae_in_powershell_validate_set(self):- """PowerShell update-agent-context script should include 'trae' in ValidateSet."""- ps_text = (- REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1"- ).read_text(encoding="utf-8")-- validate_set_match = re.search(r"\[ValidateSet\(([^)]*)\)\]", ps_text)- assert validate_set_match is not None- validate_set_values = re.findall(r"'([^']+)'", validate_set_match.group(1))-- assert "trae" in validate_set_values-def test_ai_help_includes_trae(self):"""CLI help text for --ai should include trae."""assert "trae" in AI_ASSISTANT_HELP@@ -219,32 +152,6 @@ class TestAgentConfigConsistency:assert pi_cfg["args"] == "$ARGUMENTS"assert pi_cfg["extension"] == ".md"- def test_pi_in_powershell_validate_set(self):- """PowerShell update-agent-context script should include 'pi' in ValidateSet."""- ps_text = (- REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1"- ).read_text(encoding="utf-8")-- validate_set_match = re.search(r"\[ValidateSet\(([^)]*)\)\]", ps_text)- assert validate_set_match is not None- validate_set_values = re.findall(r"'([^']+)'", validate_set_match.group(1))-- assert "pi" in validate_set_values-- def test_agent_context_scripts_include_pi(self):- """Agent context scripts should support pi agent type."""- bash_text = (- REPO_ROOT / "scripts" / "bash" / "update-agent-context.sh"- ).read_text(encoding="utf-8")- pwsh_text = (- REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1"- ).read_text(encoding="utf-8")-- assert "pi" in bash_text- assert "Pi Coding Agent" in bash_text- assert "pi" in pwsh_text- assert "Pi Coding Agent" in pwsh_text-def test_ai_help_includes_pi(self):"""CLI help text for --ai should include pi."""assert "pi" in AI_ASSISTANT_HELP@@ -267,20 +174,6 @@ class TestAgentConfigConsistency:assert cfg["iflow"]["format"] == "markdown"assert cfg["iflow"]["args"] == "$ARGUMENTS"- def test_iflow_in_agent_context_scripts(self):- """Agent context scripts should support iflow agent type."""- bash_text = (- REPO_ROOT / "scripts" / "bash" / "update-agent-context.sh"- ).read_text(encoding="utf-8")- pwsh_text = (- REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1"- ).read_text(encoding="utf-8")-- assert "iflow" in bash_text- assert "IFLOW_FILE" in bash_text- assert "iflow" in pwsh_text- assert "IFLOW_FILE" in pwsh_text-def test_ai_help_includes_iflow(self):"""CLI help text for --ai should include iflow."""assert "iflow" in AI_ASSISTANT_HELP@@ -303,18 +196,6 @@ class TestAgentConfigConsistency:assert cfg["goose"]["format"] == "yaml"assert cfg["goose"]["args"] == "{{args}}"- def test_goose_in_agent_context_scripts(self):- """Agent context scripts should support goose agent type."""- bash_text = (- REPO_ROOT / "scripts" / "bash" / "update-agent-context.sh"- ).read_text(encoding="utf-8")- pwsh_text = (- REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1"- ).read_text(encoding="utf-8")-- assert "goose" in bash_text- assert "goose" in pwsh_text-def test_ai_help_includes_goose(self):"""CLI help text for --ai should include goose."""assert "goose" in AI_ASSISTANT_HELPdiff --git a/tests/test_cursor_frontmatter.py b/tests/test_cursor_frontmatter.pydeleted file mode 100644index 9f8c31ce1..000000000--- a/tests/test_cursor_frontmatter.py+++ /dev/null@@ -1,266 +0,0 @@-"""-Tests for Cursor .mdc frontmatter generation (issue #669).--Verifies that update-agent-context.sh properly prepends YAML frontmatter-to .mdc files so that Cursor IDE auto-includes the rules.-"""--import os-import shutil-import subprocess-import textwrap--import pytest--from tests.conftest import requires_bash--SCRIPT_PATH = os.path.join(- os.path.dirname(__file__),- os.pardir,- "scripts",- "bash",- "update-agent-context.sh",-)--EXPECTED_FRONTMATTER_LINES = [- "---",- "description: Project Development Guidelines",- 'globs: ["**/*"]',- "alwaysApply: true",- "---",-]--requires_git = pytest.mark.skipif(- shutil.which("git") is None,- reason="git is not installed",-)---class TestScriptFrontmatterPattern:- """Static analysis β no git required."""-- def test_create_new_has_mdc_frontmatter_logic(self):- """create_new_agent_file() must contain .mdc frontmatter logic."""- with open(SCRIPT_PATH, encoding="utf-8") as f:- content = f.read()- assert 'if [[ "$target_file" == *.mdc ]]' in content- assert "alwaysApply: true" in content-- def test_update_existing_has_mdc_frontmatter_logic(self):- """update_existing_agent_file() must also handle .mdc frontmatter."""- with open(SCRIPT_PATH, encoding="utf-8") as f:- content = f.read()- # There should be two occurrences of the .mdc check β one per function- occurrences = content.count('if [[ "$target_file" == *.mdc ]]')- assert occurrences >= 2, (- f"Expected at least 2 .mdc frontmatter checks, found {occurrences}"- )-- def test_powershell_script_has_mdc_frontmatter_logic(self):- """PowerShell script must also handle .mdc frontmatter."""- ps_path = os.path.join(- os.path.dirname(__file__),- os.pardir,- "scripts",- "powershell",- "update-agent-context.ps1",- )- with open(ps_path, encoding="utf-8") as f:- content = f.read()- assert "alwaysApply: true" in content- occurrences = content.count(r"\.mdc$")- assert occurrences >= 2, (- f"Expected at least 2 .mdc frontmatter checks in PS script, found {occurrences}"- )---@requires_git-@requires_bash-class TestCursorFrontmatterIntegration:- """Integration tests using a real git repo."""-- @pytest.fixture- def git_repo(self, tmp_path):- """Create a minimal git repo with the spec-kit structure."""- repo = tmp_path / "repo"- repo.mkdir()-- # Init git repo- subprocess.run(- ["git", "init"], cwd=str(repo), capture_output=True, check=True- )- subprocess.run(- ["git", "config", "user.email", "[email protected]"],- cwd=str(repo),- capture_output=True,- check=True,- )- subprocess.run(- ["git", "config", "user.name", "Test"],- cwd=str(repo),- capture_output=True,- check=True,- )-- # Create .specify dir with config- specify_dir = repo / ".specify"- specify_dir.mkdir()- (specify_dir / "config.yaml").write_text(- textwrap.dedent("""\- project_type: webapp- language: python- framework: fastapi- database: N/A- """)- )-- # Create template- templates_dir = specify_dir / "templates"- templates_dir.mkdir()- (templates_dir / "agent-file-template.md").write_text(- "# [PROJECT NAME] Development Guidelines\n\n"- "Auto-generated from all feature plans. Last updated: [DATE]\n\n"- "## Active Technologies\n\n"- "[EXTRACTED FROM ALL PLAN.MD FILES]\n\n"- "## Project Structure\n\n"- "[ACTUAL STRUCTURE FROM PLANS]\n\n"- "## Development Commands\n\n"- "[ONLY COMMANDS FOR ACTIVE TECHNOLOGIES]\n\n"- "## Coding Conventions\n\n"- "[LANGUAGE-SPECIFIC, ONLY FOR LANGUAGES IN USE]\n\n"- "## Recent Changes\n\n"- "[LAST 3 FEATURES AND WHAT THEY ADDED]\n"- )-- # Create initial commit- subprocess.run(- ["git", "add", "-A"], cwd=str(repo), capture_output=True, check=True- )- subprocess.run(- ["git", "commit", "-m", "init"],- cwd=str(repo),- capture_output=True,- check=True,- )-- # Create a feature branch so CURRENT_BRANCH detection works- subprocess.run(- ["git", "checkout", "-b", "001-test-feature"],- cwd=str(repo),- capture_output=True,- check=True,- )-- # Create a spec so the script detects the feature- spec_dir = repo / "specs" / "001-test-feature"- spec_dir.mkdir(parents=True)- (spec_dir / "plan.md").write_text(- "# Test Feature Plan\n\n"- "## Technology Stack\n\n"- "- Language: Python\n"- "- Framework: FastAPI\n"- )-- return repo-- def _run_update(self, repo, agent_type="cursor-agent"):- """Run update-agent-context.sh for a specific agent type."""- script = os.path.abspath(SCRIPT_PATH)- result = subprocess.run(- ["bash", script, agent_type],- cwd=str(repo),- capture_output=True,- text=True,- timeout=30,- )- return result-- def test_new_mdc_file_has_frontmatter(self, git_repo):- """Creating a new .mdc file must include YAML frontmatter."""- result = self._run_update(git_repo)- assert result.returncode == 0, f"Script failed: {result.stderr}"-- mdc_file = git_repo / ".cursor" / "rules" / "specify-rules.mdc"- assert mdc_file.exists(), "Cursor .mdc file was not created"-- content = mdc_file.read_text()- lines = content.splitlines()-- # First line must be the opening ---- assert lines[0] == "---", f"Expected frontmatter start, got: {lines[0]}"-- # Check all frontmatter lines are present- for expected in EXPECTED_FRONTMATTER_LINES:- assert expected in content, f"Missing frontmatter line: {expected}"-- # Content after frontmatter should be the template content- assert "Development Guidelines" in content-- def test_existing_mdc_without_frontmatter_gets_it_added(self, git_repo):- """Updating an existing .mdc file that lacks frontmatter must add it."""- # First, create the file WITHOUT frontmatter (simulating pre-fix state)- cursor_dir = git_repo / ".cursor" / "rules"- cursor_dir.mkdir(parents=True, exist_ok=True)- mdc_file = cursor_dir / "specify-rules.mdc"- mdc_file.write_text(- "# repo Development Guidelines\n\n"- "Auto-generated from all feature plans. Last updated: 2025-01-01\n\n"- "## Active Technologies\n\n"- "- Python + FastAPI (main)\n\n"- "## Recent Changes\n\n"- "- main: Added Python + FastAPI\n"- )-- result = self._run_update(git_repo)- assert result.returncode == 0, f"Script failed: {result.stderr}"-- content = mdc_file.read_text()- lines = content.splitlines()-- assert lines[0] == "---", f"Expected frontmatter start, got: {lines[0]}"- for expected in EXPECTED_FRONTMATTER_LINES:- assert expected in content, f"Missing frontmatter line: {expected}"-- def test_existing_mdc_with_frontmatter_not_duplicated(self, git_repo):- """Updating an .mdc file that already has frontmatter must not duplicate it."""- cursor_dir = git_repo / ".cursor" / "rules"- cursor_dir.mkdir(parents=True, exist_ok=True)- mdc_file = cursor_dir / "specify-rules.mdc"-- frontmatter = (- "---\n"- "description: Project Development Guidelines\n"- 'globs: ["**/*"]\n'- "alwaysApply: true\n"- "---\n\n"- )- body = (- "# repo Development Guidelines\n\n"- "Auto-generated from all feature plans. Last updated: 2025-01-01\n\n"- "## Active Technologies\n\n"- "- Python + FastAPI (main)\n\n"- "## Recent Changes\n\n"- "- main: Added Python + FastAPI\n"- )- mdc_file.write_text(frontmatter + body)-- result = self._run_update(git_repo)- assert result.returncode == 0, f"Script failed: {result.stderr}"-- content = mdc_file.read_text()- # Count occurrences of the frontmatter delimiter- assert content.count("alwaysApply: true") == 1, (- "Frontmatter was duplicated"- )-- def test_non_mdc_file_has_no_frontmatter(self, git_repo):- """Non-.mdc agent files (e.g., Claude) must NOT get frontmatter."""- result = self._run_update(git_repo, agent_type="claude")- assert result.returncode == 0, f"Script failed: {result.stderr}"-- claude_file = git_repo / ".claude" / "CLAUDE.md"- if claude_file.exists():- content = claude_file.read_text()- assert not content.startswith("---"), (- "Non-mdc file should not have frontmatter"- )diff --git a/tests/test_extension_skills.py b/tests/test_extension_skills.pyindex c9d13382a..89e8b4a8b 100644--- a/tests/test_extension_skills.py+++ b/tests/test_extension_skills.py@@ -396,11 +396,8 @@ class TestExtensionSkillRegistration:"description: Scripted plan command\n""scripts:\n"" sh: ../../scripts/bash/setup-plan.sh --json \"{ARGS}\"\n"- "agent_scripts:\n"- " sh: ../../scripts/bash/update-agent-context.sh __AGENT__\n""---\n\n""Run {SCRIPT}\n"- "Then {AGENT_SCRIPT}\n""Review templates/checklist.md and memory/constitution.md for __AGENT__.\n")@@ -409,11 +406,9 @@ class TestExtensionSkillRegistration:content = (skills_dir / "speckit-scripted-ext-plan" / "SKILL.md").read_text()assert "{SCRIPT}" not in content- assert "{AGENT_SCRIPT}" not in contentassert "{ARGS}" not in contentassert "__AGENT__" not in contentassert '.specify/scripts/bash/setup-plan.sh --json "$ARGUMENTS"' in content- assert ".specify/scripts/bash/update-agent-context.sh claude" in contentassert ".specify/templates/checklist.md" in contentassert ".specify/memory/constitution.md" in contentdiff --git a/tests/test_extensions.py b/tests/test_extensions.pyindex 460404d59..5379178af 100644--- a/tests/test_extensions.py+++ b/tests/test_extensions.py@@ -1334,13 +1334,9 @@ description: "Scripted command"scripts:sh: ../../scripts/bash/setup-plan.sh --json "{ARGS}"ps: ../../scripts/powershell/setup-plan.ps1 -Json-agent_scripts:- sh: ../../scripts/bash/update-agent-context.sh __AGENT__- ps: ../../scripts/powershell/update-agent-context.ps1 -AgentType __AGENT__---Run {SCRIPT}-Then {AGENT_SCRIPT}Agent __AGENT__""")@@ -1361,11 +1357,9 @@ Agent __AGENT__content = skill_file.read_text()assert "{SCRIPT}" not in content- assert "{AGENT_SCRIPT}" not in contentassert "__AGENT__" not in contentassert "{ARGS}" not in contentassert '.specify/scripts/bash/setup-plan.sh --json "$ARGUMENTS"' in content- assert ".specify/scripts/bash/update-agent-context.sh codex" in contentdef test_codex_skill_alias_frontmatter_matches_alias_name(self, project_dir, temp_dir):"""Codex alias skills should render their own matching `name:` frontmatter."""@@ -1451,13 +1445,9 @@ description: "Fallback scripted command"scripts:sh: ../../scripts/bash/setup-plan.sh --json "{ARGS}"ps: ../../scripts/powershell/setup-plan.ps1 -Json-agent_scripts:- sh: ../../scripts/bash/update-agent-context.sh __AGENT__- ps: ../../scripts/powershell/update-agent-context.ps1 __AGENT__---Run {SCRIPT}-Then {AGENT_SCRIPT}""")@@ -1474,13 +1464,10 @@ Then {AGENT_SCRIPT}content = skill_file.read_text()assert "{SCRIPT}" not in content- assert "{AGENT_SCRIPT}" not in contentif platform.system().lower().startswith("win"):assert ".specify/scripts/powershell/setup-plan.ps1 -Json" in content- assert ".specify/scripts/powershell/update-agent-context.ps1 codex" in contentelse:assert '.specify/scripts/bash/setup-plan.sh --json "$ARGUMENTS"' in content- assert ".specify/scripts/bash/update-agent-context.sh codex" in contentdef test_codex_skill_registration_handles_non_dict_init_options(self, project_dir, temp_dir@@ -1577,13 +1564,9 @@ description: "Windows fallback scripted command"scripts:sh: ../../scripts/bash/setup-plan.sh --json "{ARGS}"ps: ../../scripts/powershell/setup-plan.ps1 -Json-agent_scripts:- sh: ../../scripts/bash/update-agent-context.sh __AGENT__- ps: ../../scripts/powershell/update-agent-context.ps1 -AgentType __AGENT__---Run {SCRIPT}-Then {AGENT_SCRIPT}""")@@ -1599,7 +1582,6 @@ Then {AGENT_SCRIPT}content = skill_file.read_text()assert ".specify/scripts/powershell/setup-plan.ps1 -Json" in content- assert ".specify/scripts/powershell/update-agent-context.ps1 -AgentType codex" in contentassert ".specify/scripts/bash/setup-plan.sh" not in contentdef test_register_commands_for_copilot(self, extension_dir, project_dir):diff --git a/tests/test_presets.py b/tests/test_presets.pyindex b883d554b..35c19bdd7 100644--- a/tests/test_presets.py+++ b/tests/test_presets.py@@ -1648,7 +1648,6 @@ CORE_TEMPLATE_NAMES = ["tasks-template","checklist-template","constitution-template",- "agent-file-template",]@@ -2911,7 +2910,7 @@ class TestLeanPreset:assert tmpl_path.exists(), f"Missing command file: {tmpl['file']}"def test_lean_commands_have_no_scripts(self):- """Verify lean commands have no scripts or agent_scripts in frontmatter."""+ """Verify lean commands have no scripts in frontmatter."""from specify_cli.agents import CommandRegistrarfor name in LEAN_COMMAND_NAMES:@@ -2919,7 +2918,6 @@ class TestLeanPreset:content = cmd_path.read_text()frontmatter, _ = CommandRegistrar.parse_frontmatter(content)assert "scripts" not in frontmatter, f"{name} should not have scripts in frontmatter"- assert "agent_scripts" not in frontmatter, f"{name} should not have agent_scripts in frontmatter"def test_lean_commands_have_no_hooks(self):"""Verify lean commands do not contain extension hook boilerplate."""