proagents 1.0.0

package/lib/commands/status.js

@@ -0,0 +1,91 @@
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+
+/**
+ * Show ProAgents status in current project
+ */
+export async function statusCommand() {
+  const targetDir = process.cwd();
+  const proagentsDir = join(targetDir, 'proagents');
+
+  console.log('\n' + chalk.bold.blue('ProAgents Status'));
+  console.log(chalk.blue('═'.repeat(40)) + '\n');
+
+  // Check initialization
+  if (!existsSync(proagentsDir)) {
+    console.log(chalk.red('Status: Not Initialized'));
+    console.log(chalk.gray('\nRun: proagents init\n'));
+    return;
+  }
+
+  console.log(chalk.green('Status: Initialized ✓'));
+  console.log(chalk.gray(`Location: ${proagentsDir}\n`));
+
+  // Check for config file
+  const configFile = join(targetDir, 'proagents.config.yaml');
+  if (existsSync(configFile)) {
+    console.log(chalk.white('Config: proagents.config.yaml ✓'));
+  } else {
+    console.log(chalk.yellow('Config: Not found (using defaults)'));
+  }
+
+  // Check active features
+  const activeFeaturesDir = join(proagentsDir, 'active-features');
+  if (existsSync(activeFeaturesDir)) {
+    try {
+      const features = readdirSync(activeFeaturesDir).filter(f => f.startsWith('feature-'));
+
+      if (features.length > 0) {
+        console.log(chalk.white(`\nActive Features: ${features.length}`));
+        console.log(chalk.gray('─'.repeat(30)));
+
+        features.forEach(feature => {
+          const statusFile = join(activeFeaturesDir, feature, 'status.json');
+          if (existsSync(statusFile)) {
+            try {
+              const status = JSON.parse(readFileSync(statusFile, 'utf-8'));
+              const phaseEmoji = getPhaseEmoji(status.current_phase);
+              console.log(`${phaseEmoji} ${status.name}`);
+              console.log(chalk.gray(`   Phase: ${status.current_phase} | ${status.phase_progress}%`));
+            } catch (e) {
+              console.log(chalk.gray(`• ${feature}`));
+            }
+          }
+        });
+      } else {
+        console.log(chalk.gray('\nNo active features.'));
+      }
+    } catch (e) {
+      console.log(chalk.gray('\nNo active features.'));
+    }
+  } else {
+    console.log(chalk.gray('\nNo active features.'));
+  }
+
+  // Quick commands reference
+  console.log('\n' + chalk.bold('Quick Commands:'));
+  console.log(chalk.gray('─'.repeat(30)));
+  console.log(chalk.cyan('proagents feature start "name"') + ' - Start feature');
+  console.log(chalk.cyan('proagents fix "description"') + '    - Quick bug fix');
+  console.log(chalk.cyan('proagents docs') + '                  - Open docs');
+  console.log(chalk.cyan('proagents commands') + '              - All commands');
+  console.log('');
+}
+
+function getPhaseEmoji(phase) {
+  const emojis = {
+    'init': '🔵',
+    'analysis': '🔍',
+    'requirements': '📋',
+    'design': '🎨',
+    'planning': '📝',
+    'implementation': '💻',
+    'testing': '🧪',
+    'review': '👀',
+    'documentation': '📚',
+    'deployment': '🚀',
+    'complete': '✅'
+  };
+  return emojis[phase] || '⏳';
+}

package/lib/index.js

@@ -0,0 +1,28 @@
+/**
+ * ProAgents - AI-agnostic development workflow framework
+ *
+ * This module exports the main functionality for programmatic use.
+ */
+
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+export { initCommand } from './commands/init.js';
+export { featureCommand } from './commands/feature.js';
+export { fixCommand } from './commands/fix.js';
+export { statusCommand } from './commands/status.js';
+export { helpCommand } from './commands/help.js';
+
+/**
+ * ProAgents version
+ */
+export const VERSION = '1.0.0';
+
+/**
+ * Check if ProAgents is initialized in a directory
+ * @param {string} dir - Directory to check
+ * @returns {boolean}
+ */
+export function isInitialized(dir = process.cwd()) {
+  return existsSync(join(dir, 'proagents'));
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "proagents",
+  "version": "1.0.0",
+  "description": "AI-agnostic development workflow framework that automates the full software development lifecycle",
+  "type": "module",
+  "main": "lib/index.js",
+  "bin": {
+    "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",
+    "development",
+    "automation",
+    "claude",
+    "chatgpt",
+    "copilot",
+    "gemini",
+    "sdlc",
+    "devops",
+    "productivity",
+    "code-generation",
+    "ai-assisted",
+    "developer-tools"
+  ],
+  "author": "prakashpro3",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/prakashpro3/proAgents.git"
+  },
+  "bugs": {
+    "url": "https://github.com/prakashpro3/proAgents/issues"
+  },
+  "homepage": "https://github.com/prakashpro3/proAgents#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "chalk": "^5.3.0"
+  }
+}

