s9n-devops-agent 2.0.14 → 2.0.18-dev.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "s9n-devops-agent",
-  "version": "2.0.14",
+  "version": "2.0.18-dev.1",
   "description": "CS_DevOpsAgent - Intelligent Git Automation System with multi-agent support and session management",
   "type": "module",
   "main": "src/cs-devops-agent-worker.js",
@@ -12,8 +12,11 @@
     "src/",
     "scripts/",
     "docs/",
+    "House_Rules_Contracts/",
     "start-devops-session.sh",
     "cleanup-sessions.sh",
+    "houserules.md",
+    "houserules_structured.md",
     "LICENSE",
     "README.md"
   ],
@@ -25,6 +28,7 @@
     "devops:start": "node src/session-coordinator.js start",
     "devops:close": "node src/close-session.js",
     "devops:cleanup": "./cleanup-sessions.sh",
+    "chat": "node src/agent-chat.js",
     "setup": "node src/setup-cs-devops-agent.js",
     "house-rules:status": "node src/house-rules-manager.js status",
     "house-rules:update": "node src/house-rules-manager.js update",
@@ -33,7 +37,7 @@
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
     "test:worktree": "jest test_cases/worktree/",
-    "test:e2e": "./test_scripts/test-multi-agent-e2e.sh",
+    "test:e2e": "./test_scripts/test-e2e-multi-session.sh",
     "test:contracts": "jest tests/integration/contract-workflow.test.js",
     "test:push-behind": "jest test_scripts/push_behind_spec.js",
     "test:debug": "./debug-failing-tests.sh"

