s9n-devops-agent 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ScriptAutoCommit Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,318 @@
+# CS_DevOpsAgent 🚀
+
+[![npm version](https://badge.fury.io/js/s9n-devops-agent.svg)](https://badge.fury.io/js/s9n-devops-agent)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![GitHub](https://img.shields.io/badge/GitHub-Repository-blue)](https://github.com/SecondBrainAICo/CS_DevOpsAgent)
+
+An intelligent Git automation system with multi-agent support, session management, and seamless integration with AI coding assistants like Claude, GitHub Copilot, and Cursor.
+
+## 🔗 Quick Links
+
+- **GitHub Repository**: [https://github.com/SecondBrainAICo/CS_DevOpsAgent](https://github.com/SecondBrainAICo/CS_DevOpsAgent)
+- **NPM Package**: [https://www.npmjs.com/package/s9n-devops-agent](https://www.npmjs.com/package/s9n-devops-agent)
+- **Issues & Support**: [GitHub Issues](https://github.com/SecondBrainAICo/CS_DevOpsAgent/issues)
+- **Documentation**: [GitHub Wiki](https://github.com/SecondBrainAICo/CS_DevOpsAgent/wiki)
+
+## Features ✨
+
+- **🤖 Multi-Agent Support**: Work with Claude, GitHub Copilot, Cursor, and other AI coding assistants
+- **📁 Git Worktree Management**: Isolated workspaces for each session to prevent conflicts
+- **🔄 Automatic Commits & Push**: Monitors changes and commits with proper messages
+- **📅 Daily Version Rollover**: Automatic version management with customizable increments
+- **🎯 Session Management**: Create, manage, and track multiple development sessions
+- **⚙️ VS Code Integration**: Seamlessly integrates with VS Code tasks
+- **🔐 Safe Concurrent Development**: Multiple agents can work simultaneously without conflicts
+- **🏷️ Smart Branching**: Automatic branch creation with configurable naming patterns
+
+## Installation 📦
+
+### Option 1: NPM Package (Recommended for Users)
+
+#### Global Installation
+```bash
+npm install -g s9n-devops-agent
+```
+
+#### Local Installation
+```bash
+npm install s9n-devops-agent --save-dev
+```
+
+### Option 2: From Source (For Contributors)
+
+#### Clone the Repository
+```bash
+# Clone the repository
+git clone https://github.com/SecondBrainAICo/CS_DevOpsAgent.git
+cd CS_DevOpsAgent
+
+# Install dependencies
+npm install
+
+# Link globally for development
+npm link
+
+# Now you can use s9n-devops-agent command globally
+s9n-devops-agent --help
+```
+
+#### Development Setup
+```bash
+# Clone and setup for development
+git clone https://github.com/SecondBrainAICo/CS_DevOpsAgent.git
+cd CS_DevOpsAgent
+
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Start development session
+npm run dev
+```
+
+## Quick Start 🚀
+
+### First-Time Setup
+
+```bash
+# Run the interactive setup wizard
+s9n-devops-agent setup
+
+# This will configure:
+# - Your developer initials (used in branch names)
+# - Version numbering strategy
+# - Default timezone for daily rollover
+```
+
+### Start a DevOps Session
+
+```bash
+# Start the interactive session manager
+s9n-devops-agent start
+
+# Or create a new session directly
+s9n-devops-agent create --task "implement-api"
+```
+
+### Working with AI Assistants
+
+When you start a session, you'll receive instructions to paste into your AI assistant:
+
+```
+I'm working in a DevOps-managed session with the following setup:
+- Session ID: 8a3s-45b1
+- Working Directory: /path/to/worktree
+- Task: implement-api
+
+Please switch to this directory before making any changes:
+cd "/path/to/worktree"
+
+Write commit messages to: .devops-commit-8a3s-45b1.msg
+The DevOps agent will automatically commit and push changes.
+```
+
+## Commands 📝
+
+### Session Management
+
+```bash
+# Start interactive session manager
+s9n-devops-agent start
+
+# List all active sessions
+s9n-devops-agent list
+
+# Create a new session
+s9n-devops-agent create --task "feature-name" --agent claude
+
+# Close an active session
+s9n-devops-agent close <session-id>
+
+# Clean up stale sessions
+s9n-devops-agent cleanup
+```
+
+### Direct Operations
+
+```bash
+# Run the worker directly (for CI/CD)
+s9n-devops-agent worker
+
+# Manage worktrees
+s9n-devops-agent worktree create
+s9n-devops-agent worktree list
+
+# Run setup wizard
+s9n-devops-agent setup
+```
+
+## Configuration 🔧
+
+### Environment Variables
+
+```bash
+# Branch naming prefix
+export AC_BRANCH_PREFIX="dev_initials_"
+
+# Enable auto-push (default: true)
+export AC_PUSH=true
+
+# Enable debug logging
+export AC_DEBUG=true
+
+# Set timezone for daily rollover
+export AC_TZ="America/New_York"
+
+# Version configuration
+export AC_VERSION_PREFIX="v0."
+export AC_VERSION_START_MINOR="20"
+export AC_VERSION_INCREMENT="1"  # 1 = 0.01, 10 = 0.1
+```
+
+### Configuration Files
+
+Configuration is stored in:
+- **Global settings**: `~/.devops-agent/settings.json` (developer initials, email)
+- **Project settings**: `local_deploy/project-settings.json` (version strategy, auto-merge)
+
+## Workflow Example 💡
+
+1. **Start a Session**:
+   ```bash
+   s9n-devops-agent start
+   # Select: N) Create a new session
+   # Enter task: implement-authentication
+   ```
+
+2. **Copy Instructions to AI Assistant**:
+   - The tool provides instructions to paste into Claude/Copilot
+   - The AI works in the isolated worktree
+
+3. **AI Makes Changes**:
+   - AI writes code in the worktree directory
+   - Creates commit message in `.devops-commit-{session-id}.msg`
+
+4. **Automatic Processing**:
+   - Agent detects changes
+   - Reads commit message
+   - Commits and pushes automatically
+
+5. **Close Session**:
+   ```bash
+   s9n-devops-agent close
+   ```
+
+## VS Code Integration 🔌
+
+Add to `.vscode/tasks.json`:
+
+```json
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Start DevOps Agent",
+      "type": "shell",
+      "command": "s9n-devops-agent",
+      "args": ["start"],
+      "problemMatcher": [],
+      "isBackground": true
+    }
+  ]
+}
+```
+
+## Advanced Features 🔬
+
+### Multi-Agent Collaboration
+
+Multiple AI assistants can work on different features simultaneously:
+
+```bash
+# Terminal 1: Claude working on API
+s9n-devops-agent create --task "api-endpoints" --agent claude
+
+# Terminal 2: Copilot working on frontend
+s9n-devops-agent create --task "ui-components" --agent copilot
+
+# Each gets their own worktree and branch
+```
+
+### Custom Version Strategies
+
+Configure daily version increments:
+- `0.01` increments: v0.20 → v0.21 → v0.22
+- `0.1` increments: v0.20 → v0.30 → v0.40
+- `0.2` increments: v0.20 → v0.40 → v0.60
+
+### Automatic Daily Rollover
+
+At midnight (configurable timezone):
+1. Merges current day's work into version branch
+2. Creates new version branch (e.g., v0.21)
+3. Creates new daily branch
+4. Preserves work continuity
+
+## Platform Compatibility 🖥️
+
+- ✅ **Git Platforms**: GitHub, GitLab, Bitbucket, Gitea, self-hosted Git
+- ✅ **Operating Systems**: macOS, Linux, Windows (WSL recommended)
+- ✅ **AI Assistants**: Claude, GitHub Copilot, Cursor, Cody, any AI that can write files
+- ✅ **Node.js**: Version 16.0.0 or higher
+
+## Troubleshooting 🔍
+
+### Common Issues
+
+**Session files showing as uncommitted**:
+```bash
+# Files are automatically gitignored
+# If issue persists, run:
+s9n-devops-agent cleanup
+```
+
+**Permission denied errors**:
+```bash
+# Ensure scripts are executable
+chmod +x $(npm root -g)/s9n-devops-agent/bin/s9n-devops-agent
+```
+
+**Agent not detecting changes**:
+```bash
+# Check if running in correct directory
+pwd
+# Ensure message file exists
+ls -la .devops-commit-*.msg
+```
+
+## Contributing 🤝
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License 📄
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support 💬
+
+- 📧 Email: support@secondbrain.ai
+- 🐛 Issues: [GitHub Issues](https://github.com/SecondBrainAICo/CS_DevOpsAgent/issues)
+- 📖 Documentation: [GitHub Wiki](https://github.com/SecondBrainAICo/CS_DevOpsAgent/wiki)
+
+## Acknowledgments 🙏
+
+Built with ❤️ by [SecondBrain Labs](https://secondbrain.ai)
+
+Special thanks to all contributors and the open-source community.
+
+---
+
+**Copyright © 2024 SecondBrain Labs. All rights reserved.**

package/bin/cs-devops-agent

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+
+/**
+ * CS_DevOpsAgent CLI Entry Point
+ * This is the main executable when installed via npm
+ */
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { spawn } from 'child_process';
+import fs from 'fs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = join(__dirname, '..');
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+const command = args[0] || 'help';
+
+// Helper function to run a script
+function runScript(scriptPath, scriptArgs = []) {
+  const child = spawn('node', [scriptPath, ...scriptArgs], {
+    stdio: 'inherit',
+    cwd: process.cwd()
+  });
+  
+  child.on('exit', (code) => {
+    process.exit(code);
+  });
+}
+
+// Helper function to run a shell script
+function runShellScript(scriptPath, scriptArgs = []) {
+  const child = spawn('bash', [scriptPath, ...scriptArgs], {
+    stdio: 'inherit',
+    cwd: process.cwd()
+  });
+  
+  child.on('exit', (code) => {
+    process.exit(code);
+  });
+}
+
+// Command handlers
+switch(command) {
+  case 'start':
+  case 'session':
+    // Start interactive session manager
+    const sessionScript = join(rootDir, 'start-devops-session.sh');
+    if (fs.existsSync(sessionScript)) {
+      runShellScript(sessionScript, args.slice(1));
+    } else {
+      console.error('Session script not found. Please ensure the package is properly installed.');
+      process.exit(1);
+    }
+    break;
+    
+  case 'worker':
+    // Run the worker directly
+    runScript(join(rootDir, 'src', 'cs-devops-agent-worker.js'), args.slice(1));
+    break;
+    
+  case 'setup':
+    // Run setup wizard
+    runScript(join(rootDir, 'src', 'setup-cs-devops-agent.js'), args.slice(1));
+    break;
+    
+  case 'worktree':
+    // Manage worktrees
+    runScript(join(rootDir, 'src', 'worktree-manager.js'), args.slice(1));
+    break;
+    
+  case 'coordinator':
+    // Run session coordinator
+    runScript(join(rootDir, 'src', 'session-coordinator.js'), args.slice(1));
+    break;
+    
+  case 'list':
+    // List sessions
+    runScript(join(rootDir, 'src', 'session-coordinator.js'), ['list']);
+    break;
+    
+  case 'create':
+    // Create new session
+    runScript(join(rootDir, 'src', 'session-coordinator.js'), ['create', ...args.slice(1)]);
+    break;
+    
+  case 'close':
+    // Close session
+    runScript(join(rootDir, 'src', 'close-session.js'), args.slice(1));
+    break;
+    
+  case 'cleanup':
+    // Cleanup sessions
+    const cleanupScript = join(rootDir, 'cleanup-sessions.sh');
+    if (fs.existsSync(cleanupScript)) {
+      runShellScript(cleanupScript, args.slice(1));
+    } else {
+      console.error('Cleanup script not found.');
+      process.exit(1);
+    }
+    break;
+    
+  case 'version':
+  case '--version':
+  case '-v':
+    const packageJson = JSON.parse(fs.readFileSync(join(rootDir, 'package.json'), 'utf8'));
+    console.log(`CS_DevOpsAgent v${packageJson.version}`);
+    break;
+    
+  case 'help':
+  case '--help':
+  case '-h':
+  default:
+    console.log(`
+CS_DevOpsAgent - Intelligent Git Automation System
+Version: ${JSON.parse(fs.readFileSync(join(rootDir, 'package.json'), 'utf8')).version}
+
+Usage: cs-devops-agent [command] [options]
+
+Commands:
+  start, session     Start interactive DevOps session manager
+  worker            Run the DevOps agent worker directly  
+  setup             Run interactive setup wizard
+  worktree          Manage git worktrees for agents
+  coordinator       Session coordinator operations
+  list              List all active sessions
+  create            Create a new session
+  close             Close an active session
+  cleanup           Clean up stale sessions
+  version           Show version information
+  help              Show this help message
+
+Examples:
+  cs-devops-agent start              # Start interactive session manager
+  cs-devops-agent setup              # Run first-time setup
+  cs-devops-agent list               # List active sessions
+  cs-devops-agent create --task api  # Create new session for API work
+  cs-devops-agent worker             # Run worker directly
+
+Environment Variables:
+  AC_BRANCH_PREFIX     Branch prefix for daily branches
+  AC_PUSH             Enable auto-push (true/false)  
+  AC_DEBUG            Enable debug logging (true/false)
+  AC_TZ               Timezone for daily rollover
+
+For more information, visit: https://github.com/SecondBrainAICo/CS_DevOpsAgent
+    `);
+    break;
+}

package/cleanup-sessions.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+
+# ============================================================================
+# CLEANUP SCRIPT - Remove all worktrees and sessions
+# ============================================================================
+
+echo "🧹 Cleaning up all DevOps Agent sessions and worktrees..."
+echo
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# 1. List current worktrees
+echo -e "${YELLOW}Current worktrees:${NC}"
+git worktree list
+echo
+
+# 2. Remove git worktrees
+echo -e "${YELLOW}Removing git worktrees...${NC}"
+git worktree prune
+
+# Remove specific worktrees if they exist
+for worktree in $(git worktree list --porcelain | grep "worktree" | cut -d' ' -f2 | grep -v "$(git rev-parse --show-toplevel)$"); do
+    if [[ "$worktree" == *"worktrees"* ]] || [[ "$worktree" == *"local_deploy"* ]]; then
+        echo "Removing worktree: $worktree"
+        git worktree remove -f "$worktree" 2>/dev/null || true
+    fi
+done
+
+# 3. Clean up local_deploy directories
+echo -e "${YELLOW}Cleaning local_deploy directories...${NC}"
+rm -rf local_deploy/worktrees/* 2>/dev/null
+rm -rf local_deploy/session-locks/* 2>/dev/null
+rm -rf local_deploy/sessions/* 2>/dev/null
+rm -rf local_deploy/instructions/* 2>/dev/null
+rm -f local_deploy/claude-sessions.json 2>/dev/null
+rm -f local_deploy/.devops-sessions.json 2>/dev/null
+
+# 4. Clean up any worktrees in wrong locations
+echo -e "${YELLOW}Cleaning up misplaced worktrees...${NC}"
+rm -rf .worktrees 2>/dev/null
+rm -rf .session-locks 2>/dev/null
+rm -rf .claude-sessions.json 2>/dev/null
+rm -rf .devops-sessions 2>/dev/null
+rm -rf .claude-instructions 2>/dev/null
+
+# 5. Clean up git branches
+echo -e "${YELLOW}Cleaning up session branches...${NC}"
+for branch in $(git branch | grep -E "claude/|warp/|agent/" | tr -d ' '); do
+    echo "Deleting branch: $branch"
+    git branch -D "$branch" 2>/dev/null || true
+done
+
+# 6. Create clean local_deploy structure
+echo -e "${YELLOW}Creating clean directory structure...${NC}"
+mkdir -p local_deploy/worktrees
+mkdir -p local_deploy/session-locks
+mkdir -p local_deploy/sessions
+mkdir -p local_deploy/instructions
+mkdir -p local_deploy/logs
+
+echo -e "${GREEN}✅ Cleanup complete!${NC}"
+echo
+echo "You can now start fresh with:"
+echo "  npm start                  # Interactive session manager"
+echo "  ./start-devops-session.sh  # Same as npm start"
+echo

package/docs/PROJECT_INFO.md

@@ -0,0 +1,115 @@
+# Code Studio CS_DevOpsAgent Agent - Project Information
+
+## Repository Details
+
+- **GitHub Repository**: https://github.com/SecondBrainAICo/CS_DevOpsAgent
+- **Organization**: SecondBrain AI
+
+## Project Structure
+
+```
+CS_DevOpsAgent/
+├── src/                   # Source code files
+│   ├── cs-devops-agent-worker.js    # Main worker
+│   ├── setup-cs-devops-agent.js     # Setup wizard
+│   ├── worktree-manager.js          # Agent isolation
+│   └── run-with-agent.js            # Agent runner
+├── docs/                  # Documentation
+│   ├── PROJECT_INFO.md    # This file
+│   ├── TESTING.md         # Test guide
+│   └── infrastructure.md  # Change tracking
+├── test_scripts/         # Test scripts
+├── test_cases/          # Jest test cases
+├── deploy_test/         # Deployment tests
+├── package.json         # NPM configuration
+├── LICENSE              # MIT License
+├── README.md            # Main documentation
+└── .gitignore          # Git ignore rules
+```
+
+## Key Features
+
+- **Automatic Git Commits**: Watches for file changes and commit messages
+- **Daily Branching**: Creates daily development branches (dev_{initials}_YYYY-MM-DD)
+- **Version Management**: Micro-revision versioning (v0.20, v0.21, etc.)
+- **VS Code Integration**: Tasks and settings for seamless workflow
+- **Developer Personalization**: Each developer gets their own branch prefix
+- **Claude AI Integration**: Generates CLAUDE.md house rules for AI assistance
+
+## Quick Commands
+
+### Setup (for new projects)
+```bash
+# Clone to a new project
+git clone https://github.com/secondbrainAI-limited/code_studio_cs-devops-agentAgent.git CS_DevOpsAgent
+cd CS_DevOpsAgent
+./quick-start.sh
+```
+
+### Daily Usage
+```bash
+# Start the worker
+npm run cs-devops-agent
+
+# Create a commit message
+echo "feat(module): description" > .claude-commit-msg
+
+# Stop the worker
+pkill -f "node.*cs-devops-agent-worker"
+```
+
+## Git Commands
+
+### Push to GitHub
+```bash
+git push -u origin main
+```
+
+### Pull Latest Changes
+```bash
+git pull origin main
+```
+
+### Check Remote Status
+```bash
+git remote -v
+git branch -vv
+```
+
+## Environment Variables
+
+The system uses these environment variables (set during setup):
+
+- `AC_BRANCH_PREFIX`: Developer's branch prefix (e.g., dev_sdd_)
+- `AC_TZ`: Timezone for daily rollover (default: Asia/Dubai)
+- `AC_PUSH`: Auto-push to remote (default: true)
+- `AC_DEBUG`: Enable debug logging (default: false)
+
+## Development Workflow
+
+1. **Initial Setup**: Run `./quick-start.sh` in your project root
+2. **Start Worker**: `npm run cs-devops-agent`
+3. **Make Changes**: Edit your files normally
+4. **Commit**: Write message to `.claude-commit-msg`
+5. **Auto-Process**: Worker stages, commits, and pushes automatically
+6. **Daily Rollover**: Handled automatically at midnight
+
+## Integration with SecondBrain Projects
+
+This cs-devops-agent system is designed to work seamlessly with:
+- SecondBrain MVPEmails
+- DistilledConceptExtractor
+- Other SecondBrain Code Studio projects
+
+## Support
+
+- **Issues**: https://github.com/secondbrainAI-limited/code_studio_cs-devops-agentAgent/issues
+- **Organization**: https://github.com/secondbrainAI-limited
+
+## License
+
+MIT License - See LICENSE file for details
+
+---
+
+*Last Updated: 2025-09-25*