@prmichaelsen/acp-visualizer 0.1.0

package/agent/scripts/acp.uninstall.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+
+# Agent Context Protocol (ACP) Uninstall Script
+# This script removes all ACP files from a project
+# Usage: ./agent/scripts/unacp.install.sh [-y]
+
+set -e
+
+# Colors for output using tput (more reliable than ANSI codes)
+if command -v tput >/dev/null 2>&1 && [ -t 1 ]; then
+    RED=$(tput setaf 1)
+    GREEN=$(tput setaf 2)
+    YELLOW=$(tput setaf 3)
+    BLUE=$(tput setaf 4)
+    BOLD=$(tput bold)
+    NC=$(tput sgr0)
+else
+    RED=''
+    GREEN=''
+    YELLOW=''
+    BLUE=''
+    BOLD=''
+    NC=''
+fi
+
+# Check for -y flag
+AUTO_CONFIRM=false
+if [ "$1" = "-y" ]; then
+    AUTO_CONFIRM=true
+fi
+
+echo "${YELLOW}Agent Context Protocol (ACP) Uninstall${NC}"
+echo "======================================"
+echo ""
+
+# Check if agent directory exists
+if [ ! -d "agent" ] && [ ! -f "AGENT.md" ]; then
+    echo "${YELLOW}No ACP files found in current directory${NC}"
+    exit 0
+fi
+
+# If not auto-confirmed, show instructions for agents
+if [ "$AUTO_CONFIRM" = false ]; then
+    echo "${BLUE}Note for AI Agents:${NC}"
+    echo "This script requires user confirmation to prevent accidental deletion."
+    echo "Please ask the user: 'Do you want to uninstall ACP from this project?'"
+    echo "If yes, rerun this script with: ./agent/scripts/unacp.install.sh -y"
+    echo ""
+    echo "${RED}WARNING: This will permanently delete:${NC}"
+    echo "  - agent/ directory (all contents)"
+    echo "  - AGENT.md file"
+    echo ""
+    echo "Make sure you have committed any important changes to git."
+    echo ""
+    
+    read -p "Are you sure you want to remove all ACP files? (y/N) " -n 1 -r
+    echo
+    
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        echo "Uninstall cancelled. No files were deleted."
+        exit 0
+    fi
+fi
+
+echo ""
+echo "Removing ACP files..."
+
+# Remove agent directory
+if [ -d "agent" ]; then
+    rm -rf agent
+    echo "${GREEN}✓${NC} Removed agent/ directory"
+fi
+
+# Remove AGENT.md
+if [ -f "AGENT.md" ]; then
+    rm -f AGENT.md
+    echo "${GREEN}✓${NC} Removed AGENT.md"
+fi
+
+echo ""
+echo "${GREEN}Uninstall complete!${NC}"
+echo ""
+echo "All ACP files have been removed from this project."
+echo "Use 'git status' to see what was deleted."
+echo ""

package/agent/scripts/acp.version-check-for-updates.sh