package/scripts/generate-ai-commit.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+
+/**
+ * ============================================================================
+ * AI COMMIT MESSAGE GENERATOR (via Groq/Llama 3)
+ * ============================================================================
+ * 
+ * Generates conventional commit messages by analyzing staged changes.
+ * Enforces project House Rules and commit conventions.
+ * 
+ * Usage:
+ *   node scripts/generate-ai-commit.js
+ *   node scripts/generate-ai-commit.js --dry-run
+ * 
+ * Configuration:
+ *   Requires GROQ_API_KEY in .env or environment
+ * ============================================================================
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import Groq from 'groq-sdk';
+import { credentialsManager } from '../src/credentials-manager.js';
+
+// Inject credentials
+credentialsManager.injectEnv();
+
+const CONFIG = {
+  model: 'llama-3.1-70b-versatile',
+  maxDiffLength: 12000, // Characters
+  houseRulesPath: 'houserules.md'
+};
+
+async function main() {
+  try {
+    // 1. Check for API Key
+    if (!process.env.GROQ_API_KEY) {
+      console.error('❌ GROQ_API_KEY not found. Cannot generate AI commit message.');
+      process.exit(1);
+    }
+
+    const groq = new Groq({ apiKey: process.env.GROQ_API_KEY });
+
+    // 2. Get Staged Diff
+    let diff = '';
+    try {
+      diff = execSync('git diff --cached', { encoding: 'utf8', maxBuffer: 1024 * 1024 });
+    } catch (e) {
+      console.error('❌ Failed to get git diff. Are there staged changes?');
+      process.exit(1);
+    }
+
+    if (!diff.trim()) {
+      console.log('ℹ️ No staged changes to analyze.');
+      process.exit(0);
+    }
+
+    // Truncate diff if too large
+    if (diff.length > CONFIG.maxDiffLength) {
+      diff = diff.substring(0, CONFIG.maxDiffLength) + '\n... (truncated)';
+    }
+
+    // 3. Read House Rules (if available)
+    let houseRules = '';
+    if (fs.existsSync(CONFIG.houseRulesPath)) {
+      houseRules = fs.readFileSync(CONFIG.houseRulesPath, 'utf8');
+      // Truncate house rules to essential sections if needed to save context
+      houseRules = houseRules.substring(0, 5000); 
+    }
+
+    // 4. Construct Prompt
+    const prompt = `
+You are a senior DevOps engineer and code reviewer.
+Generate a conventional commit message for the following git diff.
+
+CONTEXT:
+- Project uses Semantic Versioning.
+- Strict House Rules are in effect.
+
+HOUSE RULES SUMMARY:
+${houseRules}
+
+INSTRUCTIONS:
+1. Format: <type>(<scope>): <subject>
+2. Followed by a blank line and a bulleted list of changes.
+3. Type must be one of: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
+4. Scope is the affected module/component (optional).
+5. Subject must be imperative, lowercase, no period.
+6. Check the diff for any violations of House Rules (e.g. console.logs, hardcoded secrets) and mention them in the body if critical.
+7. Output ONLY the commit message. No markdown blocks, no conversational text.
+
+GIT DIFF:
+${diff}
+`;
+
+    // 5. Call AI
+    console.log('🤖 Analyzing changes with Llama 3...');
+    const completion = await groq.chat.completions.create({
+      messages: [
+        { role: 'system', content: 'You are a helpful coding assistant.' },
+        { role: 'user', content: prompt }
+      ],
+      model: CONFIG.model,
+      temperature: 0.2, // Low temperature for deterministic output
+      max_tokens: 500,
+    });
+
+    const commitMsg = completion.choices[0]?.message?.content?.trim();
+
+    if (!commitMsg) {
+      throw new Error('Received empty response from AI.');
+    }
+
+    // 6. Output or Save
+    // If --dry-run, just print
+    if (process.argv.includes('--dry-run')) {
+      console.log('\n--- Generated Message ---\n');
+      console.log(commitMsg);
+      console.log('\n-------------------------\n');
+    } else {
+      // Determine output file
+      const agentName = process.env.AGENT_NAME || 'claude';
+      const outputFile = `.${agentName.toLowerCase()}-commit-msg`;
+      fs.writeFileSync(outputFile, commitMsg);
+      console.log(`✅ Commit message written to ${outputFile}`);
+    }
+
+  } catch (error) {
+    console.error(`❌ Error generating commit message: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/scripts/local-install.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+
+# ============================================================================
+# Local Installation Helper
+# ============================================================================
+# Installs the current version of DevOps Agent into a target repository
+# for testing purposes without publishing to npm.
+# ============================================================================
+
+if [ -z "$1" ]; then
+  echo "Usage: $0 /path/to/target/repo"
+  echo "Example: $0 ../my-other-project"
+  exit 1
+fi
+
+TARGET_REPO=$(realpath "$1")
+CURRENT_DIR=$(pwd)
+
+echo "📦 Packaging DevOps Agent..."
+npm pack
+
+PACKAGE_FILE=$(ls s9n-devops-agent-*.tgz)
+
+if [ -z "$PACKAGE_FILE" ]; then
+  echo "❌ Error: Package file not found"
+  exit 1
+fi
+
+echo "🚀 Installing into $TARGET_REPO..."
+
+cd "$TARGET_REPO" || exit 1
+
+# Install the tarball
+npm install -g "$CURRENT_DIR/$PACKAGE_FILE"
+
+# Clean up
+cd "$CURRENT_DIR"
+rm "$PACKAGE_FILE"
+
+echo "✅ Installation complete!"
+echo "You can now run 's9n-devops-agent' or 'devops' in the target repository."
+echo "To test Kora, run: s9n-devops-agent chat"

package/src/agent-chat.js

@@ -0,0 +1,457 @@
+#!/usr/bin/env node
+
+/**
+ * ============================================================================
+ * SMART ASSISTANT - Conversational UX for DevOps Agent
+ * ============================================================================
+ * 
+ * This module provides a conversational interface (Chat UX) for the DevOps Agent.
+ * It uses Groq LLM to understand user intent and execute agent commands.
+ * 
+ * CAPABILITIES:
+ * - Answer questions about House Rules and Contracts
+ * - Help start sessions with proper naming and context
+ * - Analyze current project status
+ * - Guide users through the development workflow
+ * 
+ * ============================================================================
+ */
+
+import fs from 'fs';
+import path from 'path';
+import readline from 'readline';
+import Groq from 'groq-sdk';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { spawn } from 'child_process';
+import { credentialsManager } from './credentials-manager.js';
+import HouseRulesManager from './house-rules-manager.js';
+// We'll import SessionCoordinator dynamically to avoid circular deps if any
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Initialize credentials
+credentialsManager.injectEnv();
+
+const CONFIG = {
+  model: 'llama-3.3-70b-versatile',
+  colors: {
+    reset: '\x1b[0m',
+    bright: '\x1b[1m',
+    dim: '\x1b[2m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[36m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    red: '\x1b[31m'
+  }
+};
+
+class SmartAssistant {
+  constructor() {
+    this.groq = new Groq({
+      apiKey: process.env.GROQ_API_KEY || process.env.OPENAI_API_KEY
+    });
+    
+    this.history = [];
+    this.repoRoot = process.cwd();
+    this.houseRulesManager = new HouseRulesManager(this.repoRoot);
+    
+    // Tools definition for the LLM
+    this.tools = [
+      {
+        type: "function",
+        function: {
+          name: "get_house_rules_summary",
+          description: "Get a summary of the current project's House Rules and folder structure",
+          parameters: { type: "object", properties: {} }
+        }
+      },
+      {
+        type: "function",
+        function: {
+          name: "list_contracts",
+          description: "List all available contract files and their completion status",
+          parameters: { type: "object", properties: {} }
+        }
+      },
+      {
+        type: "function",
+        function: {
+          name: "start_session",
+          description: "Start a new development session with a specific task name",
+          parameters: {
+            type: "object",
+            properties: {
+              taskName: { type: "string", description: "The name of the task (kebab-case preferred)" },
+              description: { type: "string", description: "Brief description of the task" }
+            },
+            required: ["taskName"]
+          }
+        }
+      },
+      {
+        type: "function",
+        function: {
+          name: "check_session_status",
+          description: "Check the status of active sessions and locks",
+          parameters: { type: "object", properties: {} }
+        }
+      }
+    ];
+
+    this.systemPrompt = `You are Kora, the Smart DevOps Assistant. 
+Your goal is to help developers follow the House Rules and Contract System while being helpful and efficient.
+
+CONTEXT:
+- You are running inside a "DevOps Agent" environment.
+- The project follows a strict "Contract System" (API, DB, Features, etc.).
+- Users need to create "Sessions" to do work.
+- You can execute tools to help the user.
+
+STYLE:
+- Be concise but helpful.
+- Identify yourself as "Kora".
+- If the user asks about starting a task, ask for a clear task name if not provided.
+- If the user asks about rules, summarize them from the actual files.
+- Always prefer "Structured" organization for new code.
+
+When you want to perform an action, use the available tools.`;
+  }
+
+  /**
+   * Initialize the chat session
+   */
+  async start() {
+    // Check for Groq API Key
+    if (!credentialsManager.hasGroqApiKey()) {
+      console.log('\n' + '='.repeat(60));
+      console.log(`${CONFIG.colors.yellow}⚠️  GROQ API KEY MISSING${CONFIG.colors.reset}`);
+      console.log('='.repeat(60));
+      console.log('\nTo use Kora (Smart DevOps Assistant), you need a Groq API key.');
+      console.log('It allows Kora to understand your requests and help you manage sessions.\n');
+      
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+
+      console.log(`${CONFIG.colors.bright}How to get a key:${CONFIG.colors.reset}`);
+      console.log(`1. Go to: ${CONFIG.colors.cyan}https://console.groq.com/keys${CONFIG.colors.reset}`);
+      console.log('2. Log in or sign up');
+      console.log('3. Click "Create API Key"');
+      console.log('4. Copy the key and paste it below\n');
+
+      const apiKey = await new Promise((resolve) => {
+        rl.question(`${CONFIG.colors.green}Enter your Groq API Key: ${CONFIG.colors.reset}`, (answer) => {
+          resolve(answer.trim());
+        });
+      });
+
+      if (apiKey) {
+        credentialsManager.setGroqApiKey(apiKey);
+        // Re-initialize Groq client with new key
+        this.groq = new Groq({
+          apiKey: apiKey
+        });
+        console.log(`\n${CONFIG.colors.green}✅ API Key saved successfully!${CONFIG.colors.reset}\n`);
+      } else {
+        console.log(`\n${CONFIG.colors.red}❌ No key provided. Exiting.${CONFIG.colors.reset}`);
+        process.exit(1);
+      }
+      rl.close();
+    }
+
+    console.log('\n' + '='.repeat(60));
+    console.log(`${CONFIG.colors.magenta}🤖 Kora - Smart DevOps Assistant${CONFIG.colors.reset}`);
+    console.log(`${CONFIG.colors.dim}Powered by Groq (${CONFIG.model})${CONFIG.colors.reset}`);
+    console.log('='.repeat(60));
+    console.log(`\n${CONFIG.colors.cyan}Hi! I'm Kora. How can I help you today?${CONFIG.colors.reset}`);
+    console.log(`${CONFIG.colors.dim}(Try: "Start a new task for login", "Explain house rules", "Check contracts")${CONFIG.colors.reset}\n`);
+
+    this.startReadline();
+  }
+
+  startReadline() {
+    if (this.rl) {
+      this.rl.close();
+    }
+
+    this.rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      prompt: `${CONFIG.colors.green}You > ${CONFIG.colors.reset}`
+    });
+
+    this.rl.prompt();
+
+    this.rl.on('line', async (line) => {
+      const input = line.trim();
+      if (!input) {
+        this.rl.prompt();
+        return;
+      }
+
+      if (input.toLowerCase() === 'exit' || input.toLowerCase() === 'quit') {
+        console.log(`${CONFIG.colors.magenta}Goodbye!${CONFIG.colors.reset}`);
+        process.exit(0);
+      }
+
+      await this.handleUserMessage(input);
+      // Only prompt if rl is still active (it might be closed if starting a session)
+      if (this.rl && !this.rl.closed) {
+        this.rl.prompt();
+      }
+    });
+  }
+
+  /**
+   * Handle a user message through the LLM
+   */
+  async handleUserMessage(content) {
+    // Add user message to history
+    this.history.push({ role: 'user', content });
+
+    // Pause readline while thinking/executing
+    if (this.rl) {
+      this.rl.pause();
+    }
+
+    try {
+      process.stdout.write(`${CONFIG.colors.dim}Thinking...${CONFIG.colors.reset}`);
+      
+      const response = await this.groq.chat.completions.create({
+        model: CONFIG.model,
+        messages: [
+          { role: 'system', content: this.systemPrompt },
+          ...this.history
+        ],
+        tools: this.tools,
+        tool_choice: "auto",
+        temperature: 0.5,
+        max_tokens: 1024
+      });
+
+      const message = response.choices[0].message;
+      
+      // Clear "Thinking..."
+      readline.cursorTo(process.stdout, 0);
+      readline.clearLine(process.stdout, 0);
+
+      if (message.tool_calls) {
+        // Handle tool calls
+        await this.handleToolCalls(message.tool_calls);
+      } else {
+        // Just a text response
+        console.log(`${CONFIG.colors.magenta}Kora > ${CONFIG.colors.reset}${message.content}\n`);
+        this.history.push(message);
+      }
+    } catch (error) {
+      readline.cursorTo(process.stdout, 0);
+      readline.clearLine(process.stdout, 0);
+      console.error(`${CONFIG.colors.red}Error: ${error.message}${CONFIG.colors.reset}\n`);
+    } finally {
+      // Resume readline if it exists and we're not starting a session (which handles its own RL)
+      if (this.rl && !this.rl.closed) {
+        this.rl.resume();
+      }
+    }
+  }
+
+  /**
+   * Execute tool calls from the LLM
+   */
+  async handleToolCalls(toolCalls) {
+    // Add the assistant's message with tool calls to history
+    this.history.push({
+      role: 'assistant',
+      content: null,
+      tool_calls: toolCalls
+    });
+
+    for (const toolCall of toolCalls) {
+      const functionName = toolCall.function.name;
+      const args = JSON.parse(toolCall.function.arguments);
+      
+      console.log(`${CONFIG.colors.dim}Executing: ${functionName}...${CONFIG.colors.reset}`);
+      
+      let result;
+      try {
+        switch (functionName) {
+          case 'get_house_rules_summary':
+            result = await this.getHouseRulesSummary();
+            break;
+          case 'list_contracts':
+            result = await this.listContracts();
+            break;
+          case 'check_session_status':
+            result = await this.checkSessionStatus();
+            break;
+          case 'start_session':
+            result = await this.startSession(args);
+            break;
+          default:
+            result = JSON.stringify({ error: "Unknown tool" });
+        }
+      } catch (err) {
+        result = JSON.stringify({ error: err.message });
+      }
+
+      // Add tool result to history
+      this.history.push({
+        tool_call_id: toolCall.id,
+        role: "tool",
+        name: functionName,
+        content: result
+      });
+    }
+
+    // Get final response from LLM after tool execution
+    try {
+      const response = await this.groq.chat.completions.create({
+        model: CONFIG.model,
+        messages: [
+          { role: 'system', content: this.systemPrompt },
+          ...this.history
+        ]
+      });
+
+      const finalMessage = response.choices[0].message;
+      console.log(`${CONFIG.colors.magenta}Kora > ${CONFIG.colors.reset}${finalMessage.content}\n`);
+      this.history.push(finalMessage);
+
+    } catch (error) {
+      console.error(`${CONFIG.colors.red}Error getting final response: ${error.message}${CONFIG.colors.reset}`);
+    }
+  }
+
+  // ==========================================================================
+  // TOOL IMPLEMENTATIONS
+  // ==========================================================================
+
+  async getHouseRulesSummary() {
+    const status = this.houseRulesManager.getStatus();
+    const rulesPath = this.houseRulesManager.houseRulesPath;
+    
+    if (fs.existsSync(rulesPath)) {
+      const content = fs.readFileSync(rulesPath, 'utf8');
+      // Extract first 50 lines or so for context
+      const summary = content.split('\n').slice(0, 50).join('\n');
+      return JSON.stringify({
+        exists: true,
+        status: status,
+        preview: summary,
+        path: rulesPath
+      });
+    }
+    return JSON.stringify({ exists: false, message: "House Rules file not found." });
+  }
+
+  async listContracts() {
+    const contractsDir = path.join(this.repoRoot, 'House_Rules_Contracts');
+    if (!fs.existsSync(contractsDir)) {
+      return JSON.stringify({ exists: false, message: "Contracts folder not found." });
+    }
+
+    const files = fs.readdirSync(contractsDir).filter(f => f.endsWith('.md') || f.endsWith('.json'));
+    return JSON.stringify({
+      exists: true,
+      files: files,
+      location: contractsDir
+    });
+  }
+
+  async checkSessionStatus() {
+    // We need to import SessionCoordinator here to avoid top-level await/circular deps issues
+    // Note: In a real implementation we might want to refactor SessionCoordinator to be more modular
+    // For now, we'll check the file system directly which is safer/faster for this tool
+    
+    const sessionsDir = path.join(this.repoRoot, 'local_deploy/sessions');
+    const locksDir = path.join(this.repoRoot, 'local_deploy/session-locks');
+    
+    let activeSessions = [];
+    let activeLocks = [];
+
+    if (fs.existsSync(sessionsDir)) {
+      activeSessions = fs.readdirSync(sessionsDir).filter(f => f.endsWith('.json'));
+    }
+
+    if (fs.existsSync(locksDir)) {
+      activeLocks = fs.readdirSync(locksDir);
+    }
+
+    return JSON.stringify({
+      activeSessionsCount: activeSessions.length,
+      activeLocksCount: activeLocks.length,
+      sessions: activeSessions,
+      locks: activeLocks
+    });
+  }
+
+  async startSession(args) {
+    const taskName = args.taskName;
+    
+    console.log(`${CONFIG.colors.magenta}Kora > ${CONFIG.colors.reset}Starting new session for: ${taskName}...`);
+    
+    // Close readline interface to release stdin for the child process
+    if (this.rl) {
+      this.rl.close();
+      this.rl = null;
+    }
+
+    // We need to run the session coordinator interactively
+    // We'll use the 'create-and-start' command to jump straight to the task
+    const scriptPath = path.join(__dirname, 'session-coordinator.js');
+    
+    return new Promise((resolve, reject) => {
+      // Use 'inherit' for stdio to allow interactive input/output
+      const child = spawn('node', [scriptPath, 'create-and-start', '--task', taskName], {
+        stdio: 'inherit',
+        cwd: this.repoRoot
+      });
+      
+      child.on('close', (code) => {
+        // Re-initialize readline interface after child process exits
+        this.startReadline();
+
+        if (code === 0) {
+          resolve(JSON.stringify({
+            success: true,
+            message: `Session for '${taskName}' completed successfully.`
+          }));
+        } else {
+          resolve(JSON.stringify({
+            success: false,
+            message: `Session process exited with code ${code}.`
+          }));
+        }
+        
+        // Resume the chat interface after the child process exits
+        console.log(`\n${CONFIG.colors.cyan}Welcome back to Kora!${CONFIG.colors.reset}`);
+      });
+      
+      child.on('error', (err) => {
+        // Re-initialize readline interface on error
+        this.startReadline();
+        
+        resolve(JSON.stringify({
+          success: false,
+          error: err.message
+        }));
+      });
+    });
+  }
+}
+
+export { SmartAssistant };
+
+// Run the assistant only if executed directly
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  const assistant = new SmartAssistant();
+  assistant.start().catch(err => {
+    console.error('Fatal Error:', err);
+    process.exit(1);
+  });
+}

package/src/credentials-manager.js

@@ -7,7 +7,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const rootDir = path.join(__dirname, '..');
 
-const CREDENTIALS_PATH = path.join(rootDir, 'local_deploy', 'credentials.json');
+const CREDENTIALS_PATH = process.env.DEVOPS_CREDENTIALS_PATH || path.join(rootDir, 'local_deploy', 'credentials.json');
 
 // Simple obfuscation to prevent casual shoulder surfing
 // NOTE: This is NOT strong encryption. In a production environment with sensitive keys,