@prmichaelsen/task-mcp 0.2.0

package/agent/progress.yaml

@@ -0,0 +1,375 @@
+# Project Progress Tracking
+# This file tracks the overall progress of the task-mcp project
+
+project:
+  name: task-mcp
+  version: 0.2.0
+  started: 2026-02-16
+  status: in_progress
+  current_milestone: M2
+  description: |
+    MCP server for task execution system - Port ACP-style autonomous task execution 
+    from Roo Code to agentbase.me using MCP server architecture. Enables long-running, 
+    autonomous task execution where agents work through structured milestones and tasks 
+    independently in the background.
+
+# Milestones represent major phases of the project
+milestones:
+  - id: M1
+    name: Planning and Design
+    status: completed
+    progress: 100
+    started: 2026-02-16
+    completed: 2026-02-16
+    estimated_weeks: 1
+    tasks_completed: 3
+    tasks_total: 3
+    notes: |
+      Completed comprehensive design documentation including:
+      - ACP Task Execution Requirements (design document)
+      - Code Extraction Guide (porting guide from Roo Code)
+      - Milestone 2 planning document
+      All design documents are complete and ready for implementation.
+  
+  - id: M2
+    name: MCP Server Foundation
+    status: in_progress
+    progress: 67
+    started: 2026-02-16
+    completed: null
+    estimated_weeks: 2
+    tasks_completed: 4
+    tasks_total: 6
+    notes: |
+      Create task-mcp server with core task management tools.
+      This milestone follows the MCP Server Bootstrap Pattern.
+      Task list revised to match MCP server scope (instruction-based tools).
+      Tasks 86-89 completed. Tasks 90-91 remaining for build and deployment.
+
+# Tasks are granular work items within milestones
+tasks:
+  milestone_1:
+    - id: task-design
+      name: ACP Task Execution Requirements
+      status: completed
+      file: agent/design/acp-task-execution-requirements.md
+      estimated_hours: 8
+      completed_date: 2026-02-16
+      notes: |
+        Comprehensive design document for porting ACP task execution to agentbase.me
+    
+    - id: task-extraction
+      name: Code Extraction Guide
+      status: completed
+      file: agent/design/code-extraction-guide.md
+      estimated_hours: 6
+      completed_date: 2026-02-16
+      notes: |
+        Detailed guide for extracting and adapting code from Roo Code
+    
+    - id: task-milestone-2
+      name: Milestone 2 Planning
+      status: completed
+      file: agent/milestones/milestone-2-task-infrastructure.md
+      estimated_hours: 4
+      completed_date: 2026-02-16
+      notes: |
+        Detailed milestone document for MCP Server Foundation phase
+  
+  milestone_2:
+    - id: task-86
+      name: Task Data Model and Schemas
+      status: completed
+      file: agent/tasks/task-86-task-data-model-schemas.md
+      estimated_hours: 8
+      completed_date: 2026-02-16
+      notes: |
+        Created Firestore data model, TypeScript interfaces, and Zod schemas.
+        All schemas compile without errors and validation tests pass.
+    
+    - id: task-87
+      name: Task Database Service
+      status: completed
+      file: agent/tasks/task-87-task-database-service.md
+      estimated_hours: 12
+      completed_date: 2026-02-16
+      notes: |
+        Created comprehensive TaskDatabaseService with CRUD operations, message
+        operations, progress tracking, and query methods. All 14 unit tests passing.
+    
+    - id: task-88
+      name: Firebase Client Wrapper & MCP Tools Foundation
+      status: completed
+      file: agent/tasks/task-88-firebase-client-wrapper.md
+      estimated_hours: 16
+      completed_date: 2026-02-16
+      notes: |
+        Created Firebase client wrapper and 8 core MCP tools. All tools follow
+        MCP Bootstrap Pattern with definition + handler structure.
+        
+        Completed:
+        - FirebaseClient wrapper with service account auth (11 tests)
+        - 8 MCP tools: get_status, get_next_step, update_progress, complete_task_item,
+          create_milestone, create_task_item, report_completion, add_message
+        - Comprehensive unit tests (43 total tests passing)
+        - Tools index with exports and handler registry
+    
+    - id: task-89
+      name: MCP Server Implementation
+      status: completed
+      file: agent/tasks/task-89-mcp-server-implementation.md
+      estimated_hours: 8
+      completed_date: 2026-02-16
+      notes: |
+        Created MCP server with stdio transport and server factory for multi-tenant.
+        
+        Completed:
+        - Installed @modelcontextprotocol/sdk
+        - Created server-factory.ts with mcp-auth compatible signature
+        - Created server.ts with stdio transport
+        - Updated package.json with bin entry
+        - Wrote comprehensive unit tests with mocked Firebase client
+        - All 51 tests passing (14 database + 11 client + 18 tools + 8 server)
+        - Server factory accepts (accessToken, userId, options) for mcp-auth compatibility
+    
+    - id: task-90
+      name: Build Configuration
+      status: not_started
+      file: agent/tasks/task-90-build-configuration.md
+      estimated_hours: 4
+      completed_date: null
+      notes: |
+        Set up esbuild for bundling server and generating type declarations.
+    
+    - id: task-91
+      name: Deployment Configuration
+      status: not_started
+      file: agent/tasks/task-91-deployment-configuration.md
+      estimated_hours: 4
+      completed_date: null
+      notes: |
+        Create Dockerfile, Cloud Run config, and deployment scripts.
+
+# Documentation tracking
+documentation:
+  design_documents: 3
+  milestone_documents: 1
+  pattern_documents: 1
+  task_documents: 3
+  last_updated: 2026-02-16
+
+# Overall progress metrics
+progress:
+  planning: 100
+  implementation: 67
+  testing: 85
+  documentation: 100
+  overall: 67
+
+# Recent work log (most recent first)
+recent_work:
+  - date: 2026-02-16
+    description: |
+      Implemented API Response DTOs and transformers for REST API integration.
+      Created comprehensive DTO layer to exclude internal fields from API responses.
+    items:
+      - ✅ Created src/dto/task-api.dto.ts with all DTO type definitions
+      - ✅ Defined TaskApiResponse, TaskListApiResponse, TaskMessageApiResponse
+      - ✅ Defined input DTOs (CreateTaskDto, UpdateTaskDto, etc.)
+      - ✅ Created src/dto/transformers.ts with schema-to-DTO transformation functions
+      - ✅ Implemented 9 transformer functions with proper field exclusion
+      - ✅ Excluded internal execution fields (api_messages, tool_results) from API responses
+      - ✅ Created src/dto/index.ts to export all DTOs and transformers
+      - ✅ Updated package.json with ./dto export
+      - ✅ Wrote 18 comprehensive unit tests for all transformers
+      - ✅ All 69 tests passing (14 database + 11 client + 18 tools + 8 server + 18 dto)
+      - ✅ DTO transformers have 100% code coverage
+      - 📋 Ready for Task 90: Build Configuration
+  
+  - date: 2026-02-16
+    description: |
+      Executed @acp.init command - Comprehensive agent context initialization.
+      Loaded all documentation, reviewed source code, verified current status.
+    items:
+      - ✅ Checked for ACP updates (v1.3.1, up to date)
+      - ✅ Read 9 agent documentation files (progress.yaml, design docs, milestones, tasks)
+      - ✅ Reviewed 5 key source files (schemas, services, client, server, server-factory)
+      - ✅ Verified all 51 tests passing (14 database + 11 client + 18 tools + 8 server)
+      - ✅ Confirmed Tasks 86-89 completed (4/6 milestone tasks done)
+      - ✅ Identified next steps: API DTO implementation and library exports
+      - ✅ Updated progress.yaml with initialization entry
+      - 📋 Ready to proceed with next task
+  
+  - date: 2026-02-16
+    description: |
+      Completed Task 89: MCP Server Implementation.
+      Created MCP server with stdio transport and mcp-auth compatible server factory.
+    items:
+      - ✅ Installed @modelcontextprotocol/sdk (v1.26.0)
+      - ✅ Created server-factory.ts with mcp-auth compatible signature
+      - ✅ Server factory accepts (accessToken, userId, options) parameters
+      - ✅ Registers all 8 MCP tools with list_tools handler
+      - ✅ Implements call_tool handler with tool routing
+      - ✅ Created server.ts with stdio transport for standalone usage
+      - ✅ Updated package.json with bin entry for CLI
+      - ✅ Wrote comprehensive unit tests with mocked Firebase client
+      - ✅ All 51 tests passing (14 database + 11 client + 18 tools + 8 server)
+      - ✅ Server ready for mcp-auth wrapper integration
+      - 📋 Next: Task 90 - Build Configuration
+  
+  - date: 2026-02-16
+    description: |
+      Completed Task 88: Firebase Client Wrapper & MCP Tools Foundation.
+      Implemented all 8 core MCP tools with comprehensive test coverage.
+    items:
+      - ✅ Created 8 MCP tools following Bootstrap Pattern
+      - ✅ task_get_status - Get current task status and progress
+      - ✅ task_get_next_step - Get instructions for next step
+      - ✅ task_update_progress - Update progress percentage
+      - ✅ task_complete_task_item - Mark task item complete
+      - ✅ task_create_milestone - Create new milestone
+      - ✅ task_create_task_item - Create task item in milestone
+      - ✅ task_report_completion - Report completion and get next step
+      - ✅ task_add_message - Add message to task thread
+      - ✅ Created tools index with exports and handler registry
+      - ✅ Wrote comprehensive unit tests for all tools
+      - ✅ All 43 tests passing (14 database + 11 client + 18 tools)
+  
+  - date: 2026-02-16
+    description: |
+      Initialized ACP context for task-mcp. Completed comprehensive review of
+      all agent documentation, design documents, and source code. All systems
+      operational and ready for continued development.
+    items:
+      - ✅ Checked for ACP updates (v1.3.1, up to date)
+      - ✅ Read all 9 agent documentation files
+      - ✅ Reviewed 5 key source files (schemas, services, client)
+      - ✅ Verified current implementation status
+      - ✅ Confirmed Task 88 partially complete (client wrapper done)
+      - ✅ All 25 tests passing (14 database + 11 client)
+      - ✅ Updated progress.yaml with current status
+      - 📋 Proceeded with Task 88 MCP tools implementation
+  
+  - date: 2026-02-16
+    description: |
+      Revised Milestone 2 task list to match task-mcp MCP server scope.
+      Created proper task documents (88-91) for MCP implementation.
+    items:
+      - ✅ Identified scope mismatch in original Task 88
+      - ✅ Revised Task 88: Firebase Client Wrapper & MCP Tools Foundation
+      - ✅ Created Task 89: MCP Server Implementation
+      - ✅ Created Task 90: Build Configuration
+      - ✅ Created Task 91: Deployment Configuration
+      - ✅ Updated Milestone 2 document with 6 tasks (was 3)
+      - ✅ Clarified architecture: task-mcp provides instructions, tenant executes
+      - 📋 Ready to proceed with Task 88 implementation
+  
+  - date: 2026-02-16
+    description: |
+      Completed Task 87: Task Database Service. Created comprehensive database
+      service with CRUD operations, message handling, progress tracking, and
+      query methods. All 14 unit tests passing.
+    items:
+      - ✅ Installed Firebase Admin SDK
+      - ✅ Created TaskDatabaseService class with all CRUD methods
+      - ✅ Implemented task message operations (add, get, delete)
+      - ✅ Implemented progress tracking (milestones, task items)
+      - ✅ Added query methods (by status, search by title)
+      - ✅ Wrote 14 comprehensive unit tests with mocked Firestore
+      - ✅ Created E2E test suite for Firestore emulator
+      - ✅ Configured Jest with ESM + TypeScript support
+      - ✅ All tests passing (14/14)
+  
+  - date: 2026-02-16
+    description: |
+      Completed Task 86: Task Data Model and Schemas. Created comprehensive
+      Zod schemas, TypeScript interfaces, Firestore security rules, and
+      collection path helpers.
+    items:
+      - ✅ Initialized Node.js project with TypeScript
+      - ✅ Created src/schemas/task.ts with complete Zod schemas
+      - ✅ Created firestore.rules with user-scoped security
+      - ✅ Created src/constant/collections.ts with path helpers
+      - ✅ Verified TypeScript compilation (no errors)
+      - ✅ Tested Zod validation with valid and invalid data
+      - ✅ All tests passed successfully
+  
+  - date: 2026-02-16
+    description: |
+      Initialized ACP context for task-mcp project. Completed comprehensive
+      planning and design phase.
+    items:
+      - ✅ Read all agent documentation (9 files)
+      - ✅ Analyzed design documents and requirements
+      - ✅ Reviewed milestone and task structure
+      - ✅ Created progress.yaml tracking file
+      - ✅ Enhanced code extraction guide with Roo Code paths
+
+# Next steps (prioritized list)
+next_steps:
+  - Continue with Task 90: Build Configuration
+  - Set up esbuild for bundling server and generating type declarations
+  - Create build and watch scripts
+  - Complete Task 91: Deployment Configuration
+  - Create Dockerfile and Cloud Run config
+
+# General notes and observations
+notes:
+  - Project follows MCP Server Bootstrap Pattern from agent/patterns/bootstrap.md
+  - Design is based on porting Roo Code's task execution to MCP server architecture
+  - Uses pessimistic execution model (continuous work until paused/complete)
+  - MCP server will be separate from agentbase.me codebase for modularity
+  - Firebase Admin SDK with service account for direct Firestore access
+  - All design documents are comprehensive and implementation-ready
+
+# Current blockers (remove when resolved)
+current_blockers: []
+
+# Team and contributors
+team:
+  - role: Lead Developer
+    name: Agent
+    focus: |
+      Currently in initialization phase. Ready to begin implementation of 
+      Milestone 2 (MCP Server Foundation).
+
+# Dependencies and integrations
+dependencies:
+  external_services:
+    - name: Firebase/Firestore
+      status: pending
+      notes: |
+        Need Firebase project with Firestore database and service account key
+    
+    - name: AWS Bedrock
+      status: pending
+      notes: |
+        For AI model integration in task execution
+  
+  libraries:
+    - name: "@modelcontextprotocol/sdk"
+      version: "^1.0.0"
+      purpose: |
+        MCP protocol implementation for server
+    
+    - name: "firebase-admin"
+      version: "latest"
+      purpose: |
+        Direct Firestore access with service account
+    
+    - name: "zod"
+      version: "latest"
+      purpose: |
+        Schema validation for task data models
+  
+  infrastructure:
+    - name: Cloud Run
+      status: pending
+      notes: |
+        Deployment target for MCP server (recommended approach)
+
+# Quality metrics
+quality:
+  test_coverage: 0
+  code_review_status: pending
+  documentation_status: complete

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

