# Next Steps: Implementing the Pipeline Integration

All integration files have been created and committed to the repository. Here's what you need to do next to complete the integration.

## What's Been Done ✅

1. ✅ Created complete pipeline deployer module (`pipeline-deployer.js`)
2. ✅ Created integration code for devops-agent (`devops-agent-updates.js`)
3. ✅ Created Kubernetes ConfigMaps (system prompt + templates)
4. ✅ Created comprehensive documentation:
   - QUICK-START.md (30-minute guide)
   - IMPLEMENTATION-GUIDE.md (detailed guide)
   - IMPLEMENTATION-CHECKLIST.md (step-by-step)
   - INTEGRATION-SUMMARY.md (overview)
5. ✅ Committed and pushed to tbi-devops-environments repository

## What You Need to Do 🎯

Since the tbi-agent code is in a different repository (`tbi-devops-common`), you need to manually apply the integration. Follow one of these guides:

### Option 1: Quick Implementation (Recommended - 30 minutes)

Follow: `integration/tbi-agent-pipeline-integration/QUICK-START.md`

**Summary:**
```bash
# 1. Copy module
cp integration/tbi-agent-pipeline-integration/code-updates/pipeline-deployer.js \
   /Users/iakpabio/Desktop/git-code/tbi-code/tbi-devops-common/src/tbi-agent/

# 2. Install dependencies
cd /Users/iakpabio/Desktop/git-code/tbi-code/tbi-devops-common/src/tbi-agent
npm install simple-git js-yaml

# 3. Update devops-agent.js
# (Follow the guide for specific code changes)

# 4. Create ConfigMaps
kubectl create configmap tbi-agent-pipeline-config \
  --from-file=system-prompt.txt=<path-to-system-prompt.txt> \
  -n tbi-agent

kubectl create configmap tbi-agent-pipeline-templates \
  --from-file=<path-to-templates-dir> \
  -n tbi-agent

# 5. Update deployment.yaml
# (Add volume mounts and environment variables)

# 6. Deploy
git add . && git commit -m "Add pipeline deployment" && git push
```

### Option 2: Detailed Implementation (1.5 hours)

Follow: `integration/tbi-agent-pipeline-integration/IMPLEMENTATION-GUIDE.md`

Includes:
- Step-by-step instructions
- Verification at each step
- Troubleshooting guidance
- Testing procedures

### Option 3: Checklist-Driven (Flexible)

Follow: `integration/tbi-agent-pipeline-integration/IMPLEMENTATION-CHECKLIST.md`

Includes:
- Checkbox tracking
- Rollback plan
- Success criteria
- Notes section

## File Locations

All integration files are in:
```
/Users/iakpabio/Desktop/git-code/tbi-code/tbi-devops-environments/integration/tbi-agent-pipeline-integration/
```

### Key Files to Use:

1. **Code to Copy:**
   - `code-updates/pipeline-deployer.js` → Copy to tbi-agent/src/

2. **Code Changes to Apply:**
   - `code-updates/devops-agent-updates.js` → Reference for updating devops-agent.js

3. **ConfigMap Sources:**
   - `k8s-configmaps/system-prompt.txt` → For pipeline-config ConfigMap
   - `k8s-configmaps/templates/` → For pipeline-templates ConfigMap

4. **Documentation:**
   - `QUICK-START.md` → Fastest path (30 min)
   - `IMPLEMENTATION-GUIDE.md` → Detailed guide (1.5 hrs)
   - `IMPLEMENTATION-CHECKLIST.md` → Step-by-step checklist
   - `INTEGRATION-SUMMARY.md` → Overview and architecture

## Testing After Implementation

Once deployed, test with:

```
@tbi-agent create pipeline tbi-test-service redtag nodejs
```

Expected response (30-60 seconds):
```
✅ Successfully created CircleCI pipeline for tbi-test-service

Configuration:
- Namespace: redtag
- Technology: nodejs
- Files created: 15

tbi-devops-environments:
- dev/tbi-test-service/.circleci/config.yml
- dev/tbi-test-service/docker/Dockerfile
...

Next Steps:
1. Review generated files in repositories
2. Update secrets file with actual values
...
```

## Verification

After implementation, verify:

```bash
# Check pod is running
kubectl get pods -n tbi-agent

# Check logs for initialization
kubectl logs -n tbi-agent -l app=tbi-agent --tail=50 | grep "Pipeline deployer initialized"

# Check ConfigMaps exist
kubectl get configmap -n tbi-agent | grep pipeline

# Test command in Teams
@tbi-agent pipeline help
```

## Troubleshooting

If you encounter issues:

1. **Check pod logs:**
   ```bash
   kubectl logs -n tbi-agent -l app=tbi-agent --tail=100
   ```

2. **Verify ConfigMaps:**
   ```bash
   kubectl describe configmap tbi-agent-pipeline-config -n tbi-agent
   kubectl describe configmap tbi-agent-pipeline-templates -n tbi-agent
   ```

3. **Check secrets:**
   ```bash
   kubectl get secret tbi-agent-secrets -n tbi-agent -o yaml
   ```

4. **Review documentation:**
   - Check QUICK-START.md troubleshooting section
   - Review IMPLEMENTATION-GUIDE.md for detailed steps

## Support

If you need help:
1. Review the documentation in `integration/tbi-agent-pipeline-integration/`
2. Check the reference implementation: `dev/tbi-acc-hotel-mapping-service/`
3. Review the patterns: `.kiro/steering/circleci-pipeline-patterns.md`

## What This Enables

Once implemented, your team can:

✅ Create complete CI/CD pipelines in seconds via Teams
✅ Generate 15+ files following TBI best practices
✅ Ensure consistency across all services
✅ Reduce pipeline creation time by 80%
✅ Enable self-service for development teams

## Commands Available After Implementation

```bash
# Create pipeline
@tbi-agent create pipeline <service-name> <namespace> <tech-stack>

# Examples
@tbi-agent create pipeline tbi-booking-service redtag nodejs
@tbi-agent create pipeline tbi-api-gateway access python --port=8000

# Help
@tbi-agent pipeline help
```

## Timeline

- **Quick Start**: 30 minutes
- **Detailed Implementation**: 1.5 hours
- **Checklist-Driven**: Flexible (1-2 hours)

## Success Criteria

✅ Pod running without errors
✅ "Pipeline deployer initialized" in logs
✅ ConfigMaps mounted correctly
✅ Test command successful
✅ Files generated in repositories
✅ Team can use the feature

## Ready to Start?

1. Choose your implementation path (Quick Start recommended)
2. Open the corresponding guide
3. Follow the steps
4. Test the integration
5. Share with your team

---

**All files are ready. You just need to apply them to tbi-devops-common repository.**

**Start here:** `integration/tbi-agent-pipeline-integration/QUICK-START.md`