simple-task-master/reports/examples/example-integrated-task.md

A simple command-line task management tool

---
# STM Core Fields
id: 999
title: "Example Task with Multiple Tool Integrations"
status: "in-progress"
schema: 1
created: "2025-01-15T09:00:00.000Z"
updated: "2025-01-19T16:45:00.000Z"
tags: ["example", "integration", "demo"]
dependencies: []

# AutoAgent Integration
autoagent_assigned: true
autoagent_version: "3.2.0"
autoagent_config:
  automation_level: "partial"
  retry_on_failure: true
  max_retries: 3
  timeout_seconds: 300
  notification_channels:
    - type: "slack"
      target: "#dev-notifications"
    - type: "email"
      target: "team@company.com"
autoagent_status:
  state: "completed"
  last_run: "2025-01-19T14:30:00.000Z"
  next_scheduled: "2025-01-20T02:00:00.000Z"
  runs_completed: 42
  runs_failed: 3
  success_rate: 0.929
  average_duration_seconds: 156
autoagent_history:
  - run_id: "run-1737303000000"
    started_at: "2025-01-19T14:30:00.000Z"
    completed_at: "2025-01-19T14:32:36.000Z"
    status: "success"
    duration_seconds: 156
  - run_id: "run-1737216600000"
    started_at: "2025-01-18T14:30:00.000Z"
    completed_at: "2025-01-18T14:33:12.000Z"
    status: "success"
    duration_seconds: 192

# GitHub Integration
github_issue: 456
github_pr: 789
github_labels: ["enhancement", "backend", "high-priority"]
github_milestone: "v2.5.0"
github_workflow:
  workflow_id: "ci-cd.yml"
  run_id: 7891234567
  run_number: 234
  status: "completed"
  conclusion: "success"
  started_at: "2025-01-19T15:00:00.000Z"
  completed_at: "2025-01-19T15:15:23.000Z"
  html_url: "https://github.com/company/repo/actions/runs/7891234567"
github_metadata:
  repository: "company/project"
  branch: "feature/task-999-implementation"
  commit_sha: "a1b2c3d4e5f6789012345678901234567890abcd"
  actor: "john.doe"
  event: "pull_request"

# JIRA Integration
jira_issue:
  key: "PROJ-1234"
  type: "Story"
  priority: "High"
  story_points: 8
  sprint: "Sprint 23"
  epic: "PROJ-1000"
  labels: ["backend", "api", "customer-requested"]
jira_status:
  workflow_status: "In Development"
  assignee: "john.doe"
  reporter: "jane.smith"
  created: "2025-01-15T09:00:00.000Z"
  updated: "2025-01-19T14:45:00.000Z"
  due_date: "2025-01-25T17:00:00.000Z"
jira_links:
  web_url: "https://company.atlassian.net/browse/PROJ-1234"
  api_url: "https://company.atlassian.net/rest/api/2/issue/PROJ-1234"
  related_issues: ["PROJ-1233", "PROJ-1235", "PROJ-1237"]
  blocks: ["PROJ-1236"]
  blocked_by: []

# Time Tracking Integration
time_entries:
  - date: "2025-01-15"
    hours: 2.5
    description: "Initial analysis and design"
    user: "john.doe@company.com"
    logged_at: "2025-01-15T17:30:00.000Z"
  - date: "2025-01-16"
    hours: 4
    description: "Implementation of core functionality"
    user: "john.doe@company.com"
    logged_at: "2025-01-16T18:00:00.000Z"
  - date: "2025-01-17"
    hours: 3.5
    description: "Unit tests and documentation"
    user: "john.doe@company.com"
    logged_at: "2025-01-17T17:45:00.000Z"
  - date: "2025-01-18"
    hours: 2
    description: "Code review feedback implementation"
    user: "john.doe@company.com"
    logged_at: "2025-01-18T16:00:00.000Z"
  - date: "2025-01-19"
    hours: 1.5
    description: "Integration testing"
    user: "john.doe@company.com"
    logged_at: "2025-01-19T15:30:00.000Z"
time_total_hours: 13.5
time_entry_count: 5
time_last_entry: "2025-01-19T15:30:00.000Z"
time_today_hours: 1.5
time_timer_active: false
time_estimated_hours: 16
time_billable: true
time_hourly_rate: 150
time_currency: "USD"

# Project Management Integration
pmp_assignee: "john.doe@company.com"
pmp_assignee_role: "senior-developer"
pmp_assigned_at: "2025-01-15T09:30:00.000Z"
pmp_priority: "high"
pmp_priority_reason: "Customer deadline approaching"
pmp_priority_updated: "2025-01-17T10:00:00.000Z"
pmp_project_id: "PROJ-2025-Q1"
pmp_project_name: "Q1 Feature Release"
pmp_project_linked_at: "2025-01-15T09:30:00.000Z"
pmp_last_processed: "2025-01-19T16:00:00.000Z"
pmp_process_count: 15

# CI/CD Results
ci_results:
  tests_passed: true
  build_passed: true
  security_vulnerabilities: 0
  code_coverage: 87.5
  last_updated: "2025-01-19T15:15:00.000Z"
