proagents 1.6.5 → 1.6.7

package/.proagents/AI_INSTRUCTIONS.md

@@ -273,6 +273,49 @@ When the user types commands starting with `pa:`, recognize and execute them.
 | `pa:help` | Show all available commands |
 | `pa:status` | Show current progress |
 
+**How to execute Initialization commands:**
+
+For `pa:status` (or `pa:s`):
+1. **Read the ACTUAL data** from `./.proagents/active-features/_index.json`
+2. **Check if empty** - if `active_features`, `paused_features`, and `completed_features` are all empty arrays:
+   ```
+   Project Status
+   ══════════════
+
+   No features currently tracked.
+
+   Start a new feature with:
+   → pa:feature-start "feature name"
+
+   Or quick bug fix:
+   → pa:fix "bug description"
+   ```
+
+3. **If has features**, show real status:
+   ```
+   Project Status
+   ══════════════
+
+   Active Features: [count]
+   ────────────────────────
+   • [feature-name] - [phase] ([progress]%)
+     Branch: [branch]
+     Last updated: [timestamp]
+
+   Paused Features: [count]
+   ────────────────────────
+   • [feature-name] - Paused: [reason]
+
+   Completed Features: [count]
+   ──────────────────────────
+   • [feature-name] - Completed [date]
+
+   Next Steps:
+   → [suggested action based on current state]
+   ```
+
+4. **NEVER show example/template data** - only show what's actually in the JSON file
+
 ### Feature Development
 | Command | Action |
 |---------|--------|

package/.proagents/active-features/_index.json

@@ -1,74 +1,22 @@
 {
   "$schema": "./schemas/index-schema.json",
   "version": "1.0.0",
-  "last_updated": "2024-01-15T10:30:00Z",
+  "last_updated": null,
 
-  "active_features": [
-    {
-      "id": "feature-user-auth",
-      "name": "User Authentication",
-      "description": "Add user authentication with OAuth support",
-      "current_phase": "implementation",
-      "phase_progress": 60,
-      "branch": "feature/user-auth",
-      "started": "2024-01-10T09:00:00Z",
-      "last_updated": "2024-01-15T10:30:00Z",
-      "estimated_completion": "2024-01-17T17:00:00Z",
-      "assignee": "developer-1",
-      "priority": "high",
-      "blockers": [],
-      "dependencies": [],
-      "files_modified_count": 12,
-      "checkpoints_completed": ["after_analysis", "after_requirements", "after_design"],
-      "checkpoints_pending": ["after_implementation", "before_deployment"]
-    }
-  ],
-
-  "paused_features": [
-    {
-      "id": "feature-notifications",
-      "name": "Push Notifications",
-      "description": "Add push notification support",
-      "current_phase": "requirements",
-      "phase_progress": 30,
-      "branch": "feature/notifications",
-      "started": "2024-01-08T14:00:00Z",
-      "paused_at": "2024-01-12T11:00:00Z",
-      "pause_reason": "Waiting for user-auth to complete",
-      "assignee": "developer-2",
-      "priority": "medium",
-      "blocked_by": ["feature-user-auth"]
-    }
-  ],
-
-  "completed_features": [
-    {
-      "id": "feature-dark-mode",
-      "name": "Dark Mode Support",
-      "completed_at": "2024-01-09T16:00:00Z",
-      "duration_hours": 18,
-      "merged_commit": "abc123def",
-      "pr_number": 42
-    }
-  ],
+  "active_features": [],
+  "paused_features": [],
+  "completed_features": [],
 
   "conflicts": {
     "active": [],
-    "resolved": [
-      {
-        "features": ["feature-user-auth", "feature-dark-mode"],
-        "file": "src/styles/theme.ts",
-        "resolved_at": "2024-01-09T15:30:00Z",
-        "resolution": "merged"
-      }
-    ]
+    "resolved": []
   },
 
   "statistics": {
-    "total_active": 1,
-    "total_paused": 1,
-    "total_completed": 1,
-    "average_completion_days": 3.5,
-    "conflict_rate": 0.15
+    "total_active": 0,
+    "total_paused": 0,
+    "total_completed": 0,
+    "average_completion_days": 0,
+    "conflict_rate": 0
   }
 }

package/lib/commands/init.js

@@ -595,6 +595,35 @@ function detectProjectType(targetDir) {
   return detectedTypes;
 }
 
