proagents 1.0.9 → 1.0.11

package/lib/commands/init.js

@@ -3,6 +3,7 @@ import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import chalk from 'chalk';
 import yaml from 'js-yaml';
+import { selectPlatforms, copyPlatformFiles, savePlatformConfig, loadPlatformConfig } from './ai.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -79,18 +80,14 @@ const FRAMEWORK_FOLDERS = [
   'webhooks',
 ];
 
-// Root files to always update
+// Root files to always update (AI files handled separately via platform selection)
 const FRAMEWORK_FILES = [
   'README.md',
   'WORKFLOW.md',
   'PROAGENTS.md',
   'GETTING-STARTED-STORY.md',
   'slash-commands.json',
-  'CLAUDE.md',
-  '.cursorrules',
-  'AI_INSTRUCTIONS.md',
-  'GEMINI.md',
-  'CHATGPT.md',
+  'AI_INSTRUCTIONS.md',  // Universal instructions kept for reference
 ];
 
 /**
@@ -258,34 +255,22 @@ For detailed commands, see \`./proagents/PROAGENTS.md\`
       console.log(chalk.green('✓ Created README.md with ProAgents commands'));
     }
 
-    // Copy AI instruction files to project root (for AI platform recognition)
-    const aiFiles = [
-      { src: 'CLAUDE.md', target: 'CLAUDE.md', desc: 'Claude AI' },
-      { src: '.cursorrules', target: '.cursorrules', desc: 'Cursor AI' },
-      { src: 'GEMINI.md', target: 'GEMINI.md', desc: 'Gemini AI' },
-      { src: 'CHATGPT.md', target: 'CHATGPT.md', desc: 'ChatGPT/Codex' },
-    ];
-
-    for (const file of aiFiles) {
-      const sourcePath = join(sourceDir, file.src);
-      const targetPath = join(targetDir, file.target);
-      if (existsSync(sourcePath) && !existsSync(targetPath)) {
-        cpSync(sourcePath, targetPath);
-        console.log(chalk.green(`✓ Created ${file.target} (for ${file.desc} recognition)`));
-      }
-    }
+    // Interactive AI platform selection
+    const selectedPlatforms = await selectPlatforms();
 
-    // Copy .github/copilot-instructions.md for GitHub Copilot
-    const copilotSource = join(sourceDir, '.github', 'copilot-instructions.md');
-    const githubDir = join(targetDir, '.github');
-    const copilotTarget = join(githubDir, 'copilot-instructions.md');
-    if (existsSync(copilotSource) && !existsSync(copilotTarget)) {
-      if (!existsSync(githubDir)) {
-        mkdirSync(githubDir, { recursive: true });
-      }
-      cpSync(copilotSource, copilotTarget);
-      console.log(chalk.green('✓ Created .github/copilot-instructions.md (for GitHub Copilot)'));
+    // Copy AI instruction files for selected platforms
+    const aiResults = copyPlatformFiles(selectedPlatforms, sourceDir, targetDir);
+
+    if (aiResults.created.length > 0) {
+      console.log(chalk.green(`✓ Created AI files: ${aiResults.created.join(', ')}`));
     }
+    if (aiResults.skipped.length > 0) {
+      console.log(chalk.yellow(`⚠️  Skipped (already exist): ${aiResults.skipped.join(', ')}`));
+    }
+
+    // Save selected platforms to config
+    const configPath = join(proagentsDir, 'proagents.config.yaml');
+    savePlatformConfig(selectedPlatforms, configPath);
 
     // Success message
     console.log(chalk.green('\n✓ ProAgents initialized successfully!\n'));
@@ -398,44 +383,23 @@ async function smartUpdate(sourceDir, targetDir) {
     }
   }
 
-  // Copy AI instruction files to project root (for AI platform recognition)
+  // Copy AI instruction files for configured platforms (only if they don't exist)
   const projectRoot = join(targetDir, '..');
-  const aiFiles = [
-    'CLAUDE.md',
-    '.cursorrules',
-    'AI_INSTRUCTIONS.md',
-    'GEMINI.md',
-    'CHATGPT.md',
-  ];
-  let aiFilesUpdated = 0;
-
-  for (const file of aiFiles) {
-    const sourcePath = join(sourceDir, file);
-    const targetPath = join(projectRoot, file);
+  const configPath = join(targetDir, 'proagents.config.yaml');
+  const selectedPlatforms = loadPlatformConfig(configPath);
 
-    if (existsSync(sourcePath)) {
-      cpSync(sourcePath, targetPath, { force: true });
-      aiFilesUpdated++;
-    }
-  }
+  if (selectedPlatforms.length > 0) {
+    const aiResults = copyPlatformFiles(selectedPlatforms, sourceDir, projectRoot);
 
-  // Handle .github/copilot-instructions.md separately (needs directory creation)
-  const copilotSource = join(sourceDir, '.github', 'copilot-instructions.md');
-  const githubDir = join(projectRoot, '.github');
-  const copilotTarget = join(githubDir, 'copilot-instructions.md');
-
-  if (existsSync(copilotSource)) {
-    if (!existsSync(githubDir)) {
-      mkdirSync(githubDir, { recursive: true });
+    if (aiResults.created.length > 0) {
+      console.log(chalk.green(`✓ Created new AI files: ${aiResults.created.join(', ')}`));
+    }
+    if (aiResults.skipped.length > 0) {
+      console.log(chalk.gray(`ℹ️  Preserved existing: ${aiResults.skipped.join(', ')}`));
     }
-    cpSync(copilotSource, copilotTarget, { force: true });
-    aiFilesUpdated++;
   }
 
-  if (aiFilesUpdated > 0) {
-    console.log(chalk.green(`✓ Updated ${aiFilesUpdated} AI instruction files`));
-    console.log(chalk.gray('   (CLAUDE.md, .cursorrules, GEMINI.md, CHATGPT.md, .github/copilot-instructions.md)'));
-  }
+  console.log(chalk.gray('\nTip: Use "proagents ai add" to add more AI platforms'));
 }
 
 /**

package/lib/commands/uninstall.js

@@ -0,0 +1,178 @@
+import { existsSync, rmSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { createInterface } from 'readline';
+import chalk from 'chalk';
+
+// AI instruction files that may have been copied to project root
+const AI_FILES = [
+  'CLAUDE.md',
+  '.cursorrules',
+  '.windsurfrules',
+  'GEMINI.md',
+  'CHATGPT.md',
+  'KIRO.md',
+  'REPLIT.md',
+  'BOLT.md',
+  'LOVABLE.md',
+  'GROQ.md',
+  'ANTIGRAVITY.md',
+  'AI_INSTRUCTIONS.md',
+];
+
+/**
+ * Command: proagents uninstall
+ */
+export async function uninstallCommand(options = {}) {
+  const targetDir = process.cwd();
+  const proagentsDir = join(targetDir, 'proagents');
+
+  console.log('\n' + chalk.bold.red('ProAgents Uninstall'));
+  console.log(chalk.red('===================\n'));
+
+  // Check if ProAgents is installed
+  if (!existsSync(proagentsDir)) {
+    console.log(chalk.yellow('ProAgents is not installed in this project.\n'));
+    return;
+  }
+
+  // Confirm unless --force is used
+  if (!options.force) {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+
+    const question = (prompt) => new Promise(resolve => rl.question(prompt, resolve));
+
+    console.log(chalk.yellow('This will remove:'));
+    console.log(chalk.gray('  • ./proagents/ folder'));
+    console.log(chalk.gray('  • AI instruction files (CLAUDE.md, .cursorrules, etc.)'));
+    console.log(chalk.gray('  • ProAgents section from README.md\n'));
+
+    const answer = await question(chalk.yellow('Are you sure? (yes/no): '));
+    rl.close();
+
+    if (answer.toLowerCase() !== 'yes' && answer.toLowerCase() !== 'y') {
+      console.log(chalk.gray('\nUninstall cancelled.\n'));
+      return;
+    }
+  }
+
+  console.log('');
+
+  // 1. Remove proagents folder
+  if (existsSync(proagentsDir)) {
+    rmSync(proagentsDir, { recursive: true, force: true });
+    console.log(chalk.green('✓ Removed ./proagents/ folder'));
+  }
+
+  // 2. Remove AI instruction files from project root
+  let aiFilesRemoved = 0;
+  for (const file of AI_FILES) {
+    const filePath = join(targetDir, file);
+    if (existsSync(filePath)) {
+      rmSync(filePath, { force: true });
+      aiFilesRemoved++;
+    }
+  }
+
+  // Remove .github/copilot-instructions.md
+  const copilotPath = join(targetDir, '.github', 'copilot-instructions.md');
+  if (existsSync(copilotPath)) {
+    rmSync(copilotPath, { force: true });
+    aiFilesRemoved++;
+  }
+
+  if (aiFilesRemoved > 0) {
+    console.log(chalk.green(`✓ Removed ${aiFilesRemoved} AI instruction file(s)`));
+  }
+
+  // 3. Remove ProAgents section from README.md
+  const readmePath = join(targetDir, 'README.md');
+  if (existsSync(readmePath)) {
+    try {
+      let content = readFileSync(readmePath, 'utf-8');
+
+      // Remove ProAgents section between markers
+      const startMarker = '<!-- PROAGENTS:START';
+      const endMarker = '<!-- PROAGENTS:END -->';
+
+      const startIndex = content.indexOf(startMarker);
+      const endIndex = content.indexOf(endMarker);
+
+      if (startIndex !== -1 && endIndex !== -1) {
+        const before = content.substring(0, startIndex).trimEnd();
+        const after = content.substring(endIndex + endMarker.length).trimStart();
+        content = before + (after ? '\n\n' + after : '');
+
+        writeFileSync(readmePath, content);
+        console.log(chalk.green('✓ Removed ProAgents section from README.md'));
+      }
+    } catch (error) {
+      console.log(chalk.yellow('⚠️  Could not update README.md: ' + error.message));
+    }
+  }
+
+  // 4. Remove docs files created by ProAgents (optional - only if empty)
+  const docsDir = join(targetDir, 'docs');
+  const releasesDir = join(docsDir, 'releases');
+  const releasesReadme = join(releasesDir, 'README.md');
+
+  // Only remove if it's the default ProAgents-generated file
+  if (existsSync(releasesReadme)) {
+    try {
+      const content = readFileSync(releasesReadme, 'utf-8');
+      if (content.includes('Generated by [ProAgents]')) {
+        rmSync(releasesReadme, { force: true });
+        // Try to remove empty directories
+        try {
+          rmSync(releasesDir, { recursive: false });
+          rmSync(join(docsDir, 'api'), { recursive: false });
+          rmSync(docsDir, { recursive: false });
+          console.log(chalk.green('✓ Removed empty docs/ folder'));
+        } catch {
+          // Directory not empty, leave it
+        }
+      }
+    } catch {
+      // Ignore errors
+    }
+  }
+
+  // 5. Check for CHANGELOG.md and RELEASE_NOTES.md
+  const changelogPath = join(targetDir, 'CHANGELOG.md');
+  const releaseNotesPath = join(targetDir, 'RELEASE_NOTES.md');
+
+  if (existsSync(changelogPath)) {
+    try {
+      const content = readFileSync(changelogPath, 'utf-8');
+      if (content.includes('Generated by [ProAgents]')) {
+        rmSync(changelogPath, { force: true });
+        console.log(chalk.green('✓ Removed CHANGELOG.md (ProAgents-generated)'));
+      } else {
+        console.log(chalk.gray('ℹ️  Kept CHANGELOG.md (has custom content)'));
+      }
+    } catch {
+      // Ignore
+    }
+  }
+
+  if (existsSync(releaseNotesPath)) {
+    try {
+      const content = readFileSync(releaseNotesPath, 'utf-8');
+      if (content.includes('Generated by [ProAgents]')) {
+        rmSync(releaseNotesPath, { force: true });
+        console.log(chalk.green('✓ Removed RELEASE_NOTES.md (ProAgents-generated)'));
+      } else {
+        console.log(chalk.gray('ℹ️  Kept RELEASE_NOTES.md (has custom content)'));
+      }
+    } catch {
+      // Ignore
+    }
+  }
+
+  console.log(chalk.green('\n✓ ProAgents uninstalled from this project.\n'));
+
+  console.log(chalk.gray('To uninstall the global CLI:'));
+  console.log(chalk.cyan('  npm uninstall -g proagents\n'));
+}

