proagents 1.6.16 → 1.6.18

package/README.md

@@ -4,8 +4,15 @@
 
 A portable, universal development workflow framework that works with **any AI platform** (Claude, ChatGPT, Gemini, Cursor, Copilot, etc.) and enables **multi-AI collaboration** on the same project.
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![npm version](https://img.shields.io/npm/v/proagents.svg)](https://www.npmjs.com/package/proagents)
+[![npm downloads](https://img.shields.io/npm/dm/proagents.svg)](https://www.npmjs.com/package/proagents)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+### 📚 [COMMANDS.md](COMMANDS.md) - Complete Command Reference (100+ Commands)
+
+CLI commands, AI commands (pa:), workflow phases, debugging, testing, deployment, and more.
 
 ---
 
@@ -26,12 +33,6 @@ No install required. Just run:
 npx proagents init
 ```
 
-Or with a template:
-
-```bash
-npx proagents init --template nextjs-saas
-```
-
 ---
 
 ## Quick Start
@@ -80,52 +81,25 @@ Next: pa:test
 
 ## Features
 
-### Multi-AI Collaboration & Cross-AI Continuity
+### Multi-AI Collaboration
 
 Multiple AIs can work on the same project with full context sharing:
 
 | Feature | Description |
 |---------|-------------|
-| **Auto Context Loading** | AI automatically loads context on first command |
-| **Auto Change Logging** | Every code change logged automatically |
-| **Feature Changelogs** | Per-feature change history |
-| **Module Changelogs** | Per-module change history |
-| **Conflict Detection** | Warns if files modified by other AI |
-| **Activity Log** | Track what each AI does with model name |
-| **Smart Context Summary** | Auto-generated 5-line summary at top of context |
-| **Context Changed Alert** | Warns if another AI worked since your last session |
-| **Test Status Tracking** | Auto-updates test status after every test run |
-| **Feature Progress** | Auto-calculates progress from tasks |
-| **AI Performance Stats** | Tracks sessions, tasks, reverts per AI platform |
-| **Quick Undo (pa:undo-last)** | Revert last AI's entire session changes |
-| **Auto-Archive Old Logs** | Automatically archives logs older than 7 days |
+| **Auto Context Loading** | AI loads project context automatically on first command |
+| **Auto Change Logging** | Every code change logged with AI model name |
+| **Conflict Detection** | Warns if files were modified by another AI |
+| **Feature Changelogs** | Per-feature and per-module change history |
+| **Quick Undo** | `pa:undo-last` reverts last AI's entire session |
+| **Activity Tracking** | Track what each AI does with timestamps |
+| **Handoff Notes** | `pa:handoff` creates notes for next AI session |
+| **Test Status Sync** | Auto-updates test status after every test run |
+| **Progress Tracking** | Auto-calculates feature progress from tasks |
 
 ```bash
-# Just start working - context loads automatically!
 pa:feature "add login"    # AI auto-loads context, then works
-pa:fix "bug in auth"      # AI auto-loads context, then fixes
-
-# No manual pa:sync needed - it's automatic
-# No manual pa:session-end needed - changes logged automatically
-
-# Undo another AI's work if needed
-pa:undo-last              # Revert last AI's entire session
-```
-
-### Project Templates
-
-Pre-configured settings for common stacks:
-
-```bash
-npx proagents init --template nextjs-saas      # Next.js SaaS
-npx proagents init --template react-spa        # React SPA
-npx proagents init --template react-native-app # React Native
-npx proagents init --template express-api      # Express API
-npx proagents init --template nestjs-api       # NestJS API
-npx proagents init --template vue-spa          # Vue.js SPA
-npx proagents init --template python-fastapi   # Python FastAPI
-
-npx proagents init --list-templates            # Show all templates
+pa:undo-last              # Revert last AI's changes if needed
 ```
 
 ### AI Learning & Feedback
@@ -163,7 +137,6 @@ ProAgents follows **"ALWAYS DO, NEVER JUST TELL"** principle:
 ```bash
 # Initialize
 npx proagents init                    # Initialize or update ProAgents
-npx proagents init --template <name>  # Use a project template
 
 # Daily Use
 proagents status                      # Show ProAgents status
@@ -179,7 +152,7 @@ proagents release                     # Generate release notes
 proagents release --changelog         # Update CHANGELOG.md
 ```
 
-Run `proagents commands` for the full list of CLI commands.
+📖 **Want more?** See [COMMANDS.md](COMMANDS.md) for 30+ CLI commands (release notes, stats, config, backups, shell completions...)
 
 ---
 
@@ -202,23 +175,7 @@ Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.):
 
 **Quick aliases:** `pa:f` (feature), `pa:s` (status), `pa:t` (test), `pa:h` (help)
 
-For the complete command reference (100+ commands), see **[COMMANDS.md](COMMANDS.md)**.
-
----
-
-## Key Files
-
-After initialization, these files help AI understand your project:
-
-| File | Purpose | AI Should |
-|------|---------|-----------|
-| `.proagents/context.md` | Persistent project knowledge | **Read first every session!** |
-| `.proagents/feedback.md` | Past corrections & preferences | Learn from mistakes |
-| `.proagents/watchlist.yaml` | Protected files list | Ask before modifying |
-| `.proagents/activity.log` | AI activity history | Check for conflicts |
-| `.proagents/decisions.md` | Architectural decisions | Understand why choices were made |
-| `.proagents/errors.md` | Past errors & solutions | Find solutions faster |
-| `.proagents/handoff.md` | Handoff notes | Continue where another AI left off |
+📖 **Want more?** See [COMMANDS.md](COMMANDS.md) for 100+ AI commands (debugging, testing, refactoring, code generation, sprints...)
 
 ---
 
@@ -248,6 +205,7 @@ ProAgents works with **any AI that has agentic capability** (can read files and
 
 | Document | Description |
 |----------|-------------|
+| 📚 **[COMMANDS.md](COMMANDS.md)** | **100+ CLI & AI commands** |
 | [Getting Started Story](./.proagents/GETTING-STARTED-STORY.md) | Narrative walkthrough |
 | [Complete Workflow](./.proagents/WORKFLOW.md) | 10-phase workflow guide |
 | [AI Instructions](./.proagents/AI_INSTRUCTIONS.md) | Full AI command reference |

package/bin/proagents.js

@@ -42,8 +42,6 @@ program
   .description('Initialize ProAgents in the current project')
   .option('-f, --force', 'Overwrite existing proagents folder')
   .option('--skip-config', 'Skip creating config file')
-  .option('-t, --template <name>', 'Use a project template (e.g., nextjs-saas, react-spa)')
-  .option('--list-templates', 'List available project templates')
   .action(initCommand);
 
 // Feature commands

package/lib/commands/init.js

@@ -316,115 +316,6 @@ const PROJECT_TYPES = [
   }
 ];
 
-// Project templates - pre-configured settings for common stacks
-const PROJECT_TEMPLATES = {
-  'nextjs-saas': {
-    name: 'Next.js SaaS Starter',
-    description: 'Full-stack SaaS with authentication, database, and payments',
-    project: { type: 'nextjs' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'zustand',
-      styling: 'tailwind',
-      database: 'postgresql',
-      orm: 'prisma',
-      auth_method: 'nextauth',
-      test_framework: 'vitest'
-    },
-    platforms: ['claude', 'cursor', 'copilot']
-  },
-  'react-spa': {
-    name: 'React Single Page App',
-    description: 'Frontend-focused React application with modern tooling',
-    project: { type: 'react' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'zustand',
-      styling: 'tailwind',
-      database: 'none',
-      orm: 'none',
-      auth_method: 'jwt',
-      test_framework: 'vitest'
-    },
-    platforms: ['claude', 'cursor']
-  },
-  'react-native-app': {
-    name: 'React Native Mobile App',
-    description: 'Cross-platform mobile app with Expo',
-    project: { type: 'react-native' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'zustand',
-      styling: 'tailwind',
-      database: 'supabase',
-      orm: 'none',
-      auth_method: 'supabase',
-      test_framework: 'jest'
-    },
-    platforms: ['claude', 'cursor']
-  },
-  'express-api': {
-    name: 'Express.js REST API',
-    description: 'Backend API with Express, PostgreSQL, and JWT auth',
-    project: { type: 'express' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'none',
-      styling: 'none',
-      database: 'postgresql',
-      orm: 'prisma',
-      auth_method: 'jwt',
-      test_framework: 'jest'
-    },
-    platforms: ['claude', 'cursor']
-  },
-  'nestjs-api': {
-    name: 'NestJS Enterprise API',
-    description: 'Enterprise-grade API with NestJS and TypeORM',
-    project: { type: 'nestjs' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'none',
-      styling: 'none',
-      database: 'postgresql',
-      orm: 'typeorm',
-      auth_method: 'jwt',
-      test_framework: 'jest'
-    },
-    platforms: ['claude', 'cursor']
-  },
-  'vue-spa': {
-    name: 'Vue.js Single Page App',
-    description: 'Vue 3 with Composition API and Pinia',
-    project: { type: 'vue' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'none',
-      styling: 'tailwind',
-      database: 'none',
-      orm: 'none',
-      auth_method: 'jwt',
-      test_framework: 'vitest'
-    },
-    platforms: ['claude', 'cursor']
-  },
-  'python-fastapi': {
-    name: 'Python FastAPI',
-    description: 'Modern Python API with FastAPI and SQLAlchemy',
-    project: { type: 'python' },
-    techStack: {
-      api_style: 'rest',
-      state_management: 'none',
-      styling: 'none',
-      database: 'postgresql',
-      orm: 'none',
-      auth_method: 'jwt',
-      test_framework: 'pytest'
-    },
-    platforms: ['claude', 'cursor']
-  }
-};
-
 // Tech stack configuration options
 const TECH_STACK_OPTIONS = {
   api_style: {
@@ -963,41 +854,6 @@ async function promptProjectConfig(targetDir, existingConfig = {}) {
   };
 }
 
-/**
- * List available templates
- */
-export function listTemplates() {
-  console.log(chalk.bold('\nAvailable Project Templates'));
-  console.log(chalk.gray('─'.repeat(50)));
-
-  for (const [id, template] of Object.entries(PROJECT_TEMPLATES)) {
-    console.log(`\n  ${chalk.cyan(id)}`);
-    console.log(`    ${template.name}`);
-    console.log(chalk.gray(`    ${template.description}`));
-  }
-
-  console.log(chalk.gray('\n\nUsage: npx proagents init --template <name>\n'));
-}
-
-/**
- * Apply a project template
- */
-function applyTemplate(templateId, targetDir) {
-  const template = PROJECT_TEMPLATES[templateId];
-  if (!template) {
-    return null;
-  }
-
-  // Return config object that matches what promptProjectConfig returns
-  return {
-    name: basename(targetDir),
-    type: template.project.type,
-    typeName: PROJECT_TYPES.find(t => t.id === template.project.type)?.name || template.project.type,
-    techStack: template.techStack,
-    platforms: template.platforms
-  };
-}
-
 /**
  * Load existing partial config (for resume after interrupted setup)
  */
@@ -1331,27 +1187,8 @@ No releases yet. Use \`pa:release\` to generate release notes.
       console.log(chalk.green('✓ Created RELEASE_NOTES.md'));
     }
 
-    // Project configuration - either from template or interactive prompt
-    let projectConfig;
-
-    if (options.listTemplates) {
-      listTemplates();
-      return;
-    }
-
-    if (options.template) {
-      // Use template
-      projectConfig = applyTemplate(options.template, targetDir);
-      if (!projectConfig) {
-        console.log(chalk.red(`\nError: Template "${options.template}" not found.`));
-        listTemplates();
-        return;
-      }
-      console.log(chalk.green(`\n✓ Using template: ${PROJECT_TEMPLATES[options.template].name}`));
-    } else {
-      // Interactive prompts - pass existing config for pre-filling
-      projectConfig = await promptProjectConfig(targetDir, existingConfig);
-    }
+    // Project configuration - interactive prompts with auto-detection
+    const projectConfig = await promptProjectConfig(targetDir, existingConfig);
 
     // Save progress after project config
     savePartialConfig(configPath, {
@@ -1394,15 +1231,8 @@ For detailed commands, see \`./.proagents/PROAGENTS.md\`
       console.log(chalk.green('✓ Created README.md with ProAgents commands'));
     }
 
-    // AI platform selection - from template or interactive
-    let selectedPlatforms;
-    if (options.template && projectConfig.platforms) {
-      selectedPlatforms = projectConfig.platforms;
-      console.log(chalk.gray(`  Using template platforms: ${selectedPlatforms.join(', ')}`));
-    } else {
-      // Pass existing config for pre-selection
-      selectedPlatforms = await selectPlatforms(existingConfig.ai_platforms);
-    }
+    // AI platform selection - interactive with auto-detection
+    const selectedPlatforms = await selectPlatforms(existingConfig.ai_platforms);
 
     // Save progress after platform selection
     savePartialConfig(configPath, {

package/package.json

@@ -1,21 +1,16 @@
 {
   "name": "proagents",
-  "version": "1.6.16",
+  "version": "1.6.18",
   "description": "AI-agnostic development workflow framework that automates the full software development lifecycle",
   "type": "module",
   "main": "lib/index.js",
   "bin": {
-    "proagents": "./bin/proagents.js"
+    "proagents": "bin/proagents.js"
   },
   "scripts": {
     "test": "echo \"No tests yet\" && exit 0",
     "lint": "echo \"No linting configured\" && exit 0"
   },
-  "files": [
-    "bin/",
-    "lib/",
-    ".proagents/"
-  ],
   "keywords": [
     "ai",
     "workflow",

package/.proagents/ai-models/README.md

@@ -1,141 +0,0 @@
-# AI Model Selection & Management
-
-Configure and manage AI models for different tasks.
-
----
-
-## Overview
-
-ProAgents is AI-agnostic and supports multiple AI providers. Configure which models to use for different tasks to optimize cost, speed, and quality.
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    AI Model Architecture                     │
-├─────────────────────────────────────────────────────────────┤
-│                                                             │
-│  Task ──► Model Router ──► Selected Model ──► Response     │
-│               │                                             │
-│               ├── Task Type Detection                       │
-│               ├── Cost Optimization                         │
-│               ├── Fallback Handling                         │
-│               └── Rate Limiting                             │
-│                                                             │
-│  Supported Providers:                                       │
-│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐         │
-│  │ Claude  │ │ OpenAI  │ │ Gemini  │ │ Others  │         │
-│  └─────────┘ └─────────┘ └─────────┘ └─────────┘         │
-│                                                             │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Quick Start
-
-### Configure Default Model
-
-```yaml
-# proagents.config.yaml
-
-ai:
-  default_provider: "anthropic"
-  default_model: "claude-3-sonnet"
-```
-
-### Use Different Models
-
-```bash
-# Use specific model for a task
-proagents analyze --model claude-3-opus
-
-# Use fast model for quick tasks
-proagents quick "Fix typo" --model claude-3-haiku
-```
-
----
-
-## Supported Providers
-
-| Provider | Models | Best For |
-|----------|--------|----------|
-| **Anthropic** | Claude 3 Opus, Sonnet, Haiku | Code analysis, planning |
-| **OpenAI** | GPT-4, GPT-4 Turbo, GPT-3.5 | General tasks, docs |
-| **Google** | Gemini Pro, Gemini Ultra | Research, analysis |
-| **Cohere** | Command, Command Light | Summarization |
-| **Local** | Ollama, LM Studio | Privacy, offline |
-
----
-
-## Documentation Files
-
-| File | Description |
-|------|-------------|
-| [model-config.md](./model-config.md) | Model configuration |
-| [task-routing.md](./task-routing.md) | Task-based model selection |
-| [cost-management.md](./cost-management.md) | Cost optimization |
-| [fallbacks.md](./fallbacks.md) | Fallback strategies |
-
----
-
-## Configuration
-
-```yaml
-# proagents.config.yaml
-
-ai:
-  # Default settings
-  default_provider: "anthropic"
-  default_model: "claude-3-sonnet"
-
-  # Provider configurations
-  providers:
-    anthropic:
-      api_key: "${ANTHROPIC_API_KEY}"
-      models:
-        - claude-3-opus
-        - claude-3-sonnet
-        - claude-3-haiku
-
-    openai:
-      api_key: "${OPENAI_API_KEY}"
-      models:
-        - gpt-4-turbo
-        - gpt-4
-        - gpt-3.5-turbo
-
-    google:
-      api_key: "${GOOGLE_API_KEY}"
-      models:
-        - gemini-pro
-        - gemini-ultra
-
-  # Task-specific models
-  task_routing:
-    code_analysis: "claude-3-opus"
-    code_generation: "claude-3-sonnet"
-    quick_tasks: "claude-3-haiku"
-    documentation: "gpt-4"
-
-  # Cost management
-  cost:
-    daily_limit: 50.00
-    alert_threshold: 40.00
-    fallback_on_limit: true
-
-  # Fallback chain
-  fallback:
-    primary: "claude-3-sonnet"
-    secondary: "gpt-4"
-    tertiary: "gemini-pro"
-```
-
----
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `proagents ai status` | Show AI configuration status |
-| `proagents ai models` | List available models |
-| `proagents ai usage` | Show usage and costs |
-| `proagents ai test` | Test model connectivity |