+/**
+ * Prompt user for .gitignore preference
+ */
+async function promptGitignoreChoice() {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  const question = (prompt) => new Promise(resolve => rl.question(prompt, resolve));
+
+  console.log(chalk.bold('\nGit Ignore Settings'));
+  console.log(chalk.gray('─'.repeat(40) + '\n'));
+
+  console.log(chalk.cyan('What to ignore in .gitignore?'));
+  console.log(chalk.white('  1. Local data only') + chalk.green(' (recommended for teams)'));
+  console.log(chalk.gray('     Ignores: cache, learning, sessions, active-features'));
+  console.log(chalk.gray('     Shares: prompts, templates, config with team'));
+  console.log('');
+  console.log(chalk.white('  2. Entire .proagents/ folder') + chalk.gray(' (solo developers)'));
+  console.log(chalk.gray('     Nothing shared with git'));
+  console.log('');
+
+  const choice = await question(chalk.yellow('  Choose (1 or 2, default=1): '));
+  rl.close();
+
+  return choice.trim() === '2' ? 'full' : 'local';
+}
+
 /**
  * Interactive prompt for project configuration
  */
@@ -879,6 +908,49 @@ Generated by [ProAgents](https://github.com/prakashpro3/proAgents)
     }
     console.log(chalk.green('✓ Created docs/ folder structure'));
 