@@ -0,0 +1,88 @@
+#!/bin/bash
+
+# Agent Context Protocol (ACP) Update Checker
+# This script checks if updates are available for AGENT.md
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# 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 -e "${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 -e "${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 -e "${RED}Error: Neither curl nor wget is available${NC}" >&2
+    fi
+    exit 2
+fi
+
+if [ $? -ne 0 ]; then
+    if [ "$SILENT" = false ]; then
+        echo -e "${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 -e "${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 -e "${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/update.sh"
+        echo "Or: curl -fsSL https://raw.githubusercontent.com/prmichaelsen/agent-context-protocol/mainlin./agent/scripts/update.sh | bash"
+    fi
+    rm -f /tmp/AGENT.md.latest
+    exit 1
+fi

package/agent/scripts/install.sh

@@ -0,0 +1,157 @@
+#!/bin/bash
+
+# Agent Context Protocol (ACP) Installation Script
+# This script sets up the ACP directory structure and template files in a project
+
+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 "${GREEN}Agent Context Protocol (ACP) Installer${NC}"
+echo "========================================"
+echo ""
+
+# Use current directory
+TARGET_DIR="$(pwd)"
+
+echo "Installing ACP to: $TARGET_DIR"
+echo ""
+
+# Check if agent directory already exists
+if [ -d "$TARGET_DIR/agent" ]; then
+    echo "${YELLOW}Note: agent/ directory already exists${NC}"
+    echo "All ACP files will be updated to latest versions."
+    echo ""
+fi
+
+# Create temporary directory
+TEMP_DIR=$(mktemp -d)
+trap "rm -rf $TEMP_DIR" EXIT
+
+echo "Cloning ACP repository..."
+if ! git clone --depth 1 --branch "$BRANCH" "$REPO_URL" "$TEMP_DIR" &>/dev/null; then
+    echo "${RED}Error: Failed to clone repository${NC}"
+    echo "Please check your internet connection and try again."
+    exit 1
+fi
+
+echo "${GREEN}✓${NC} Repository cloned"
+echo ""
+
+# Create directory structure
+echo "Creating directory structure..."
+mkdir -p "$TARGET_DIR/agent/design"
+mkdir -p "$TARGET_DIR/agent/milestones"
+mkdir -p "$TARGET_DIR/agent/patterns"
+mkdir -p "$TARGET_DIR/agent/tasks"
+mkdir -p "$TARGET_DIR/agent/commands"
+mkdir -p "$TARGET_DIR/agent/scripts"
+mkdir -p "$TARGET_DIR/agent/reports"
+
+# Create .gitkeep files
+touch "$TARGET_DIR/agent/design/.gitkeep"
+touch "$TARGET_DIR/agent/milestones/.gitkeep"
+touch "$TARGET_DIR/agent/patterns/.gitkeep"
+touch "$TARGET_DIR/agent/tasks/.gitkeep"
+
+# Create agent/.gitignore to exclude reports from version control
+cat > "$TARGET_DIR/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/
+EOF
+
+echo "${GREEN}✓${NC} Directory structure created"
+echo ""
+
+# Copy files
+echo "Installing ACP files..."
+
+# Copy template files (only .template.md files from these directories)
+find "$TEMP_DIR/agent/design" -maxdepth 1 -name "*.template.md" -exec cp {} "$TARGET_DIR/agent/design/" \;
+find "$TEMP_DIR/agent/milestones" -maxdepth 1 -name "*.template.md" -exec cp {} "$TARGET_DIR/agent/milestones/" \;
+find "$TEMP_DIR/agent/patterns" -maxdepth 1 -name "*.template.md" -exec cp {} "$TARGET_DIR/agent/patterns/" \;
+find "$TEMP_DIR/agent/tasks" -maxdepth 1 -name "*.template.md" -exec cp {} "$TARGET_DIR/agent/tasks/" \;
+
+# Copy command template
+cp "$TEMP_DIR/agent/commands/command.template.md" "$TARGET_DIR/agent/commands/"
+
+# Copy 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 {} "$TARGET_DIR/agent/commands/" \;
+fi
+
+# Copy progress template
+cp "$TEMP_DIR/agent/progress.template.yaml" "$TARGET_DIR/agent/"
+
+# Copy AGENT.md
+cp "$TEMP_DIR/AGENT.md" "$TARGET_DIR/"
+
+# Copy scripts
+cp "$TEMP_DIR/agent/scripts/update.sh" "$TARGET_DIR/agent/scripts/"
+cp "$TEMP_DIR/agent/scripts/check-for-updates.sh" "$TARGET_DIR/agent/scripts/"
+cp "$TEMP_DIR/agent/scripts/uninstall.sh" "$TARGET_DIR/agent/scripts/"
+cp "$TEMP_DIR/agent/scripts/version.sh" "$TARGET_DIR/agent/scripts/"
+cp "$TEMP_DIR/agent/scripts/install.sh" "$TARGET_DIR/agent/scripts/"
+chmod +x "$TARGET_DIR/agent/scripts"/*.sh
+
+echo "${GREEN}✓${NC} All files installed"
+echo ""
+echo "${GREEN}Installation complete!${NC}"
+echo ""
+echo "${GREEN}Next steps:${NC}"
+echo "1. Create your requirements document:"
+echo "   cp agent/design/requirements.template.md agent/design/requirements.md"
+echo ""
+echo "2. Define your first milestone:"
+echo "   cp agent/milestones/milestone-1-{title}.template.md agent/milestones/milestone-1-foundation.md"
+echo ""
+echo "3. Initialize progress tracking:"
+echo "   cp agent/progress.template.yaml agent/progress.yaml"
+echo ""
+echo "4. Read AGENT.md for complete documentation"
+echo ""
+echo "${BLUE}ACP Commands Available:${NC}"
+echo ""
+echo "  ${GREEN}@acp.init${NC}                    - Initialize agent context (start here!)"
+echo "  ${GREEN}@acp.proceed${NC}                 - Continue with next task"
+echo "  ${GREEN}@acp.status${NC}                  - Display project status"
+echo "  ${GREEN}@acp.update${NC}                  - Update progress tracking"
+echo "  ${GREEN}@acp.sync${NC}                    - Sync documentation with code"
+echo "  ${GREEN}@acp.validate${NC}                - Validate ACP documents"
+echo "  ${GREEN}@acp.report${NC}                  - Generate project report"
+echo "  ${GREEN}@acp.version-check${NC}           - Show current ACP version"
+echo "  ${GREEN}@acp.version-check-for-updates${NC} - Check for ACP updates"
+echo "  ${GREEN}@acp.version-update${NC}          - Update ACP to latest version"
+echo "  ${GREEN}@acp.package-install${NC}         - Install third-party command packages"
+echo ""
+echo "${BLUE}Git Commands Available:${NC}"
+echo ""
+echo "  ${GREEN}@git.init${NC}                    - Initialize git repository with smart .gitignore"
+echo "  ${GREEN}@git.commit${NC}                  - Intelligent version-aware git commit"
+echo ""
+echo "${BLUE}For AI agents:${NC}"
+echo "Type '${GREEN}@acp.init${NC}' to get started."
+echo ""

package/agent/scripts/uninstall.sh

@@ -0,0 +1,75 @@
+#!/bin/bash
+
+# Agent Context Protocol (ACP) Uninstall Script
+# This script removes all ACP files from a project
+# Usage: ./agent/scripts/uninstall.sh [-y]
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Check for -y flag
+AUTO_CONFIRM=false
+if [ "$1" = "-y" ]; then
+    AUTO_CONFIRM=true
+fi
+
+echo -e "${YELLOW}Agent Context Protocol (ACP) Uninstall${NC}"
+echo "======================================"
+echo ""
+
+# Check if agent directory exists
+if [ ! -d "agent" ] && [ ! -f "AGENT.md" ]; then
+    echo -e "${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 -e "${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/uninstall.sh -y"
+    echo ""
+    echo -e "${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 -e "${GREEN}✓${NC} Removed agent/ directory"
+fi
+
+# Remove AGENT.md
+if [ -f "AGENT.md" ]; then
+    rm -f AGENT.md
+    echo -e "${GREEN}✓${NC} Removed AGENT.md"
+fi
+
+echo ""
+echo -e "${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 ""