package/proagents/.learning/global/common-patterns.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "../schemas/patterns-schema.json",
+  "version": "1.0.0",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "patterns": {
+    "component_patterns": [
+      {
+        "id": "functional-component",
+        "name": "Functional Component with TypeScript",
+        "frequency": 95,
+        "confidence": 0.98,
+        "template": "export const {{name}}: FC<{{name}}Props> = ({ ...props }) => {\n  return (...);\n};"
+      },
+      {
+        "id": "hook-pattern",
+        "name": "Custom Hook Pattern",
+        "frequency": 85,
+        "confidence": 0.92,
+        "template": "export function use{{Name}}(options?: {{Name}}Options) {\n  // implementation\n  return { data, loading, error };\n}"
+      }
+    ],
+
+    "api_patterns": [
+      {
+        "id": "rest-handler",
+        "name": "REST API Handler",
+        "frequency": 90,
+        "confidence": 0.95,
+        "template": "export async function {{METHOD}}(req: NextRequest) {\n  try {\n    // implementation\n    return NextResponse.json({ success: true, data });\n  } catch (error) {\n    return NextResponse.json({ success: false, error: error.message }, { status: 500 });\n  }\n}"
+      }
+    ],
+
+    "error_handling": [
+      {
+        "id": "try-catch-async",
+        "name": "Async Try-Catch Pattern",
+        "frequency": 88,
+        "confidence": 0.90,
+        "applies_to": ["api_routes", "services"]
+      }
+    ],
+
+    "testing_patterns": [
+      {
+        "id": "describe-it",
+        "name": "Describe-It Test Structure",
+        "frequency": 100,
+        "confidence": 0.99,
+        "template": "describe('{{subject}}', () => {\n  it('should {{behavior}}', () => {\n    // arrange, act, assert\n  });\n});"
+      }
+    ]
+  },
+
+  "anti_patterns": [
+    {
+      "id": "prop-drilling",
+      "name": "Excessive Prop Drilling",
+      "detected_count": 3,
+      "suggestion": "Use context or state management for deeply nested props",
+      "auto_suggest": true
+    },
+    {
+      "id": "any-type",
+      "name": "Using 'any' Type",
+      "detected_count": 5,
+      "suggestion": "Define proper TypeScript interfaces",
+      "auto_suggest": true
+    }
+  ],
+
+  "learned_from": {
+    "codebase_analysis": 45,
+    "user_corrections": 12,
+    "explicit_teaching": 3
+  }
+}

package/proagents/.learning/global/user-preferences.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "../schemas/user-preferences-schema.json",
+  "version": "1.0.0",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "checkpoint_preferences": {
+    "usually_skips": [
+      "after_requirements",
+      "after_documentation"
+    ],
+    "always_reviews": [
+      "after_design",
+      "before_deployment"
+    ],
+    "auto_approve_conditions": [
+      {
+        "checkpoint": "after_analysis",
+        "condition": "files_changed < 5",
+        "confidence": 0.85
+      }
+    ]
+  },
+
+  "workflow_preferences": {
+    "preferred_mode": "full",
+    "skip_phases_for_bug_fixes": [
+      "design",
+      "documentation"
+    ],
+    "detail_level": "high",
+    "verbosity": "moderate"
+  },
+
+  "code_preferences": {
+    "naming_style": {
+      "components": "PascalCase",
+      "functions": "camelCase",
+      "constants": "UPPER_SNAKE_CASE",
+      "files": "kebab-case"
+    },
+    "formatting": {
+      "indent": 2,
+      "quotes": "single",
+      "semicolons": true,
+      "trailing_commas": "es5"
+    },
+    "patterns": {
+      "state_management": "zustand",
+      "data_fetching": "react-query",
+      "styling": "tailwind"
+    }
+  },
+
+  "review_preferences": {
+    "focus_areas": [
+      "security",
+      "performance",
+      "accessibility"
+    ],
+    "thoroughness": "high",
+    "comment_style": "inline"
+  },
+
+  "notification_preferences": {
+    "on_checkpoint": true,
+    "on_completion": true,
+    "on_error": true,
+    "channels": ["terminal"]
+  },
+
+  "learning_consent": {
+    "track_corrections": true,
+    "track_patterns": true,
+    "share_anonymized": false
+  }
+}