ci_deployments:
  - environment: "staging"
    version: "a1b2c3d4"
    deployed_at: "2025-01-19T15:30:00.000Z"
    deployed_by: "github-actions[bot]"
    status: "success"
  - environment: "production"
    version: "pending"
    scheduled_for: "2025-01-20T18:00:00.000Z"
    approval_required: true
    approvers: ["jane.smith", "bob.jones"]

# Custom Business Logic Fields
business_metadata:
  customer: "ACME Corporation"
  contract_id: "CTR-2024-0892"
  revenue_impact: 125000
  compliance_required: true
  compliance_standards: ["SOC2", "ISO27001"]
  risk_assessment: "medium"
  stakeholders:
    - name: "Product Owner"
      email: "po@company.com"
      role: "approver"
    - name: "Tech Lead"
      email: "tech.lead@company.com"
      role: "reviewer"
    - name: "Customer Success"
      email: "cs@company.com"
      role: "notified"

# Monitoring and Observability
monitoring:
  dashboards:
    - name: "Performance Metrics"
      url: "https://monitoring.company.com/d/task-999"
    - name: "Error Tracking"
      url: "https://sentry.company.com/issues/?query=task:999"
  alerts_configured: true
  sla_tracking: true
  uptime_requirement: 0.999
  response_time_p99_ms: 200

# Documentation and Knowledge Base
documentation:
  confluence_page: "https://company.atlassian.net/wiki/spaces/DEV/pages/123456/Task+999"
  api_docs: "https://api-docs.company.com/v2/endpoints/task-999"
  runbook: "https://runbooks.company.com/task-999-operations"
  architecture_diagram: "https://diagrams.company.com/task-999-architecture.png"
  recorded_demos:
    - title: "Feature Overview"
      url: "https://videos.company.com/task-999-overview"
      duration_minutes: 15
    - title: "Technical Deep Dive"
      url: "https://videos.company.com/task-999-technical"
      duration_minutes: 45

# External Tool Sync Metadata
_sync_metadata:
  last_full_sync: "2025-01-19T16:00:00.000Z"
  sync_sources: ["jira", "github", "autoagent", "time-tracker"]
  sync_errors: []
  sync_version: "2.0.0"
  next_sync_scheduled: "2025-01-19T17:00:00.000Z"

# Extension Points for Future Tools
_extensions:
  "com.company.custom-tool":
    version: "1.2.3"
    enabled: true
    config:
      feature_flags: ["new-ui", "advanced-analytics"]
  "io.analytics.tracker":
    metrics_collected: 1847
    last_report: "2025-01-19T12:00:00.000Z"
---

## Description

This is an example task demonstrating how multiple external tools can integrate with Simple Task Master using unknown fields. Each tool adds its own metadata without interfering with other tools or STM's core functionality.

### Integration Overview

This task is integrated with:
- **AutoAgent**: Automated task execution and monitoring
- **GitHub**: Source control and CI/CD pipeline tracking  
- **JIRA**: Project management and issue tracking
- **Time Tracking**: Hour logging and productivity metrics
- **Project Management**: Team assignments and prioritization
- **CI/CD Systems**: Build and deployment status
- **Business Systems**: Customer and revenue tracking
- **Monitoring**: Observability and performance tracking

## Details

### Technical Implementation

The implementation leverages STM's unknown field support to maintain tool-specific metadata:

1. **Namespacing**: Each tool uses a prefix (e.g., `autoagent_`, `github_`, `jira_`) to avoid conflicts
2. **Structured Data**: Complex data is stored as nested YAML objects
3. **Type Preservation**: Numbers, booleans, arrays, and objects maintain their types
4. **Sync Metadata**: `_sync_metadata` tracks cross-tool synchronization

### Data Flow

1. Developer updates code and pushes to GitHub
2. GitHub Actions workflow triggers and updates `github_*` fields
3. JIRA webhook receives GitHub events and updates `jira_*` fields
4. AutoAgent monitors task status and executes automated tests
5. Time tracking captures actual hours spent
6. All tools read/write their specific fields without conflicts

### Field Naming Patterns

- **Tool Prefixes**: `toolname_field` (e.g., `github_issue`)
- **Nested Objects**: Tool-specific configs and complex data
- **Private Fields**: Underscore prefix for internal metadata (`_sync_metadata`)
- **Arrays**: Lists of entries, history, or related items

## Validation

### Integration Testing

✅ All external tool fields are properly preserved through STM operations
✅ Field types (string, number, boolean, array, object) maintain integrity
✅ No conflicts between different tool namespaces
✅ Updates via CLI and API work correctly

### Performance Testing

- Task with 50+ unknown fields loads in <100ms
- YAML serialization handles deep nesting efficiently
- No memory leaks with large field values

### Manual Testing Checklist

- [ ] Create task via STM CLI
- [ ] Add AutoAgent fields via API
- [ ] Update GitHub fields via webhook
- [ ] Sync JIRA fields
- [ ] Log time entries
- [ ] Verify all fields persist after task updates
- [ ] Export task and reimport preserves all fields
- [ ] List command shows tasks with unknown fields