+    // Add .proagents/ to .gitignore - prompt user for preference
+    const gitignorePath = join(targetDir, '.gitignore');
+    const existingGitignore = existsSync(gitignorePath) ? readFileSync(gitignorePath, 'utf-8') : '';
+
+    if (!existingGitignore.includes('.proagents')) {
+      // Prompt user for gitignore preference
+      const gitignoreChoice = await promptGitignoreChoice();
+
+      let gitignoreEntries;
+      if (gitignoreChoice === 'full') {
+        // Ignore entire .proagents/ folder
+        gitignoreEntries = [
+          '# ProAgents - Entire folder ignored (not shared with team)',
+          '.proagents/',
+          ''
+        ].join('\n');
+      } else {
+        // Default: Ignore only local data
+        gitignoreEntries = [
+          '# ProAgents - Local data only (workflow config shared with team)',
+          '.proagents/cache/',
+          '.proagents/.learning/',
+          '.proagents/sessions/',
+          '.proagents/active-features/',
+          '.proagents/backups/',
+          '.proagents/*.log',
+          ''
+        ].join('\n');
+      }
+
+      if (existingGitignore) {
+        writeFileSync(gitignorePath, existingGitignore + '\n' + gitignoreEntries);
+      } else {
+        writeFileSync(gitignorePath, gitignoreEntries);
+      }
+
+      if (gitignoreChoice === 'full') {
+        console.log(chalk.green('✓ Added .proagents/ to .gitignore (entire folder)'));
+      } else {
+        console.log(chalk.green('✓ Added .proagents/ local data to .gitignore'));
+      }
+    }
+
     // Create placeholder CHANGELOG.md if not exists
     const changelogPath = join(targetDir, 'CHANGELOG.md');
     if (!existsSync(changelogPath)) {

package/package.json

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

package/.proagents/active-features/feature-user-auth/dependencies.json

@@ -1,81 +0,0 @@
-{
-  "$schema": "../schemas/dependencies-schema.json",
-  "feature_id": "feature-user-auth",
-  "updated_at": "2024-01-15T10:30:00Z",
-
-  "depends_on": [],
-
-  "blocks": [
-    {
-      "feature_id": "feature-notifications",
-      "reason": "Notifications require authenticated user context",
-      "required_phase": "implementation_complete",
-      "blocking_since": "2024-01-12T11:00:00Z"
-    },
-    {
-      "feature_id": "feature-user-preferences",
-      "reason": "Preferences need user authentication",
-      "required_phase": "testing_complete"
-    }
-  ],
-
-  "shared_resources": [
-    {
-      "resource": "prisma/schema.prisma",
-      "shared_with": ["feature-user-preferences"],
-      "conflict_risk": "medium",
-      "coordination_required": true
-    },
-    {
-      "resource": "src/middleware.ts",
-      "shared_with": [],
-      "conflict_risk": "low"
-    }
-  ],
-
-  "external_dependencies": {
-    "packages": [
-      {
-        "name": "next-auth",
-        "version": "^4.24.0",
-        "added": true,
-        "reason": "Authentication framework"
-      },
-      {
-        "name": "@auth/prisma-adapter",
-        "version": "^1.0.0",
-        "added": true,
-        "reason": "Prisma adapter for NextAuth"
-      }
-    ],
-    "services": [
-      {
-        "name": "Google OAuth",
-        "type": "oauth_provider",
-        "required": true,
-        "configured": true
-      },
-      {
-        "name": "GitHub OAuth",
-        "type": "oauth_provider",
-        "required": true,
-        "configured": true
-      }
-    ],
-    "environment_variables": [
-      "NEXTAUTH_SECRET",
-      "NEXTAUTH_URL",
-      "GOOGLE_CLIENT_ID",
-      "GOOGLE_CLIENT_SECRET",
-      "GITHUB_CLIENT_ID",
-      "GITHUB_CLIENT_SECRET"
-    ]
-  },
-
-  "merge_requirements": {
-    "order": 1,
-    "can_merge_independently": true,
-    "requires_features": [],
-    "required_before": ["feature-notifications", "feature-user-preferences"]
-  }
-}

package/.proagents/active-features/feature-user-auth/files-modified.json

@@ -1,126 +0,0 @@
-{
-  "$schema": "../schemas/files-schema.json",
-  "feature_id": "feature-user-auth",
-  "updated_at": "2024-01-15T10:30:00Z",
-
-  "summary": {
-    "total_files": 12,
-    "new_files": 8,
-    "modified_files": 4,
-    "deleted_files": 0,
-    "lines_added": 845,
-    "lines_removed": 23
-  },
-
-  "files": [
-    {
-      "path": "src/lib/auth.ts",
-      "status": "new",
-      "lines_added": 120,
-      "lines_removed": 0,
-      "last_modified": "2024-01-14T16:30:00Z",
-      "purpose": "Core authentication utilities"
-    },
-    {
-      "path": "src/app/api/auth/[...nextauth]/route.ts",
-      "status": "new",
-      "lines_added": 85,
-      "lines_removed": 0,
-      "last_modified": "2024-01-14T14:00:00Z",
-      "purpose": "NextAuth API route handler"
-    },
-    {
-      "path": "src/components/auth/LoginButton.tsx",
-      "status": "new",
-      "lines_added": 45,
-      "lines_removed": 0,
-      "last_modified": "2024-01-15T09:00:00Z",
-      "purpose": "Login button component"
-    },
-    {
-      "path": "src/components/auth/LogoutButton.tsx",
-      "status": "new",
-      "lines_added": 35,
-      "lines_removed": 0,
-      "last_modified": "2024-01-15T09:15:00Z",
-      "purpose": "Logout button component"
-    },
-    {
-      "path": "src/components/auth/UserMenu.tsx",
-      "status": "new",
-      "lines_added": 78,
-      "lines_removed": 0,
-      "last_modified": "2024-01-15T10:00:00Z",
-      "purpose": "User dropdown menu"
-    },
-    {
-      "path": "src/hooks/useAuth.ts",
-      "status": "new",
-      "lines_added": 52,
-      "lines_removed": 0,
-      "last_modified": "2024-01-14T15:00:00Z",
-      "purpose": "Authentication hook"
-    },
-    {
-      "path": "src/middleware.ts",
-      "status": "modified",
-      "lines_added": 35,
-      "lines_removed": 5,
-      "last_modified": "2024-01-14T17:00:00Z",
-      "purpose": "Added auth middleware"
-    },
-    {
-      "path": "src/types/auth.ts",
-      "status": "new",
-      "lines_added": 28,
-      "lines_removed": 0,
-      "last_modified": "2024-01-14T11:00:00Z",
-      "purpose": "Authentication type definitions"
-    },
-    {
-      "path": "src/app/layout.tsx",
-      "status": "modified",
-      "lines_added": 15,
-      "lines_removed": 8,
-      "last_modified": "2024-01-15T10:30:00Z",
-      "purpose": "Added SessionProvider wrapper"
-    },
-    {
-      "path": "prisma/schema.prisma",
-      "status": "modified",
-      "lines_added": 42,
-      "lines_removed": 0,
-      "last_modified": "2024-01-13T14:00:00Z",
-      "purpose": "Added User and Session models"
-    },
-    {
-      "path": ".env.example",
-      "status": "modified",
-      "lines_added": 8,
-      "lines_removed": 0,
-      "last_modified": "2024-01-13T10:00:00Z",
-      "purpose": "Added auth environment variables"
-    },
-    {
-      "path": "src/tests/auth.test.ts",
-      "status": "new",
-      "lines_added": 302,
-      "lines_removed": 0,
-      "last_modified": "2024-01-15T10:15:00Z",
-      "purpose": "Authentication test suite"
-    }
-  ],
-
-  "conflicts": {
-    "potential": [],
-    "detected": [],
-    "resolved": []
-  },
-
-  "impact_analysis": {
-    "affected_modules": ["auth", "middleware", "database"],
-    "breaking_changes": false,
-    "requires_migration": true,
-    "security_sensitive": true
-  }
-}

package/.proagents/active-features/feature-user-auth/status.json

@@ -1,122 +0,0 @@
-{
-  "$schema": "../schemas/feature-schema.json",
-  "id": "feature-user-auth",
-  "name": "User Authentication",
-  "description": "Add user authentication with OAuth support for Google and GitHub",
-  "created_at": "2024-01-10T09:00:00Z",
-  "updated_at": "2024-01-15T10:30:00Z",
-
-  "workflow": {
-    "mode": "full",
-    "entry_point": "feature_start",
-    "current_phase": "implementation",
-    "phase_progress": 60
-  },
-
-  "phases": {
-    "init": {
-      "status": "completed",
-      "started_at": "2024-01-10T09:00:00Z",
-      "completed_at": "2024-01-10T09:15:00Z",
-      "duration_minutes": 15
-    },
-    "analysis": {
-      "status": "completed",
-      "started_at": "2024-01-10T09:15:00Z",
-      "completed_at": "2024-01-10T10:00:00Z",
-      "duration_minutes": 45,
-      "artifacts": ["analysis-report.md"]
-    },
-    "requirements": {
-      "status": "completed",
-      "started_at": "2024-01-10T10:00:00Z",
-      "completed_at": "2024-01-10T11:30:00Z",
-      "duration_minutes": 90,
-      "artifacts": ["requirements.md", "user-stories.md"]
-    },
-    "design": {
-      "status": "completed",
-      "started_at": "2024-01-10T13:00:00Z",
-      "completed_at": "2024-01-10T15:00:00Z",
-      "duration_minutes": 120,
-      "artifacts": ["ui-specification.md", "component-designs.md"]
-    },
-    "planning": {
-      "status": "completed",
-      "started_at": "2024-01-10T15:00:00Z",
-      "completed_at": "2024-01-10T16:00:00Z",
-      "duration_minutes": 60,
-      "artifacts": ["implementation-plan.md"]
-    },
-    "implementation": {
-      "status": "in_progress",
-      "started_at": "2024-01-11T09:00:00Z",
-      "progress": 60,
-      "tasks_completed": 6,
-      "tasks_total": 10
-    },
-    "testing": {
-      "status": "pending"
-    },
-    "review": {
-      "status": "pending"
-    },
-    "documentation": {
-      "status": "pending"
-    },
-    "deployment": {
-      "status": "pending"
-    }
-  },
-
-  "checkpoints": {
-    "after_analysis": {
-      "triggered": true,
-      "approved": true,
-      "approved_by": "@tech-lead",
-      "approved_at": "2024-01-10T10:05:00Z"
-    },
-    "after_requirements": {
-      "triggered": true,
-      "approved": true,
-      "approved_by": "@product-manager",
-      "approved_at": "2024-01-10T11:45:00Z"
-    },
-    "after_design": {
-      "triggered": true,
-      "approved": true,
-      "approved_by": "@tech-lead",
-      "approved_at": "2024-01-10T15:15:00Z"
-    },
-    "after_implementation": {
-      "triggered": false
-    },
-    "before_deployment": {
-      "triggered": false
-    }
-  },
-
-  "git": {
-    "branch": "feature/user-auth",
-    "base_branch": "develop",
-    "commits": 12,
-    "last_commit": "abc123def",
-    "pr_number": null,
-    "pr_status": null
-  },
-
-  "assignees": {
-    "primary": "developer-1",
-    "reviewers": ["tech-lead", "developer-2"]
-  },
-
-  "context": {
-    "key_decisions": [
-      "Using NextAuth.js for authentication",
-      "JWT tokens stored in httpOnly cookies",
-      "Refresh token rotation enabled"
-    ],
-    "open_questions": [],
-    "blockers": []
-  }
-}