package/package.json

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

package/proagents/.cursorrules

@@ -6,18 +6,56 @@ This project uses ProAgents workflow framework.
 
 Recognize commands starting with `pa:` prefix:
 
+**Initialization**
+- `pa:init` - Initialize ProAgents in project
 - `pa:help` - Show all commands
+- `pa:status` - Show current progress
+
+**Feature Development**
 - `pa:feature "name"` - Start feature workflow (see ./proagents/WORKFLOW.md)
+- `pa:feature-start "name"` - Start new feature
+- `pa:feature-status` - Check feature status
+- `pa:feature-list` - List all features
+- `pa:feature-complete` - Mark feature complete
 - `pa:fix "bug"` - Bug fix mode (see ./proagents/workflow-modes/entry-modes.md)
-- `pa:status` - Show progress
+
+**Documentation**
 - `pa:doc` - Documentation options
 - `pa:doc-full` - Generate full documentation (see ./proagents/prompts/07-documentation.md)
 - `pa:doc-moderate` - Balanced documentation
 - `pa:doc-lite` - Quick reference
+- `pa:doc-module [name]` - Document specific module
+- `pa:doc-file [path]` - Document specific file
+- `pa:doc-api` - Generate API documentation
+- `pa:readme` - Generate/update README
+- `pa:changelog` - Update CHANGELOG.md
+- `pa:release` - Generate release notes
+
+**Quality & Testing**
 - `pa:qa` - Quality checks (see ./proagents/checklists/code-quality.md)
 - `pa:test` - Test workflow (see ./proagents/prompts/06-testing.md)
