kiro-spec-engine 1.2.2 → 1.3.0

package/lib/commands/workflows.js

@@ -0,0 +1,240 @@
+/**
+ * Workflows Command
+ * 
+ * Lists and displays manual workflow documentation
+ */
+
+const chalk = require('chalk');
+const fs = require('fs-extra');
+const path = require('path');
+
+/**
+ * Available workflows
+ */
+const WORKFLOWS = {
+  'task-sync': {
+    name: 'Task Sync Workflow',
+    description: 'Keep workspace synchronized with task progress',
+    timeEstimate: '30-60 seconds',
+    file: 'manual-workflows-guide.md',
+    section: 'task-sync-workflow'
+  },
+  'context-export': {
+    name: 'Context Export Workflow',
+    description: 'Export spec context for sharing',
+    timeEstimate: '15-45 seconds',
+    file: 'manual-workflows-guide.md',
+    section: 'context-export-workflow'
+  },
+  'prompt-generation': {
+    name: 'Prompt Generation Workflow',
+    description: 'Generate AI prompts for specific tasks',
+    timeEstimate: '20-30 seconds',
+    file: 'manual-workflows-guide.md',
+    section: 'prompt-generation-workflow'
+  },
+  'daily': {
+    name: 'Daily Workflow Checklist',
+    description: 'Complete daily workflow checklist',
+    timeEstimate: '2-3 minutes',
+    file: 'manual-workflows-guide.md',
+    section: 'daily-workflow-checklist'
+  },
+  'task-completion': {
+    name: 'Task Completion Checklist',
+    description: 'Checklist for completing a task',
+    timeEstimate: 'Varies',
+    file: 'manual-workflows-guide.md',
+    section: 'task-completion-checklist'
+  },
+  'spec-creation': {
+    name: 'Spec Creation Checklist',
+    description: 'Checklist for creating a new spec',
+    timeEstimate: '10-15 minutes',
+    file: 'manual-workflows-guide.md',
+    section: 'spec-creation-checklist'
+  }
+};
+
+/**
+ * List all available workflows
+ */
+async function listWorkflows() {
+  console.log(chalk.blue('📋 Available Workflows'));
+  console.log();
+  
+  Object.entries(WORKFLOWS).forEach(([id, workflow]) => {
+    console.log(chalk.cyan(`  ${id}`));
+    console.log(`    ${workflow.name}`);
+    console.log(chalk.gray(`    ${workflow.description}`));
+    console.log(chalk.gray(`    Time: ${workflow.timeEstimate}`));
+    console.log();
+  });
+  
+  console.log(chalk.gray('Run'), chalk.cyan('kse workflows show <workflow-id>'), chalk.gray('to view details'));
+  console.log(chalk.gray('Run'), chalk.cyan('kse workflows guide'), chalk.gray('to open full guide'));
+}
+
+/**
+ * Show specific workflow details
+ * 
+ * @param {string} workflowId - Workflow ID
+ */
+async function showWorkflow(workflowId) {
+  const workflow = WORKFLOWS[workflowId];
+  
+  if (!workflow) {
+    console.log(chalk.red('❌ Unknown workflow:'), workflowId);
+    console.log();
+    console.log(chalk.gray('Available workflows:'));
+    Object.keys(WORKFLOWS).forEach(id => {
+      console.log(chalk.gray(`  - ${id}`));
+    });
+    return;
+  }
+  
+  console.log(chalk.blue('📋'), chalk.bold(workflow.name));
+  console.log();
+  console.log(chalk.gray('Description:'), workflow.description);
+  console.log(chalk.gray('Time Estimate:'), workflow.timeEstimate);
+  console.log();
+  
+  // Try to read and display the workflow section
+  try {
+    const docsPath = path.join(__dirname, '../../docs', workflow.file);
+    
+    if (await fs.pathExists(docsPath)) {
+      console.log(chalk.blue('📖 Full documentation:'));
+      console.log(chalk.cyan(`  docs/${workflow.file}#${workflow.section}`));
+      console.log();
+      console.log(chalk.gray('Tip: Open the file in your editor for complete instructions'));
+    } else {
+      console.log(chalk.yellow('⚠️  Documentation file not found'));
+      console.log(chalk.gray(`  Expected: docs/${workflow.file}`));
+    }
+  } catch (error) {
+    console.log(chalk.yellow('⚠️  Could not read documentation'));
+  }
+}
+
+/**
+ * Open full workflows guide
+ */
+async function openGuide() {
+  const guidePath = path.join(__dirname, '../../docs/manual-workflows-guide.md');
+  
+  try {
+    if (await fs.pathExists(guidePath)) {
+      console.log(chalk.blue('📖 Manual Workflows Guide'));
+      console.log();
+      console.log(chalk.cyan('  docs/manual-workflows-guide.md'));
+      console.log();
+      console.log(chalk.gray('Open this file in your editor for complete workflow documentation'));
+      console.log();
+      console.log(chalk.blue('Contents:'));
+      console.log(chalk.gray('  - Task Sync Workflow'));
+      console.log(chalk.gray('  - Context Export Workflow'));
+      console.log(chalk.gray('  - Prompt Generation Workflow'));
+      console.log(chalk.gray('  - Workflow Checklists'));
+      console.log(chalk.gray('  - Time Estimates'));
+      console.log(chalk.gray('  - Troubleshooting'));
+    } else {
+      console.log(chalk.red('❌ Guide not found:'), 'docs/manual-workflows-guide.md');
+    }
+  } catch (error) {
+    console.log(chalk.red('❌ Error:'), error.message);
+  }
+}
+
+/**
+ * Track workflow completion
+ * 
+ * @param {string} workflowId - Workflow ID
+ */
+async function trackCompletion(workflowId) {
+  const workflow = WORKFLOWS[workflowId];
+  
+  if (!workflow) {
+    console.log(chalk.red('❌ Unknown workflow:'), workflowId);
+    return;
+  }
+  
+  console.log(chalk.green('✅'), chalk.bold(`${workflow.name} completed!`));
+  console.log();
+  console.log(chalk.gray('Time estimate:'), workflow.timeEstimate);
+  console.log();
+  console.log(chalk.blue('💡 Next steps:'));
+  
+  // Suggest next workflow based on current one
+  const suggestions = {
+    'task-sync': ['context-export', 'prompt-generation'],
+    'context-export': ['prompt-generation', 'task-completion'],
+    'prompt-generation': ['task-completion'],
+    'daily': ['task-sync', 'context-export'],
+    'task-completion': ['task-sync'],
+    'spec-creation': ['task-sync', 'prompt-generation']
+  };
+  
+  const nextWorkflows = suggestions[workflowId] || [];
+  
+  if (nextWorkflows.length > 0) {
+    nextWorkflows.forEach(nextId => {
+      const next = WORKFLOWS[nextId];
+      console.log(chalk.cyan(`  kse workflows show ${nextId}`), chalk.gray(`- ${next.name}`));
+    });
+  } else {
+    console.log(chalk.gray('  Continue with your work!'));
+  }
+}
+
+/**
+ * Main workflows command
+ * 
+ * @param {string} action - Action to perform (list, show, guide, complete)
+ * @param {string} workflowId - Workflow ID (for show/complete actions)
+ */
+async function workflowsCommand(action = 'list', workflowId = null) {
+  try {
+    switch (action) {
+      case 'list':
+        await listWorkflows();
+        break;
+      
+      case 'show':
+        if (!workflowId) {
+          console.log(chalk.red('❌ Workflow ID required'));
+          console.log(chalk.gray('Usage:'), chalk.cyan('kse workflows show <workflow-id>'));
+          return;
+        }
+        await showWorkflow(workflowId);
+        break;
+      
+      case 'guide':
+        await openGuide();
+        break;
+      
+      case 'complete':
+        if (!workflowId) {
+          console.log(chalk.red('❌ Workflow ID required'));
+          console.log(chalk.gray('Usage:'), chalk.cyan('kse workflows complete <workflow-id>'));
+          return;
+        }
+        await trackCompletion(workflowId);
+        break;
+      
+      default:
+        console.log(chalk.red('❌ Unknown action:'), action);
+        console.log();
+        console.log(chalk.gray('Available actions:'));
+        console.log(chalk.gray('  - list: List all workflows'));
+        console.log(chalk.gray('  - show <id>: Show workflow details'));
+        console.log(chalk.gray('  - guide: Open full guide'));
+        console.log(chalk.gray('  - complete <id>: Mark workflow as complete'));
+    }
+  } catch (error) {
+    console.log(chalk.red('❌ Error:'), error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = workflowsCommand;

package/lib/commands/workspace.js

@@ -0,0 +1,189 @@
+/**
+ * Workspace Command Group
+ * 
+ * Manages personal workspaces for multi-user collaboration
+ */
+
+const chalk = require('chalk');
+const WorkspaceManager = require('../workspace/workspace-manager');
+const WorkspaceSync = require('../workspace/workspace-sync');
+
+/**
+ * Initialize personal workspace
+ * 
+ * @param {Object} options - Command options
+ * @param {string} options.user - Override username
+ * @returns {Promise<void>}
+ */
+async function initWorkspace(options = {}) {
+  const projectPath = process.cwd();
+  const workspaceManager = new WorkspaceManager();
+  
+  console.log(chalk.red('🔥') + ' Initializing Personal Workspace');
+  console.log();
+  
+  try {
+    const username = options.user || await workspaceManager.detectUsername();
+    
+    if (!username) {
+      console.log(chalk.red('❌ Could not detect username'));
+      console.log();
+      console.log('Please configure git:');
+      console.log(chalk.cyan('  git config --global user.name "Your Name"'));
+      console.log();
+      console.log('Or specify username manually:');
+      console.log(chalk.cyan('  kse workspace init --user=yourname'));
+      return;
+    }
+    
+    console.log(`User: ${chalk.cyan(username)}`);
+    console.log();
+    
+    const result = await workspaceManager.initWorkspace(projectPath, username);
+    
+    if (result.success) {
+      console.log(chalk.green('✅ Workspace initialized successfully'));
+      console.log();
+      console.log(`Workspace path: ${chalk.gray(result.workspacePath)}`);
+      console.log();
+      console.log('Files created:');
+      console.log(`  ${chalk.gray('CURRENT_CONTEXT.md')} - Personal context`);
+      console.log(`  ${chalk.gray('task-state.json')} - Task tracking`);
+      console.log();
+      console.log('Next steps:');
+      console.log(`  ${chalk.cyan('kse task claim <spec-name> <task-id>')} - Claim a task`);
+      console.log(`  ${chalk.cyan('kse workspace sync')} - Sync with team`);
+    } else {
+      console.log(chalk.red('❌ Failed to initialize workspace'));
+      console.log();
+      console.log(`Error: ${result.error}`);
+    }
+  } catch (error) {
+    console.log(chalk.red('❌ Error:'), error.message);
+  }
+}
+
+/**
+ * Synchronize workspace with shared state
+ * 
+ * @param {Object} options - Command options
+ * @param {string} options.user - Override username
+ * @param {string} options.strategy - Conflict resolution strategy
+ * @returns {Promise<void>}
+ */
+async function syncWorkspace(options = {}) {
+  const projectPath = process.cwd();
+  const workspaceManager = new WorkspaceManager();
+  const workspaceSync = new WorkspaceSync();
+  
+  console.log(chalk.red('🔥') + ' Synchronizing Workspace');
+  console.log();
+  
+  try {
+    const username = options.user || await workspaceManager.detectUsername();
+    
+    if (!username) {
+      console.log(chalk.red('❌ Could not detect username'));
+      return;
+    }
+    
+    console.log(`User: ${chalk.cyan(username)}`);
+    console.log();
+    
+    // Check if workspace exists
+    const workspacePath = await workspaceManager.getWorkspacePath(projectPath, username);
+    const workspaceExists = await workspaceManager.workspaceExists(projectPath, username);
+    
+    if (!workspaceExists) {
+      console.log(chalk.yellow('⚠️  Workspace not initialized'));
+      console.log();
+      console.log('Run ' + chalk.cyan('kse workspace init') + ' first');
+      return;
+    }
+    
+    console.log('Syncing workspace...');
+    console.log();
+    
+    const result = await workspaceSync.syncWorkspace(
+      projectPath,
+      username,
+      { strategy: options.strategy }
+    );
+    
+    if (result.success) {
+      console.log(chalk.green('✅ Workspace synchronized'));
+      console.log();
+      
+      if (result.conflicts && result.conflicts.length > 0) {
+        console.log(chalk.yellow(`⚠️  ${result.conflicts.length} conflict(s) resolved`));
+        console.log();
+      }
+      
+      if (result.changes && result.changes.length > 0) {
+        console.log('Changes:');
+        for (const change of result.changes) {
+          console.log(`  ${chalk.gray('•')} ${change}`);
+        }
+        console.log();
+      }
+      
+      console.log(`Sync log: ${chalk.gray(result.logPath)}`);
+    } else {
+      console.log(chalk.red('❌ Sync failed'));
+      console.log();
+      console.log(`Error: ${result.error}`);
+    }
+  } catch (error) {
+    console.log(chalk.red('❌ Error:'), error.message);
+  }
+}
+
+/**
+ * List all workspaces
+ * 
+ * @param {Object} options - Command options
+ * @returns {Promise<void>}
+ */
+async function listWorkspaces(options = {}) {
+  const projectPath = process.cwd();
+  const workspaceManager = new WorkspaceManager();
+  
+  console.log(chalk.red('🔥') + ' Workspaces');
+  console.log();
+  
+  try {
+    const isMultiUser = await workspaceManager.isMultiUserMode(projectPath);
+    
+    if (!isMultiUser) {
+      console.log(chalk.gray('No workspaces found'));
+      console.log();
+      console.log('This project is in single-user mode.');
+      console.log('Run ' + chalk.cyan('kse workspace init') + ' to enable multi-user mode.');
+      return;
+    }
+    
+    const workspaces = await workspaceManager.listWorkspaces(projectPath);
+    
+    if (workspaces.length === 0) {
+      console.log(chalk.gray('No workspaces found'));
+      return;
+    }
+    
+    console.log(`Found ${chalk.cyan(workspaces.length)} workspace(s):`);
+    console.log();
+    
+    for (const username of workspaces) {
+      const workspacePath = await workspaceManager.getWorkspacePath(projectPath, username);
+      console.log(`  ${chalk.cyan('•')} ${username}`);
+      console.log(`    ${chalk.gray(workspacePath)}`);
+    }
+  } catch (error) {
+    console.log(chalk.red('❌ Error:'), error.message);
+  }
+}
+
+module.exports = {
+  initWorkspace,
+  syncWorkspace,
+  listWorkspaces
+};