package/proagents/.learning/projects/example-project/corrections.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "../../schemas/corrections-schema.json",
+  "project_id": "example-project",
+  "version": "1.0.0",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "corrections": [
+    {
+      "id": "corr-001",
+      "created_at": "2024-01-10T14:30:00Z",
+      "type": "code_pattern",
+      "category": "api_calls",
+
+      "original": {
+        "code": "const response = await fetch('/api/users');",
+        "context": "API call in component"
+      },
+      "corrected": {
+        "code": "const response = await apiClient.get('/users');",
+        "context": "Use project's API client"
+      },
+
+      "reason": "Project uses centralized API client with interceptors",
+      "occurrences": 5,
+      "auto_apply": true,
+      "confidence": 0.95
+    },
+    {
+      "id": "corr-002",
+      "created_at": "2024-01-11T09:15:00Z",
+      "type": "naming",
+      "category": "components",
+
+      "original": {
+        "pattern": "function Component(props)"
+      },
+      "corrected": {
+        "pattern": "const Component: FC<ComponentProps> = ({ prop1, prop2 })"
+      },
+
+      "reason": "Project prefers typed arrow function components with destructured props",
+      "occurrences": 3,
+      "auto_apply": true,
+      "confidence": 0.88
+    },
+    {
+      "id": "corr-003",
+      "created_at": "2024-01-12T16:00:00Z",
+      "type": "error_handling",
+      "category": "api",
+
+      "original": {
+        "code": "catch (error) { console.error(error); }"
+      },
+      "corrected": {
+        "code": "catch (error) { logger.error('Operation failed', { error, context }); throw error; }"
+      },
+
+      "reason": "Use structured logging and re-throw for proper error propagation",
+      "occurrences": 4,
+      "auto_apply": false,
+      "confidence": 0.82
+    },
+    {
+      "id": "corr-004",
+      "created_at": "2024-01-13T11:30:00Z",
+      "type": "imports",
+      "category": "organization",
+
+      "original": {
+        "pattern": "Mixed import order"
+      },
+      "corrected": {
+        "pattern": "React → third-party → local → styles"
+      },
+
+      "reason": "Consistent import ordering per project standards",
+      "occurrences": 8,
+      "auto_apply": true,
+      "confidence": 0.98
+    }
+  ],
+
+  "statistics": {
+    "total_corrections": 4,
+    "auto_applied": 3,
+    "manual_review": 1,
+    "average_confidence": 0.91,
+    "time_saved_minutes": 45
+  },
+
+  "pending_review": [
+    {
+      "correction_id": "corr-003",
+      "reason": "Confidence below threshold",
+      "suggested_action": "Verify error handling pattern with team"
+    }
+  ]
+}