+- `pa:review` - Code review workflow
+
+**Deployment**
 - `pa:deploy` - Deployment workflow (see ./proagents/prompts/08-deployment.md)
-- `pa:release` - Generate release notes
+- `pa:rollback` - Rollback procedures
+
+**AI Platform Management**
+- `pa:ai-list` - List installed AI platforms
+- `pa:ai-add` - Add more AI platforms
+- `pa:ai-remove` - Remove AI platforms from config
+
+**Configuration**
+- `pa:config` - Show current configuration
+- `pa:config-list` - List all configurable options
+- `pa:config-show` - Show current config values
+- `pa:config-set K V` - Set a config value
+- `pa:config-get K` - Get a config value
+- `pa:config-setup` - Interactive config wizard
+- `pa:config-customize` - Copy templates to customize
+
+**Utilities**
+- `pa:uninstall` - Remove ProAgents from project
 
 ## Workflow
 

package/proagents/.github/copilot-instructions.md

@@ -4,11 +4,18 @@ This project uses ProAgents workflow framework. Recognize `pa:` prefix commands.
 
 ## Commands
 
-### Core
+### Initialization
+- `pa:init` - Initialize ProAgents in project
 - `pa:help` - Show all commands
+- `pa:status` - Show progress
+
+### Feature Development
 - `pa:feature "name"` - Start feature (read ./proagents/WORKFLOW.md)
