proagents 1.0.2 → 1.0.4

package/lib/commands/feature.js

@@ -77,7 +77,7 @@ function startFeature(name, activeFeaturesDir) {
   console.log('\n' + chalk.bold('Now use your AI assistant with this prompt:'));
   console.log(chalk.cyan('─'.repeat(50)));
   console.log(chalk.white(`
-/feature-start "${name}"
+pa:feature "${name}"
 
 Or paste this to your AI:
 

package/lib/commands/fix.js

@@ -24,7 +24,7 @@ export async function fixCommand(description, options = {}) {
     console.log(chalk.white('Use this prompt with your AI:'));
     console.log(chalk.cyan('─'.repeat(50)));
     console.log(chalk.white(`
-/feature-start "Fix: ${description}"
+pa:feature "Fix: ${description}"
 
 This bug fix has been upgraded to full workflow mode.
 Please follow all phases in ./proagents/WORKFLOW.md
@@ -39,7 +39,7 @@ Please follow all phases in ./proagents/WORKFLOW.md
   console.log(chalk.bold('Use this prompt with your AI assistant:'));
   console.log(chalk.cyan('─'.repeat(50)));
   console.log(chalk.white(`
-/fix "${description}"
+pa:fix "${description}"
 
 Or paste this to your AI:
 

package/lib/commands/help.js

@@ -39,17 +39,17 @@ export async function helpCommand() {
   console.log(chalk.cyan('proagents --version') + '         Show version');
   console.log('');
 
-  // Slash Commands
-  console.log(chalk.bold.white('Slash Commands (for AI Assistants)'));
+  // Commands for AI Assistants
+  console.log(chalk.bold.white('Commands (for AI Assistants)'));
   console.log(chalk.gray('─'.repeat(40)));
-  console.log(chalk.cyan('/init') + '                  Initialize ProAgents');
-  console.log(chalk.cyan('/feature-start "name"') + '  Start a feature');
-  console.log(chalk.cyan('/fix "description"') + '     Quick bug fix');
-  console.log(chalk.cyan('/status') + '                Check status');
-  console.log(chalk.cyan('/doc') + '                   Generate documentation');
-  console.log(chalk.cyan('/qa') + '                    Quality assurance');
-  console.log(chalk.cyan('/test') + '                  Run tests');
-  console.log(chalk.cyan('/deploy') + '                Deployment workflow');
+  console.log(chalk.cyan('pa:init') + '                Initialize ProAgents');
+  console.log(chalk.cyan('pa:feature "name"') + '      Start a feature');
+  console.log(chalk.cyan('pa:fix "description"') + '   Quick bug fix');
+  console.log(chalk.cyan('pa:status') + '              Check status');
+  console.log(chalk.cyan('pa:doc') + '                 Generate documentation');
+  console.log(chalk.cyan('pa:qa') + '                  Quality assurance');
+  console.log(chalk.cyan('pa:test') + '                Run tests');
+  console.log(chalk.cyan('pa:deploy') + '              Deployment workflow');
   console.log('');
 
   // Examples

package/lib/commands/init.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, cpSync, writeFileSync, readFileSync } from 'fs';
+import { existsSync, mkdirSync, cpSync, writeFileSync, readFileSync, readdirSync, rmSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import chalk from 'chalk';
@@ -6,6 +6,85 @@ import chalk from 'chalk';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
+// Files/folders to preserve during update (user customizations)
+const PRESERVE_PATHS = [
+  'active-features',           // User's work in progress
+  'proagents.config.yaml',     // User's configuration
+  '.learning',                 // Learned patterns
+  'cache',                     // Cached analysis
+];
+
+// Files that should always be updated (framework files)
+const FRAMEWORK_FOLDERS = [
+  'prompts',
+  'templates',
+  'checklists',
+  'standards',
+  'examples',
+  'git',
+  'ui-integration',
+  'workflow-modes',
+  'security',
+  'performance',
+  'testing-standards',
+  'patterns',
+  'scaffolding',
+  'cli',
+  'adr',
+  'ai-models',
+  'ai-training',
+  'api-versioning',
+  'approval-workflows',
+  'automation',
+  'changelog',
+  'cicd',
+  'collaboration',
+  'compliance',
+  'config-versioning',
+  'config',
+  'contract-testing',
+  'cost',
+  'database',
+  'dependency-management',
+  'disaster-recovery',
+  'environments',
+  'existing-projects',
+  'feature-flags',
+  'getting-started',
+  'i18n',
+  'ide-integration',
+  'integrations',
+  'learning',
+  'logging',
+  'mcp',
+  'metrics',
+  'migrations',
+  'monitoring',
+  'multi-project',
+  'notifications',
+  'offline-mode',
+  'parallel-features',
+  'plugins',
+  'pm-integration',
+  'reporting',
+  'reverse-engineering',
+  'rules',
+  'runbooks',
+  'secrets',
+  'team',
+  'troubleshooting',
+  'webhooks',
+];
+
+// Root files to always update
+const FRAMEWORK_FILES = [
+  'README.md',
+  'WORKFLOW.md',
+  'PROAGENTS.md',
+  'GETTING-STARTED-STORY.md',
+  'slash-commands.json',
+];
+
 /**
  * Initialize ProAgents in the current project
  */
@@ -18,16 +97,37 @@ export async function initCommand(options = {}) {
   console.log(chalk.blue('========================\n'));
 
   // Check if already initialized
-  if (existsSync(proagentsDir) && !options.force) {
-    console.log(chalk.yellow('⚠️  ProAgents is already initialized in this project.'));
-    console.log(chalk.gray('   Use --force to overwrite.\n'));
-    return;
+  const alreadyInitialized = existsSync(proagentsDir);
+
+  if (alreadyInitialized && !options.force) {
+    // Smart update mode - preserve user files, update framework
+    console.log(chalk.cyan('ℹ️  ProAgents detected. Running smart update...'));
+    console.log(chalk.gray('   (Preserving your customizations)\n'));
+
+    try {
+      await smartUpdate(sourceDir, proagentsDir);
+      console.log(chalk.green('\n✓ ProAgents updated successfully!\n'));
+      console.log(chalk.gray('Preserved:'));
+      console.log(chalk.gray('  • active-features/ (your work in progress)'));
+      console.log(chalk.gray('  • proagents.config.yaml (your configuration)'));
+      console.log(chalk.gray('  • .learning/ (learned patterns)'));
+      console.log(chalk.gray('  • cache/ (analysis cache)\n'));
+      return;
+    } catch (error) {
+      console.error(chalk.red('\n✗ Error updating ProAgents:'));
+      console.error(chalk.red(error.message));
+      process.exit(1);
+    }
   }
 
   try {
-    // Copy proagents folder
+    if (options.force && alreadyInitialized) {
+      console.log(chalk.yellow('⚠️  Force mode: Overwriting all files...'));
+    }
+
+    // Fresh install or force overwrite
     console.log(chalk.gray('Copying framework files...'));
-    cpSync(sourceDir, proagentsDir, { recursive: true, force: options.force || false });
+    cpSync(sourceDir, proagentsDir, { recursive: true, force: true });
     console.log(chalk.green('✓ Framework files copied to ./proagents/'));
 
     // Create config if not skipped
@@ -52,7 +152,6 @@ export async function initCommand(options = {}) {
     }
     if (!existsSync(releasesDir)) {
       mkdirSync(releasesDir, { recursive: true });
-      // Create releases index
       writeFileSync(join(releasesDir, 'README.md'),
 `# Release History
 
@@ -143,12 +242,10 @@ For detailed commands, see \`./proagents/PROAGENTS.md\`
     if (existsSync(readmePath)) {
       const readmeContent = readFileSync(readmePath, 'utf-8');
       if (!readmeContent.includes('PROAGENTS:START')) {
-        // Prepend to existing README
         writeFileSync(readmePath, proagentsSection + readmeContent);
         console.log(chalk.green('✓ Added ProAgents commands to README.md'));
       }
     } else {
-      // Create new README with ProAgents section
       writeFileSync(readmePath, proagentsSection + `# Project Name\n\nProject description.\n`);
       console.log(chalk.green('✓ Created README.md with ProAgents commands'));
     }
@@ -173,3 +270,60 @@ For detailed commands, see \`./proagents/PROAGENTS.md\`
     process.exit(1);
   }
 }
+
+/**
+ * Smart update - preserves user files, updates framework files
+ */
+async function smartUpdate(sourceDir, targetDir) {
+  // Backup preserved paths
+  const backups = {};
+  for (const path of PRESERVE_PATHS) {
+    const fullPath = join(targetDir, path);
+    if (existsSync(fullPath)) {
+      backups[path] = fullPath;
+    }
+  }
+
+  // Update framework folders
+  let updatedCount = 0;
+  for (const folder of FRAMEWORK_FOLDERS) {
+    const sourcePath = join(sourceDir, folder);
+    const targetPath = join(targetDir, folder);
+
+    if (existsSync(sourcePath)) {
+      // Remove old folder and copy new
+      if (existsSync(targetPath)) {
+        rmSync(targetPath, { recursive: true, force: true });
+      }
+      cpSync(sourcePath, targetPath, { recursive: true });
+      updatedCount++;
+    }
+  }
+  console.log(chalk.green(`✓ Updated ${updatedCount} framework folders`));
+
+  // Update framework root files
+  let filesUpdated = 0;
+  for (const file of FRAMEWORK_FILES) {
+    const sourcePath = join(sourceDir, file);
+    const targetPath = join(targetDir, file);
+
+    if (existsSync(sourcePath)) {
+      cpSync(sourcePath, targetPath, { force: true });
+      filesUpdated++;
+    }
+  }
+  console.log(chalk.green(`✓ Updated ${filesUpdated} framework files`));
+
+  // Ensure preserved paths still exist (they should, but just in case)
+  for (const [path, fullPath] of Object.entries(backups)) {
+    if (!existsSync(fullPath)) {
+      console.log(chalk.yellow(`⚠️  ${path} was removed during update, restoring...`));
+      // The backup reference is the same as the original, so if it doesn't exist
+      // it means we need to recreate the structure
+      if (path === 'active-features') {
+        mkdirSync(fullPath, { recursive: true });
+        writeFileSync(join(fullPath, '.gitkeep'), '');
+      }
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "proagents",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "AI-agnostic development workflow framework that automates the full software development lifecycle",
   "type": "module",
   "main": "lib/index.js",