package/proagents/.learning/projects/example-project/feedback.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "../../schemas/feedback-schema.json",
+  "project_id": "example-project",
+  "version": "1.0.0",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "feedback_entries": [
+    {
+      "id": "fb-001",
+      "timestamp": "2024-01-12T17:30:00Z",
+      "feature_id": "feature-user-auth",
+      "phase": "implementation",
+
+      "type": "positive",
+      "rating": 5,
+      "comment": "AI correctly identified existing auth patterns and followed them",
+
+      "context": {
+        "suggestion_accepted": true,
+        "modifications_needed": false
+      }
+    },
+    {
+      "id": "fb-002",
+      "timestamp": "2024-01-13T10:00:00Z",
+      "feature_id": "feature-dashboard",
+      "phase": "design",
+
+      "type": "improvement",
+      "rating": 3,
+      "comment": "Design suggestions were good but didn't match our Figma exactly",
+
+      "context": {
+        "suggestion_accepted": true,
+        "modifications_needed": true,
+        "modification_type": "styling_adjustments"
+      },
+
+      "improvement_suggestions": [
+        "Better Figma token extraction",
+        "More precise spacing/sizing"
+      ]
+    },
+    {
+      "id": "fb-003",
+      "timestamp": "2024-01-14T14:15:00Z",
+      "feature_id": "feature-notifications",
+      "phase": "requirements",
+
+      "type": "negative",
+      "rating": 2,
+      "comment": "Missed important requirement about offline notification queuing",
+
+      "context": {
+        "suggestion_accepted": false,
+        "required_restart": true
+      },
+
+      "root_cause": "requirement_ambiguity",
+      "resolution": "Added explicit offline requirements to template"
+    }
+  ],
+
+  "aggregated_feedback": {
+    "total_entries": 3,
+    "average_rating": 3.3,
+    "positive_count": 1,
+    "improvement_count": 1,
+    "negative_count": 1,
+
+    "by_phase": {
+      "requirements": { "average_rating": 2.0, "count": 1 },
+      "design": { "average_rating": 3.0, "count": 1 },
+      "implementation": { "average_rating": 5.0, "count": 1 }
+    },
+
+    "common_issues": [
+      {
+        "issue": "Figma interpretation accuracy",
+        "frequency": 2,
+        "status": "being_addressed"
+      }
+    ],
+
+    "strengths": [
+      {
+        "area": "Pattern recognition in existing code",
+        "frequency": 5,
+        "confidence": 0.92
+      }
+    ]
+  },
+
+  "improvement_actions": [
+    {
+      "id": "action-001",
+      "created_from": "fb-003",
+      "description": "Add offline requirements section to requirements template",
+      "status": "completed",
+      "completed_at": "2024-01-14T16:00:00Z"
+    },
+    {
+      "id": "action-002",
+      "created_from": "fb-002",
+      "description": "Improve Figma token extraction precision",
+      "status": "in_progress"
+    }
+  ]
+}

package/proagents/.learning/projects/example-project/metrics.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "../../schemas/metrics-schema.json",
+  "project_id": "example-project",
+  "version": "1.0.0",
+  "updated_at": "2024-01-15T10:30:00Z",
+
+  "summary": {
+    "features_completed": 8,
+    "bugs_fixed": 15,
+    "total_development_hours": 124,
+    "average_feature_duration_hours": 12.5,
+    "average_bug_fix_duration_hours": 1.8
+  },
+
+  "phase_durations": {
+    "analysis": {
+      "average_minutes": 35,
+      "min_minutes": 15,
+      "max_minutes": 90,
+      "samples": 8
+    },
+    "requirements": {
+      "average_minutes": 45,
+      "min_minutes": 20,
+      "max_minutes": 120,
+      "samples": 8
+    },
+    "design": {
+      "average_minutes": 75,
+      "min_minutes": 30,
+      "max_minutes": 180,
+      "samples": 7
+    },
+    "implementation": {
+      "average_minutes": 320,
+      "min_minutes": 60,
+      "max_minutes": 720,
+      "samples": 8
+    },
+    "testing": {
+      "average_minutes": 90,
+      "min_minutes": 30,
+      "max_minutes": 240,
+      "samples": 8
+    },
+    "review": {
+      "average_minutes": 45,
+      "min_minutes": 15,
+      "max_minutes": 120,
+      "samples": 8
+    },
+    "documentation": {
+      "average_minutes": 30,
+      "min_minutes": 10,
+      "max_minutes": 60,
+      "samples": 6
+    }
+  },
+
+  "checkpoint_metrics": {
+    "after_analysis": {
+      "average_wait_minutes": 5,
+      "skip_rate": 0.12,
+      "approval_rate": 1.0
+    },
+    "after_design": {
+      "average_wait_minutes": 30,
+      "skip_rate": 0.0,
+      "approval_rate": 0.88
+    },
+    "before_deployment": {
+      "average_wait_minutes": 120,
+      "skip_rate": 0.0,
+      "approval_rate": 1.0
+    }
+  },
+
+  "efficiency_trends": {
+    "weekly": [
+      { "week": "2024-W01", "features": 2, "avg_duration_hours": 15.0 },
+      { "week": "2024-W02", "features": 3, "avg_duration_hours": 12.0 },
+      { "week": "2024-W03", "features": 3, "avg_duration_hours": 10.5 }
+    ],
+    "improvement_rate": 0.15,
+    "trend": "improving"
+  },
+
+  "quality_metrics": {
+    "test_coverage_average": 82,
+    "bugs_per_feature": 0.5,
+    "rework_rate": 0.08,
+    "code_review_iterations_average": 1.3
+  },
+
+  "learning_impact": {
+    "corrections_auto_applied": 23,
+    "time_saved_by_corrections_minutes": 180,
+    "patterns_learned": 45,
+    "suggestions_accepted_rate": 0.78
+  }
+}