+- `pa:feature-start "name"` - Start new feature
+- `pa:feature-status` - Check feature status
+- `pa:feature-list` - List all features
+- `pa:feature-complete` - Mark feature complete
 - `pa:fix "bug"` - Bug fix mode (read ./proagents/workflow-modes/entry-modes.md)
-- `pa:status` - Show progress
 
 ### Documentation
 - `pa:doc` - Documentation options
@@ -23,7 +30,7 @@ This project uses ProAgents workflow framework. Recognize `pa:` prefix commands.
 - `pa:release` - Release notes
 - `pa:release [ver]` - Version-specific notes
 
-### Quality
+### Quality & Testing
 - `pa:qa` - Quality checks (read ./proagents/checklists/code-quality.md)
 - `pa:test` - Test workflow (read ./proagents/prompts/06-testing.md)
 - `pa:review` - Code review
@@ -32,6 +39,23 @@ This project uses ProAgents workflow framework. Recognize `pa:` prefix commands.
 - `pa:deploy` - Deployment (read ./proagents/prompts/08-deployment.md)
 - `pa:rollback` - Rollback procedures
 
+### AI Platform Management
+- `pa:ai-list` - List installed AI platforms
+- `pa:ai-add` - Add more AI platforms
+- `pa:ai-remove` - Remove AI platforms from config
+
+### Configuration
+- `pa:config` - Show current configuration
+- `pa:config-list` - List all configurable options
+- `pa:config-show` - Show current config values
+- `pa:config-set K V` - Set a config value
+- `pa:config-get K` - Get a config value
+- `pa:config-setup` - Interactive config wizard
+- `pa:config-customize` - Copy templates to customize
+
+### Utilities
+- `pa:uninstall` - Remove ProAgents from project
+
 ## On `pa:` Command
 
 1. Read corresponding file in `./proagents/prompts/` or `./proagents/workflow-modes/`

package/proagents/.windsurfrules