@@ -0,0 +1,98 @@
+#!/bin/bash
+
+# Agent Context Protocol (ACP) Update Checker
+# This script checks if updates are available for AGENT.md
+
+set -e
+
+# Colors for output using tput (more reliable than ANSI codes)
+if command -v tput >/dev/null 2>&1 && [ -t 1 ]; then
+    RED=$(tput setaf 1)
+    GREEN=$(tput setaf 2)
+    YELLOW=$(tput setaf 3)
+    BLUE=$(tput setaf 4)
+    BOLD=$(tput bold)
+    NC=$(tput sgr0)
+else
+    RED=''
+    GREEN=''
+    YELLOW=''
+    BLUE=''
+    BOLD=''
+    NC=''
+fi
+
+# Repository URL
+REPO_URL="https://raw.githubusercontent.com/prmichaelsen/agent-context-protocol/mainline"
+AGENT_MD_URL="$REPO_URL/AGENT.md"
+CHANGELOG_URL="$REPO_URL/CHANGELOG.md"
+
+# Silent mode (no output, just exit codes)
+SILENT=false
+if [ "$1" = "--silent" ] || [ "$1" = "-s" ]; then
+    SILENT=true
+fi
+
+# Check if AGENT.md exists
+if [ ! -f "AGENT.md" ]; then
+    if [ "$SILENT" = false ]; then
+        echo "${RED}Error: AGENT.md not found in current directory${NC}" >&2
+        echo "This script should be run from your project root where AGENT.md is located." >&2
+    fi
+    exit 2
+fi
+
+# Download latest AGENT.md for comparison
+if [ "$SILENT" = false ]; then
+    echo "${BLUE}Checking for updates...${NC}"
+fi
+
+if command -v curl &> /dev/null; then
+    curl -fsSL "$AGENT_MD_URL" -o /tmp/AGENT.md.latest 2>/dev/null
+elif command -v wget &> /dev/null; then
+    wget -q "$AGENT_MD_URL" -O /tmp/AGENT.md.latest 2>/dev/null
+else
+    if [ "$SILENT" = false ]; then
+        echo "${RED}Error: Neither curl nor wget is available${NC}" >&2
+    fi
+    exit 2
+fi
+
+if [ $? -ne 0 ]; then
+    if [ "$SILENT" = false ]; then
+        echo "${RED}Error: Failed to download latest AGENT.md${NC}" >&2
+        echo "Please check your internet connection." >&2
+    fi
+    rm -f /tmp/AGENT.md.latest
+    exit 2
+fi
+
+# Compare files
+if cmp -s AGENT.md /tmp/AGENT.md.latest; then
+    # Files are identical - no updates
+    if [ "$SILENT" = false ]; then
+        echo "${GREEN}✓${NC} Your AGENT.md is up to date!"
+    fi
+    rm -f /tmp/AGENT.md.latest
+    exit 0
+else
+    # Files differ - updates available
+    if [ "$SILENT" = false ]; then
+        echo "${YELLOW}⚠${NC}  Updates are available for AGENT.md"
+        echo ""
+        
+        # Download and display changelog
+        echo "Recent changes:"
+        echo "---------------"
+        if command -v curl &> /dev/null; then
+            curl -fsSL "$CHANGELOG_URL" 2>/dev/null | head -n 50
+        elif command -v wget &> /dev/null; then
+            wget -q "$CHANGELOG_URL" -O - 2>/dev/null | head -n 50
+        fi
+        echo ""
+        echo "To update, run: ./agent/scripts/acp.version-update.sh"
+        echo "Or: curl -fsSL https://raw.githubusercontent.com/prmichaelsen/agent-context-protocol/mainlin./agent/scripts/acp.version-update.sh | bash"
+    fi
+    rm -f /tmp/AGENT.md.latest
+    exit 1
+fi

package/agent/scripts/acp.version-check.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+
+# ACP Version Check Script
+# Extracts and displays the current ACP version from AGENT.md
+
+set -e
+
+# Colors for output using tput (more reliable than ANSI codes)
+if command -v tput >/dev/null 2>&1 && [ -t 1 ]; then
+    RED=$(tput setaf 1)
+    GREEN=$(tput setaf 2)
+    YELLOW=$(tput setaf 3)
+    BLUE=$(tput setaf 4)
+    BOLD=$(tput bold)
+    NC=$(tput sgr0)
+else
+    RED=''
+    GREEN=''
+    YELLOW=''
+    BLUE=''
+    BOLD=''
+    NC=''
+fi
+
+# Check if AGENT.md exists
+if [ ! -f "AGENT.md" ]; then
+    echo "Error: AGENT.md not found in current directory"
+    echo "This script should be run from your project root where AGENT.md is located."
+    exit 1
+fi
+
+# Extract version from AGENT.md
+VERSION=$(grep -m 1 "^\*\*Version\*\*:" AGENT.md | sed 's/.*: //')
+CREATED=$(grep -m 1 "^\*\*Created\*\*:" AGENT.md | sed 's/.*: //')
+STATUS=$(grep -m 1 "^\*\*Status\*\*:" AGENT.md | sed 's/.*: //')
+
+# Display version information
+echo "${BLUE}📦 ACP Version Information${NC}"
+echo ""
+echo "Version: $VERSION"
+echo "Created: $CREATED"
+echo "Status: $STATUS"
+echo ""
+echo "${GREEN}✓${NC} ACP is installed"
+echo ""
+echo "To check for updates: ./agent/scripts/acp.version-check-for-updates.sh"
+echo "To update ACP: ./agent/scripts/acp.version-update.sh"

package/agent/scripts/acp.version-update.sh

@@ -0,0 +1,176 @@
+#!/bin/bash
+
+# Agent Context Protocol (ACP) Update Script
+# This script updates AGENT.md, template files, and utility scripts from the repository
+
+# Self-relocation guard: this script overwrites itself during the update
+# (it copies the latest version from the repo to agent/scripts/). Bash reads
+# files lazily by byte offset, so the overwrite garbles execution. Fix: re-exec
+# from a temp copy so the file on disk can safely change.
+if [ -z "$_ACP_UPDATE_RELOCATED" ]; then
+    _tmp_copy=$(mktemp)
+    cp "$0" "$_tmp_copy"
+    export _ACP_UPDATE_RELOCATED=1
+    bash "$_tmp_copy" "$@"
+    _rc=$?
+    rm -f "$_tmp_copy"
+    exit $_rc
+fi
+
+set -e
+
+# Colors for output using tput (more reliable than ANSI codes)
+if command -v tput >/dev/null 2>&1 && [ -t 1 ]; then
+    RED=$(tput setaf 1)
+    GREEN=$(tput setaf 2)
+    YELLOW=$(tput setaf 3)
+    BLUE=$(tput setaf 4)
+    BOLD=$(tput bold)
+    NC=$(tput sgr0)
+else
+    RED=''
+    GREEN=''
+    YELLOW=''
+    BLUE=''
+    BOLD=''
+    NC=''
+fi
+
+# Repository details
+REPO_URL="https://github.com/prmichaelsen/agent-context-protocol.git"
+BRANCH="mainline"
+
+echo "${BLUE}Agent Context Protocol (ACP) Updater${NC}"
+echo "======================================"
+echo ""
+
+# Check if AGENT.md exists
+if [ ! -f "AGENT.md" ]; then
+    echo "${RED}Error: AGENT.md not found in current directory${NC}"
+    echo "This script should be run from your project root where AGENT.md is located."
+    exit 1
+fi
+
+# Create temporary directory
+TEMP_DIR=$(mktemp -d)
+trap "rm -rf $TEMP_DIR" EXIT
+
+echo "Fetching latest ACP files..."
+if ! git clone --depth 1 --branch "$BRANCH" "$REPO_URL" "$TEMP_DIR" &>/dev/null; then
+    echo "${RED}Error: Failed to fetch repository${NC}"
+    echo "Please check your internet connection and try again."
+    exit 1
+fi
+
+echo "${GREEN}✓${NC} Latest files fetched"
+echo ""
+
+# Ensure reports directory exists and is ignored
+mkdir -p "agent/reports"
+if [ ! -f "agent/.gitignore" ]; then
+    echo "Creating agent/.gitignore..."
+    cat > "agent/.gitignore" << 'EOF'
+# Agent Context Protocol - Local Files
+# These files are generated locally and should not be committed
+
+# Reports directory - generated by @acp.report command
+reports/
+clarifications/
+feedback/
+drafts/
+preferences/
+EOF
+    echo "${GREEN}✓${NC} Created agent/.gitignore"
+fi
+
+echo "Updating ACP files..."
+
+# Update template files (only .template.md files from these directories)
+find "$TEMP_DIR/agent/design" -maxdepth 1 -name "*.template.md" -exec cp {} "agent/design/" \;
+find "$TEMP_DIR/agent/milestones" -maxdepth 1 -name "*.template.md" -exec cp {} "agent/milestones/" \;
+find "$TEMP_DIR/agent/patterns" -maxdepth 1 -name "*.template.md" -exec cp {} "agent/patterns/" \;
+find "$TEMP_DIR/agent/tasks" -maxdepth 1 -name "*.template.md" -exec cp {} "agent/tasks/" \;
+
+# Update command template
+mkdir -p "agent/commands"
+cp "$TEMP_DIR/agent/commands/command.template.md" "agent/commands/"
+
+# Update all command files (flat structure with dot notation)
+# Copies files like acp.init.md, acp.status.md, deploy.production.md, etc.
+if [ -d "$TEMP_DIR/agent/commands" ]; then
+    find "$TEMP_DIR/agent/commands" -maxdepth 1 -name "*.*.md" -exec cp {} "agent/commands/" \;
+fi
+
+# Update progress template
+cp "$TEMP_DIR/agent/progress.template.yaml" "agent/"
+
+# Update manifest template
+if [ -f "$TEMP_DIR/agent/manifest.template.yaml" ]; then
+    cp "$TEMP_DIR/agent/manifest.template.yaml" "agent/"
+fi
+
+# Update package template
+if [ -f "$TEMP_DIR/agent/package.template.yaml" ]; then
+    cp "$TEMP_DIR/agent/package.template.yaml" "agent/"
+fi
+
+# Update AGENT.md
+cp "$TEMP_DIR/AGENT.md" "."
+
+# Update all scripts (*.sh files)
+# This ensures all current and future scripts are copied
+if [ -d "$TEMP_DIR/agent/scripts" ]; then
+    find "$TEMP_DIR/agent/scripts" -maxdepth 1 -name "*.sh" -exec cp {} "agent/scripts/" \;
+    chmod +x agent/scripts/*.sh
+fi
+
+# Clean up deprecated scripts (from versions < 2.0.0)
+. "agent/scripts/acp.common.sh"
+init_colors
+cleanup_deprecated_scripts
+
+echo "${GREEN}✓${NC} All files updated"
+echo ""
+
+# Update acp-core version in manifest if it exists
+if [ -f "agent/manifest.yaml" ]; then
+    echo "Updating manifest..."
+    
+    # Get new ACP version
+    NEW_VERSION=$(grep "^\*\*Version\*\*:" "AGENT.md" | sed 's/.*: //' | head -1)
+    UPDATE_DATE=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    
+    # Update acp-core version and timestamps
+    _sed_i "/^  acp-core:/,/^  [a-z]/ {
+        s/package_version: .*/package_version: ${NEW_VERSION}/
+        s/updated_at: .*/updated_at: ${UPDATE_DATE}/
+    }" agent/manifest.yaml
+
+    # Update manifest timestamp
+    _sed_i "s/^last_updated: .*/last_updated: ${UPDATE_DATE}/" agent/manifest.yaml
+    
+    echo "${GREEN}✓${NC} Updated acp-core to v${NEW_VERSION} in manifest.yaml"
+    echo ""
+fi
+
+echo "${GREEN}Update complete!${NC}"
+echo ""
+echo "${BLUE}What was updated:${NC}"
+echo "  ✓ AGENT.md (methodology documentation)"
+echo "  ✓ Template files (design, milestone, task, pattern)"
+echo "  ✓ Command files (all ACP commands)"
+echo "  ✓ Utility scripts (update, check-for-updates, version, etc.)"
+echo ""
+echo "${BLUE}Next steps:${NC}"
+echo "1. Review changes: git diff"
+echo "2. See what changed: git status"
+echo "3. Revert if needed: git checkout <file>"
+echo ""
+echo "For detailed changelog:"
+echo "  https://github.com/prmichaelsen/agent-context-protocol/blob/mainline/CHANGELOG.md"
+echo ""
+display_available_commands
+echo ""
+echo "${BLUE}For AI agents:${NC}"
+echo "Type '${GREEN}@acp.init${NC}' to reload context with updated files."
+echo ""