Ai Cms Fresh Docker

AI-CMS - Context and Project Management Platform

Last Updated June 2, 2025 5:49 PM EST

🚀 One-command deployment of a complete AI-CMS instance with VS Code/Cursor IDE extensions.

📚 Complete Documentation: See AI-CMS-DOCUMENTATION.md{:target=“_blank”} for comprehensive API reference, GraphQL schema, and operational guides.

✨ Key Features

• 🔶 Deep Jira Integration: Native epic, user story, sprint management with real-time webhooks
• 🐙 GitHub Automation: Repository creation, branch management, deployment tracking
• 🖥️ IDE Extensions: Multiple VS Code/Cursor panels for enhanced productivity
• 🔍 AI-Powered Search: AutoRAG semantic documentation search
• 📊 Real-time Dashboards: Sprint progress, deployment status, project health
• ⚡ Automated Workflows: Project creation, sprint planning, deployment pipelines
• 🌐 Global Edge Deployment: Cloudflare Workers with sub-100ms response times

🚀 Quick Start

Prerequisites

1. Cloudflare Account with Workers, D1, R2, and AutoRAG access
2. Jira Instance (Atlassian Cloud or Server) with API access
3. GitHub Account with repository creation permissions
4. Docker installed on your system

Required Tokens

## Cloudflare (required)
export CLOUDFLARE_ACCOUNT_ID="your-cloudflare-account-id"
export CLOUDFLARE_API_TOKEN="your-cloudflare-api-token"

## Jira Integration (required)
export JIRA_DOMAIN="yourcompany.atlassian.net"
export JIRA_API_TOKEN="your-jira-api-token"
export JIRA_PROJECT_KEY="PROJ"

## GitHub Integration (required)
export GITHUB_TOKEN="ghp_your-github-token"

## Optional integrations
export SLACK_BOT_TOKEN="xoxb-your-slack-bot-token"

One-Command Deployment

docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -e SLACK_BOT_TOKEN="$SLACK_BOT_TOKEN" \
  ai-cms-fresh:latest

🏗️ What Gets Created

Cloudflare Infrastructure

• Worker: AI-CMS API with Jira and GitHub integration
• D1 Database: Complete schema with Jira epics, user stories, sprints, deployments
• KV Namespace: Caching layer for API responses
• R2 Bucket: File storage for project assets and documentation

Jira Integration

• Epic Tracking: Automatic epic creation and synchronization
• User Stories: Story point estimation and sprint assignment
• Sprint Management: Sprint planning, tracking, and completion
• Webhook Endpoints: Real-time updates from Jira to AI-CMS

GitHub Integration

• Repository Creation: Automatic project repository setup
• Branch Management: Feature branch creation linked to Jira issues
• Pull Request Tracking: PR status synchronized with Jira stories
• Webhook Endpoints: GitHub events trigger AI-CMS updates

IDE Extensions

• Jira Calendar Panel: Sprint timelines, milestones, and deadlines
• Project Architecture Panel: Repository structure and dependencies
• Sprint Dashboard: Current sprint progress and team velocity
• Deployment Panel: Deployment status, history, and rollback controls
• AutoRAG Search Panel: Intelligent documentation search

📊 API Overview

• GraphQL API: Complete CRUD operations with Jira and GitHub integration
• Webhook Endpoints: Real-time Jira and GitHub event processing
• IDE Integration: Multiple panel endpoints for VS Code/Cursor extensions
• AutoRAG Search: AI-powered documentation search and retrieval

📚 Full API Reference: See AI-CMS-DOCUMENTATION.md{:target=“_blank”} for complete endpoint documentation and GraphQL schema.

🔧 Configuration Options

Environment Variables

Variable	Required	Description	Example
CLOUDFLARE_ACCOUNT_ID	✅	Cloudflare account ID	abc123...
CLOUDFLARE_API_TOKEN	✅	API token with Workers, D1, R2, AutoRAG permissions	xyz789...
JIRA_DOMAIN	✅	Jira instance domain	company.atlassian.net
JIRA_API_TOKEN	✅	Jira API token	ATATT3x...
JIRA_PROJECT_KEY	✅	Jira project key	PROJ
GITHUB_TOKEN	✅	GitHub token with repo permissions	ghp_abc123...
INSTANCE_NAME	❌	Instance name	ai-cms
AUTORAG_INSTANCE_NAME	❌	AutoRAG instance name	ai-cms-docs
SLACK_CHANNEL_NAME	❌	Slack channel name	ai-cms
SLACK_BOT_TOKEN	❌	Slack bot token	xoxb-123...
ENVIRONMENT	❌	Deployment environment	production
DRY_RUN	❌	Test mode without creating resources	false

Advanced Configuration

## Custom instance configuration
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -e INSTANCE_NAME="my-project" \
  -e AUTORAG_INSTANCE_NAME="my-project-docs" \
  -e SLACK_CHANNEL_NAME="my-project-team" \
  -e ENVIRONMENT="staging" \
  ai-cms-fresh:latest

🧪 Testing Your Instance

Health Check

curl https://your-instance.workers.dev/health

GraphQL Query

curl -X POST https://your-instance.workers.dev/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query { 
      projects { 
        id 
        name 
        jira_project_key 
        github_repo_url 
      } 
    }"
  }'

IDE Integration Test

curl https://your-instance.workers.dev/ide/sidebar/context

Jira Webhook Test

curl -X POST https://your-instance.workers.dev/webhooks/jira \
  -H "Content-Type: application/json" \
  -d '{
    "webhookEvent": "jira:issue_created",
    "issue": {
      "key": "PROJ-123",
      "fields": {
        "summary": "Test issue"
      }
    }
  }'

🖥️ IDE Extension Setup

VS Code/Cursor Configuration

1. Install Recommended Extensions:

   code --install-extension atlassian.atlascode
   code --install-extension ms-vscode.vscode-slack
   code --install-extension ai-cms.project-intelligence
   

2. Configure Settings (add to settings.json):

   {
     "ai-cms.apiEndpoint": "https://your-instance.workers.dev",
     "ai-cms.jiraIntegration": {
       "domain": "yourcompany.atlassian.net",
       "projectKey": "PROJ",
       "enabled": true
     },
     "ai-cms.githubIntegration": {
       "enabled": true
     },
     "ai-cms.panels": {
       "jiraCalendar": true,
       "projectArchitecture": true,
       "sprintDashboard": true,
       "deploymentPanel": true,
       "autoragSearch": true
     }
   }
   

Available Panels

• 📅 Jira Calendar: Sprint timelines, milestones, and deadlines
• 🏗️ Project Architecture: Repository structure and dependencies
• 📊 Sprint Dashboard: Current sprint progress and team velocity
• 🚀 Deployment Panel: Deployment status, history, and rollback controls
• 🔍 AutoRAG Search: Intelligent documentation search and retrieval

⚡ Action Triggers

Built-in Workflows

1. Create Project:

   • Creates GitHub repository
   • Creates Jira epic
   • Sets up project calendar
   • Configures IDE workspace
   • Tracks initial deployment

2. Plan Sprint:

   • Analyzes epic breakdown
   • Estimates story points
   • Assigns team capacity
   • Creates sprint calendar
   • Updates IDE dashboard

3. Deploy Project:

   • Validates deployment readiness
   • Creates deployment record
   • Executes deployment
   • Updates deployment status
   • Notifies team completion

4. Start Thread:

   • Creates GitHub branch
   • Creates Jira subtask
   • Updates IDE sidebar
   • Links thread to repository

5. Close Thread:

   • Merges GitHub branch
   • Updates Jira issue status
   • Archives thread documentation
   • Updates sprint progress

Trigger Actions via GraphQL

mutation TriggerAction($action: String!, $params: String!) {
  triggerAction(action: $action, params: $params) {
    success
    message
    data
  }
}

🔄 Webhook Configuration

Jira Webhooks

Configure Jira webhooks to point to your instance:

Webhook URL: https://your-instance.workers.dev/webhooks/jira

Events:

• Issue created
• Issue updated
• Issue deleted
• Sprint started
• Sprint completed
• Epic created
• Epic updated

GitHub Webhooks

Configure GitHub webhooks for your repositories:

Webhook URL: https://your-instance.workers.dev/webhooks/github

Events:

• Push
• Pull request
• Issues
• Releases
• Deployments

📊 GraphQL Schema Overview

The AI-CMS Fresh GraphQL API provides comprehensive access to:

• Projects: Full project lifecycle with Jira epic and GitHub repository linking
• Jira Integration: Epics, user stories, sprints with real-time synchronization
• GitHub Integration: Repository management and deployment tracking
• Calendar Events: Sprint planning and milestone tracking
• IDE Context: Multi-panel configuration and state management

📚 Complete Schema: See AI-CMS-DOCUMENTATION.md{:target=“_blank”} for full GraphQL schema, input types, and example queries.

🛠️ Management Commands

Container Commands

## Check instance status
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  ai-cms-fresh:latest status

## Run comprehensive tests
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  ai-cms-fresh:latest test

## Show IDE setup instructions
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  ai-cms-fresh:latest setup-ide

## Clean up all resources
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  ai-cms-fresh:latest clean

🔒 Security & Permissions

Required Cloudflare Permissions

• Workers: Create and deploy workers
• D1: Create databases and execute queries
• KV: Create namespaces and manage keys
• R2: Create buckets and manage objects
• AutoRAG: Create and manage instances

Required Jira Permissions

• Project Administration: Access to project settings
• Issue Management: Create, read, update issues
• Sprint Management: Manage sprints and boards
• Webhook Configuration: Set up webhook endpoints

Required GitHub Permissions

• Repository Creation: Create new repositories
• Repository Administration: Manage repository settings
• Webhook Management: Configure repository webhooks
• Branch Protection: Manage branch protection rules

🚨 Troubleshooting

Common Issues

1. Jira Connection Failed

   # Verify Jira credentials
   curl -H "Authorization: Bearer $JIRA_API_TOKEN" \
     "https://$JIRA_DOMAIN/rest/api/3/myself"
   

2. GitHub Repository Creation Failed

   # Verify GitHub token permissions
   curl -H "Authorization: token $GITHUB_TOKEN" \
     "https://api.github.com/user"
   

3. Worker Deployment Failed

   # Check Cloudflare account permissions
   curl -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
     "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID"
   

4. IDE Extensions Not Working

   • Verify API endpoint is accessible
   • Check VS Code/Cursor extension settings
   • Ensure IDE configuration is properly applied

Debug Mode

## Run in dry-run mode to test configuration
docker run --rm \
  -e CLOUDFLARE_ACCOUNT_ID="$CLOUDFLARE_ACCOUNT_ID" \
  -e CLOUDFLARE_API_TOKEN="$CLOUDFLARE_API_TOKEN" \
  -e JIRA_DOMAIN="$JIRA_DOMAIN" \
  -e JIRA_API_TOKEN="$JIRA_API_TOKEN" \
  -e JIRA_PROJECT_KEY="$JIRA_PROJECT_KEY" \
  -e GITHUB_TOKEN="$GITHUB_TOKEN" \
  -e DRY_RUN="true" \
  ai-cms-fresh:latest

📈 Monitoring & Analytics

Built-in Metrics

• Deployment Success Rate: Track deployment success/failure rates
• Jira Sync Status: Monitor Jira webhook processing
• GitHub Integration Health: Track repository and webhook status
• IDE Usage Analytics: Monitor panel usage and user engagement
• AutoRAG Search Performance: Track search queries and results

Custom Dashboards

• Project Health Dashboard: Overall project status and metrics
• Sprint Progress Dashboard: Sprint burndown and velocity charts
• Deployment Pipeline Dashboard: Deployment frequency and success rates
• Team Productivity Dashboard: Issue completion and code commit metrics

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with dry-run mode
5. Submit a pull request

---

📄 License

MIT License with Attribution - see LICENSE{:target=“_blank”} file for details.

Attribution: When using AI-CMS, please include link to this repository.

🆘 Support

admin_at_adamic_dot_tech