@@ -0,0 +1,74 @@
+# ProAgents Commands for Windsurf
+
+This project uses ProAgents - an AI-agnostic development workflow framework.
+
+## Command Recognition
+
+Recognize commands with `pa:` prefix and execute the corresponding workflow.
+
+## Available Commands
+
+### Initialization
+- `pa:init` - Initialize ProAgents in project
+- `pa:help` - Show all available commands
+- `pa:status` - Show current progress
+
+### Feature Development
+- `pa:feature "name"` - Start new feature (read ./proagents/WORKFLOW.md)
+- `pa:feature-start "name"` - Start new feature
+- `pa:feature-status` - Check feature status
+- `pa:feature-list` - List all features
+- `pa:feature-complete` - Mark feature complete
+- `pa:fix "description"` - Quick bug fix mode (read ./proagents/workflow-modes/entry-modes.md)
+
+### Documentation Commands
+- `pa:doc` - Show documentation options
+- `pa:doc-full` - Generate full documentation (read ./proagents/prompts/07-documentation.md)
+- `pa:doc-moderate` - Generate balanced documentation
+- `pa:doc-lite` - Generate quick reference
+- `pa:doc-module [name]` - Document specific module
+- `pa:doc-file [path]` - Document specific file
+- `pa:doc-api` - Generate API documentation
+- `pa:readme` - Generate/update README
+- `pa:changelog` - Update CHANGELOG.md
+- `pa:release` - Generate release notes
+- `pa:release [version]` - Version-specific release notes
+
+### Quality & Testing
+- `pa:qa` - Run quality checks (read ./proagents/checklists/code-quality.md)
+- `pa:test` - Run test workflow (read ./proagents/prompts/06-testing.md)
+- `pa:review` - Code review workflow
+
+### Deployment
+- `pa:deploy` - Deployment preparation (read ./proagents/prompts/08-deployment.md)
+- `pa:rollback` - Rollback procedures
+
+### AI Platform Management
+- `pa:ai-list` - List installed AI platforms
+- `pa:ai-add` - Add more AI platforms
+- `pa:ai-remove` - Remove AI platforms from config
+
+### Configuration
+- `pa:config` - Show current configuration
+- `pa:config-list` - List all configurable options
+- `pa:config-show` - Show current config values
+- `pa:config-set K V` - Set a config value
+- `pa:config-get K` - Get a config value
+- `pa:config-setup` - Interactive config wizard
+- `pa:config-customize` - Copy templates to customize
+
+### Utilities
+- `pa:uninstall` - Remove ProAgents from project
+
+## Execution Instructions
+
+When user types a `pa:` command:
+1. Read the corresponding prompt file from `./proagents/prompts/`
+2. Follow the workflow instructions in that file
+3. Use project configuration from `./proagents/proagents.config.yaml`
+
+## Key Files
+
+- `./proagents/WORKFLOW.md` - Full 10-phase workflow
+- `./proagents/PROAGENTS.md` - Quick command reference
+- `./proagents/prompts/` - Phase-specific AI prompts

package/proagents/AI_INSTRUCTIONS.md

@@ -6,13 +6,22 @@ This project uses ProAgents - an AI-agnostic development workflow framework.
 
 When the user types commands starting with `pa:`, recognize and execute them:
 
-### Core Commands
+### Initialization
 | Command | Action |
 |---------|--------|
+| `pa:init` | Initialize ProAgents in project |
 | `pa:help` | Show all available commands |
+| `pa:status` | Show current progress |
+
+### Feature Development
+| Command | Action |
+|---------|--------|
 | `pa:feature "name"` | Start new feature workflow |
+| `pa:feature-start "name"` | Start new feature |
+| `pa:feature-status` | Check feature status |
+| `pa:feature-list` | List all features |
+| `pa:feature-complete` | Mark feature complete |
 | `pa:fix "description"` | Quick bug fix mode |
-| `pa:status` | Show current progress |
 
 ### Documentation Commands
 | Command | Action |
@@ -29,19 +38,42 @@ When the user types commands starting with `pa:`, recognize and execute them:
 | `pa:release` | Generate release notes |
 | `pa:release [version]` | Version-specific release notes |
 
-### Quality Commands
+### Quality & Testing
 | Command | Action |
 |---------|--------|
 | `pa:qa` | Run quality assurance checks |
 | `pa:test` | Run test workflow |
 | `pa:review` | Code review workflow |
 
-### Deployment Commands
+### Deployment
 | Command | Action |
 |---------|--------|
 | `pa:deploy` | Deployment preparation |
 | `pa:rollback` | Rollback procedures |
 
+### AI Platform Management
+| Command | Action |
+|---------|--------|
+| `pa:ai-list` | List installed AI platforms |
+| `pa:ai-add` | Add more AI platforms |
+| `pa:ai-remove` | Remove AI platforms from config |
+
+### Configuration
+| Command | Action |
+|---------|--------|
+| `pa:config` | Show current configuration |
+| `pa:config-list` | List all configurable options |
+| `pa:config-show` | Show current config values |
+| `pa:config-set K V` | Set a config value |
+| `pa:config-get K` | Get a config value |
+| `pa:config-setup` | Interactive config wizard |
+| `pa:config-customize` | Copy templates to customize |
+
+### Utilities
+| Command | Action |
+|---------|--------|
+| `pa:uninstall` | Remove ProAgents from project |
+
 ## How to Execute Commands
 
 When user types a `pa:` command: