@prmichaelsen/task-mcp 0.2.0

package/agent/scripts/update.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+
+# Agent Context Protocol (ACP) Update Script
+# This script updates AGENT.md, template files, and utility scripts from the repository
+
+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/
+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 AGENT.md
+cp "$TEMP_DIR/AGENT.md" "."
+
+# Update scripts
+cp "$TEMP_DIR/agent/scripts/update.sh" "agent/scripts/"
+cp "$TEMP_DIR/agent/scripts/check-for-updates.sh" "agent/scripts/"
+cp "$TEMP_DIR/agent/scripts/uninstall.sh" "agent/scripts/"
+cp "$TEMP_DIR/agent/scripts/version.sh" "agent/scripts/"
+cp "$TEMP_DIR/agent/scripts/install.sh" "agent/scripts/"
+chmod +x agent/scripts/*.sh
+
+echo "${GREEN}✓${NC} All files updated"
+echo ""
+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 ""
+echo "${BLUE}ACP Commands Available:${NC}"
+echo ""
+echo "  ${GREEN}@acp.init${NC}                    - Initialize agent context (run after update!)"
+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 reload context with updated files."
+echo ""

package/agent/scripts/version.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+
+# ACP Version Check Script
+# Extracts and displays the current ACP version from AGENT.md
+
+set -e
+
+# Colors for output
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# 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 -e "${BLUE}📦 ACP Version Information${NC}"
+echo ""
+echo "Version: $VERSION"
+echo "Created: $CREATED"
+echo "Status: $STATUS"
+echo ""
+echo -e "${GREEN}✓${NC} ACP is installed"
+echo ""
+echo "To check for updates: ./agent/scripts/check-for-updates.sh"
+echo "To update ACP: ./agent/scripts/update.sh"

package/agent/tasks/task-1-{title}.template.md

@@ -0,0 +1,225 @@
+# Task {N}: {Descriptive Task Name}
+
+**Milestone**: [M{N} - Milestone Name](../milestones/milestone-{N}-{name}.md)
+**Estimated Time**: [e.g., "2 hours", "4 hours", "1 day"]
+**Dependencies**: [List prerequisite tasks, or "None"]
+**Status**: Not Started | In Progress | Completed
+
+---
+
+## Objective
+
+[Clearly state what this task accomplishes. Be specific and focused on a single, achievable goal.]
+
+**Example**: "Create the basic project structure with all necessary configuration files and directory organization for a TypeScript-based MCP server."
+
+---
+
+## Context
+
+[Provide background information that helps understand why this task is necessary and how it fits into the larger milestone.]
+
+**Example**: "This task establishes the foundation for the project. Without proper structure and configuration, subsequent development tasks cannot proceed. The structure follows industry best practices for TypeScript projects and MCP server organization."
+
+---
+
+## Steps
+
+[Provide a detailed, sequential list of actions to complete this task. Each step should be concrete and actionable.]
+
+### 1. [Step Category or Action]
+[Detailed description of what to do]
+
+```bash
+# Command examples if applicable
+command --with-flags
+```
+
+```typescript
+// Code examples if applicable
+const example = "code";
+```
+
+### 2. [Next Step]
+[Detailed description]
+
+### 3. [Next Step]
+[Detailed description]
+
+**Example**:
+
+### 1. Create Project Directory
+Create the root directory for the project and navigate into it:
+
+```bash
+mkdir -p my-project
+cd my-project
+```
+
+### 2. Initialize npm Project
+Initialize a new npm project with default settings:
+
+```bash
+npm init -y
+```
+
+### 3. Update package.json
+Edit the generated package.json to include proper metadata and scripts:
+
+```json
+{
+  "name": "my-project",
+  "version": "0.1.0",
+  "description": "Description of what this project does",
+  "main": "dist/index.js",
+  "type": "module",
+  "scripts": {
+    "build": "node esbuild.build.js",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": ["mcp", "relevant", "keywords"],
+  "author": "Your Name",
+  "license": "MIT"
+}
+```
+
+### 4. Create Directory Structure
+Create all necessary directories:
+
+```bash
+mkdir -p src/{types,utils,tools}
+mkdir -p tests/{unit,integration}
+mkdir -p agent/{design,milestones,patterns,tasks}
+```
+
+### 5. Create Configuration Files
+Create TypeScript configuration, build scripts, and other config files.
+
+**tsconfig.json**:
+```json
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}
+```
+
+[Continue with other config files...]
+
+---
+
+## Verification
+
+[Provide a checklist of items to verify the task is complete. Each item should be objectively verifiable.]
+
+- [ ] Verification item 1: [Specific condition to check]
+- [ ] Verification item 2: [Specific condition to check]
+- [ ] Verification item 3: [Specific condition to check]
+- [ ] Verification item 4: [Specific condition to check]
+- [ ] Verification item 5: [Specific condition to check]
+
+**Example**:
+- [ ] Project directory created and contains expected subdirectories
+- [ ] package.json exists and contains correct metadata
+- [ ] tsconfig.json exists and is valid JSON
+- [ ] All configuration files created (.gitignore, .env.example, etc.)
+- [ ] Directory structure matches specification
+- [ ] No syntax errors in configuration files
+
+---
+
+## Expected Output
+
+[Describe what the project should look like after this task is complete.]
+
+**File Structure**:
+```
+project-root/
+├── file1
+├── file2
+└── directory/
+    └── file3
+```
+
+**Key Files Created**:
+- `file1`: [Purpose]
+- `file2`: [Purpose]
+- `directory/file3`: [Purpose]
+
+---
+
+## Common Issues and Solutions
+
+[Document potential problems and how to resolve them:]
+
+### Issue 1: [Problem description]
+**Symptom**: [What the user will see]
+**Solution**: [How to fix it]
+
+### Issue 2: [Problem description]
+**Symptom**: [What the user will see]
+**Solution**: [How to fix it]
+
+**Example**:
+
+### Issue 1: npm init fails
+**Symptom**: Error message about permissions or missing npm
+**Solution**: Ensure Node.js and npm are installed correctly. Run `node --version` and `npm --version` to verify.
+
+### Issue 2: TypeScript configuration errors
+**Symptom**: tsc complains about invalid configuration
+**Solution**: Validate JSON syntax in tsconfig.json. Ensure all required fields are present.
+
+---
+
+## Resources
+
+[Link to relevant documentation, examples, or references:]
+
+- [Resource 1 Name](URL): Description
+- [Resource 2 Name](URL): Description
+- [Resource 3 Name](URL): Description
+
+**Example**:
+- [TypeScript Handbook](https://www.typescriptlang.org/docs/): Official TypeScript documentation
+- [esbuild Documentation](https://esbuild.github.io/): Build tool documentation
+- [MCP SDK Documentation](https://github.com/modelcontextprotocol/sdk): MCP protocol reference
+
+---
+
+## Notes
+
+[Any additional context, warnings, or considerations:]
+
+- Note 1: [Important information]
+- Note 2: [Important information]
+- Note 3: [Important information]
+
+**Example**:
+- This task creates the foundation for all subsequent work
+- Configuration files may need adjustment based on specific project requirements
+- Keep .env files out of version control (ensure .gitignore is correct)
+
+---
+
+**Next Task**: [Link to next task: task-{N+1}-{name}.md]
+**Related Design Docs**: [Links to relevant design documents]
+**Estimated Completion Date**: [YYYY-MM-DD or "TBD"]

package/agent/tasks/task-86-task-data-model-schemas.md

@@ -0,0 +1,143 @@
+# Task 86: Task Data Model and Schemas
+
+**Milestone**: Milestone 1 - Task Infrastructure
+**Estimated Time**: 8 hours
+**Dependencies**: None
+**Status**: Not Started
+
+---
+
+## Objective
+
+Create Firestore data model, TypeScript interfaces, and Zod schemas for the task execution system. This includes Task documents, TaskMessage subcollections, and Firestore security rules.
+
+## Steps
+
+### 1. Create Task Schema
+
+Create `src/schemas/task.ts` with Zod schemas for:
+- Task document
+- Milestone
+- TaskItem
+- TaskMessage
+- Progress tracking structures
+
+### 2. Create TypeScript Interfaces
+
+Export TypeScript types from Zod schemas:
+- `Task`
+- `Milestone`
+- `TaskItem`
+- `TaskMessage`
+- `TaskProgress`
+- `TaskExecution`
+- `TaskConfig`
+
+### 3. Update Firestore Security Rules
+
+Add security rules to `firestore.rules`:
+- Users can only access their own tasks
+- Tasks are scoped to `users/{userId}/tasks/{taskId}`
+- Messages are scoped to `users/{userId}/tasks/{taskId}/messages/{messageId}`
+- Validate task structure on write
+
+### 4. Create Collection Constants
+
+Update `src/constant/collections.ts`:
+- Add `getUserTasks(userId)` helper
+- Add `getUserTaskMessages(userId, taskId)` helper
+
+## Verification
+
+- [ ] Schemas compile without errors
+- [ ] All required fields are present
+- [ ] Optional fields are properly typed
+- [ ] Firestore rules pass security tests
+- [ ] Collection helpers return correct paths
+- [ ] Zod validation works for valid data
+- [ ] Zod validation rejects invalid data
+
+## Example Schema Structure
+
+```typescript
+// src/schemas/task.ts
+import { z } from 'zod'
+
+export const MilestoneSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  description: z.string(),
+  status: z.enum(['not_started', 'in_progress', 'completed']),
+  progress: z.number().min(0).max(100),
+  tasks_completed: z.number(),
+  tasks_total: z.number(),
+  started: z.string().optional(),
+  completed: z.string().optional()
+})
+
+export const TaskItemSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  description: z.string(),
+  status: z.enum(['not_started', 'in_progress', 'completed']),
+  estimated_hours: z.number().optional(),
+  completed_date: z.string().optional(),
+  notes: z.string().optional()
+})
+
+export const TaskSchema = z.object({
+  id: z.string(),
+  user_id: z.string(),
+  title: z.string(),
+  description: z.string(),
+  status: z.enum(['not_started', 'in_progress', 'paused', 'completed', 'failed']),
+  created_at: z.string(),
+  updated_at: z.string(),
+  started_at: z.string().optional(),
+  completed_at: z.string().optional(),
+  
+  progress: z.object({
+    current_milestone: z.string(),
+    current_task: z.string(),
+    overall_percentage: z.number().min(0).max(100),
+    milestones: z.array(MilestoneSchema),
+    tasks: z.record(z.array(TaskItemSchema))
+  }),
+  
+  execution: z.object({
+    api_messages: z.array(z.any()),
+    task_messages: z.array(z.any()),
+    tool_results: z.array(z.any()),
+    error: z.string().optional(),
+    abort_reason: z.string().optional()
+  }),
+  
+  config: z.object({
+    model: z.string(),
+    system_prompt: z.string(),
+    auto_approve: z.boolean(),
+    max_iterations: z.number().optional(),
+    timeout_minutes: z.number().optional()
+  }),
+  
+  metadata: z.object({
+    conversation_id: z.string().optional(),
+    parent_task_id: z.string().optional(),
+    tags: z.array(z.string()).optional()
+  }).optional()
+})
+
+export type Task = z.infer<typeof TaskSchema>
+export type Milestone = z.infer<typeof MilestoneSchema>
+export type TaskItem = z.infer<typeof TaskItemSchema>
+```
+
+## Files to Create
+
+- `src/schemas/task.ts`
+- Update `firestore.rules`
+- Update `src/constant/collections.ts`
+
+---
+
+**Next Task**: [Task 87: Task Database Service](task-87-task-database-service.md)