proagents 1.6.20 → 1.6.22

package/.proagents/prompts/13-commit.md

@@ -0,0 +1,426 @@
+# Smart Commit Workflow
+
+Interactive commit with file selection, safety checks, and smart message generation.
+
+---
+
+## CRITICAL RULES - READ FIRST
+
+```
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+!!                                                        !!
+!!  THIS IS AN INTERACTIVE COMMAND                        !!
+!!                                                        !!
+!!  YOU MUST ASK USER AND WAIT FOR RESPONSE AT EACH STEP  !!
+!!                                                        !!
+!!  DO NOT:                                               !!
+!!  - Skip steps                                          !!
+!!  - Assume user choices                                 !!
+!!  - Commit without explicit user confirmation           !!
+!!  - Modify config without user selection                !!
+!!                                                        !!
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+```
+
+---
+
+## Commands
+
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `pa:commit` | `pa:c` | Smart commit workflow |
+| `pa:commit-config` | - | Configure pre-commit checks |
+
+---
+
+# pa:commit Workflow
+
+## Step 1: Show Current State and ASK
+
+First, run these commands silently:
+```bash
+git status --porcelain
+git diff --stat
+git diff --cached --stat
+git branch --show-current
+```
+
+Then DISPLAY this to user and WAIT for their choice:
+
+```
+═══════════════════════════════════════
+SMART COMMIT
+
+Current Branch: [branch name]
+
+Staged Files:
+  [list staged files with +/- lines]
+
+Unstaged Files:
+  [list unstaged files with +/- lines]
+
+Untracked Files:
+  [list new files]
+
+Which files do you want to commit?
+
+  1. Staged only
+  2. Unstaged only
+  3. All changes
+  4. Let me select specific files
+
+Enter choice (1-4):
+═══════════════════════════════════════
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+---
+
+## Step 1b: Handle "Select Specific Files" (Option 4)
+
+**ONLY if user chose option 4**, show numbered list of ALL files:
+
+```
+═══════════════════════════════════════
+SELECT FILES TO COMMIT
+
+  1. AGENTS.md (+1, -1)
+  2. CLAUDE.md (+1, -1)
+  3. docs/releases/v0.0.1.md (+4, -1)
+  4. ios/IQAuditor.xcodeproj/project.pbxproj (+16, -10)
+  5. android/app/release/app-release.aab (new, 97MB)
+
+Enter file numbers to INCLUDE (comma-separated):
+Example: 1,2,3 or 1-3 or all
+
+═══════════════════════════════════════
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+After user provides numbers, those are the ONLY files to commit.
+**SKIP Step 2** (exclusions) since user already selected specific files.
+Proceed directly to Step 3 (Safety Checks).
+
+---
+
+## Step 2: Ask About Exclusions
+
+**SKIP this step if user chose option 4 in Step 1.**
+
+Only for options 1, 2, or 3, ASK:
+
+```
+Any files to EXCLUDE from this commit?
+
+Enter file paths (comma-separated) or "none":
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+---
+
+## Step 3: Safety Checks
+
+### 3a. Branch Check
+
+If current branch is `main` or `master`, STOP and ASK:
+
+```
+WARNING: You are committing to 'main' branch!
+
+What do you want to do?
+
+  1. Create a new branch first
+  2. Continue on main anyway
+  3. Cancel
+
+Enter choice (1-3):
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+If user chose 1, ASK for branch name:
+```
+Enter new branch name (e.g., fix/bug-name):
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+### 3b. Sensitive File Check
+
+Check if any selected file matches:
+- `.env*`
+- `credentials*`, `secrets*`
+- `*.pem`, `*.key`, `id_rsa*`
+
+If found, STOP and ASK:
+
+```
+WARNING: Sensitive file(s) detected!
+
+  - .env.local
+  - config/secrets.json
+
+These files may contain secrets. What do you want to do?
+
+  1. Exclude these files and continue
+  2. Commit anyway (not recommended)
+  3. Cancel
+
+Enter choice (1-3):
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+### 3c. Large File Check
+
+Check if any file > 1MB. If found, STOP and ASK:
+
+```
+WARNING: Large file detected!
+
+  - assets/video.mp4 (15.2 MB)
+
+Large files can slow down your repository.
+
+  1. Exclude this file
+  2. Commit anyway
+  3. Cancel
+
+Enter choice (1-3):
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+---
+
+## Step 4: Generate Message and ASK
+
+Analyze the diff and generate a commit message. Then SHOW and ASK:
+
+```
+═══════════════════════════════════════
+SUGGESTED COMMIT MESSAGE
+
+[type]([scope]): [description]
+
+- [bullet point 1]
+- [bullet point 2]
+
+═══════════════════════════════════════
+
+What do you want to do?
+
+  1. Use this message
+  2. Edit this message (tell me what to change)
+  3. I'll write my own message
+  4. Cancel
+
+Enter choice (1-4):
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+If user chose 2:
+```
+What would you like to change in the message?
+```
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+If user chose 3:
+```
+Enter your commit message:
+```
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+---
+
+## Step 5: Confirm Before Commit
+
+Before executing, show summary and ASK:
+
+```
+═══════════════════════════════════════
+COMMIT SUMMARY
+
+Files to commit:
+  - file1.ts
+  - file2.ts
+
+Message:
+  feat(auth): Add password validation
+
+Proceed with commit?
+
+  1. Yes, commit now
+  2. No, cancel
+
+Enter choice (1-2):
+═══════════════════════════════════════
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+---
+
+## Step 6: Execute and Ask About Push
+
+Only after user confirms, execute:
+```bash
+git add [selected files]
+git commit -m "[message]"
+```
+
+Then show result and ASK:
+
+```
+Commit successful! [commit hash]
+
+  [commit message]
+
+  [X] files changed, [+] insertions, [-] deletions
+
+Do you want to push now?
+
+  1. Yes, push to remote
+  2. No, I'll push later
+
+Enter choice (1-2):
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+---
+
+# pa:commit-config Workflow
+
+## CRITICAL: This is INTERACTIVE
+
+```
+DO NOT modify config without asking user!
+DO NOT assume which settings to change!
+SHOW current settings and ASK what to toggle!
+```
+
+## Step 1: Read and Display Current Config
+
+Read `proagents.config.yaml` and DISPLAY:
+
+```
+═══════════════════════════════════════
+COMMIT CONFIGURATION
+
+Current Settings:
+
+Pre-commit Checks:
+  1. [ON/OFF] Lint check
+  2. [ON/OFF] Type check
+  3. [ON/OFF] Test affected files
+
+Safety Warnings:
+  4. [ON/OFF] Warn on main/master branch
+  5. [ON/OFF] Warn on sensitive files
+  6. [ON/OFF] Warn on large files (>1MB)
+
+  7. Save and exit
+
+Which setting do you want to toggle? (1-7):
+═══════════════════════════════════════
+```
+
+**>>> STOP HERE. WAIT FOR USER TO RESPOND. <<<**
+
+## Step 2: Toggle and Show Updated
+
+After user selects a number (1-6), toggle that setting and show updated list again.
+
+Repeat until user selects 7 (Save and exit).
+
+## Step 3: Save and Confirm
+
+When user selects 7:
+
+```
+Saving configuration...
+
+Updated settings:
+  - lint: true -> false
+  - type_check: true (unchanged)
+
+Configuration saved to proagents.config.yaml
+```
+
+---
+
+# Commit Message Rules
+
+## Types
+
+| Type | When to use |
+|------|-------------|
+| feat | New feature or functionality |
+| fix | Bug fix |
+| refactor | Code restructuring (no new feature) |
+| docs | Documentation only |
+| test | Adding or updating tests |
+| chore | Maintenance, dependencies |
+| style | Formatting, whitespace |
+
+## Scope Detection
+
+| File Path | Scope |
+|-----------|-------|
+| src/auth/* | auth |
+| src/api/*, routes/* | api |
+| src/components/* | ui |
+| src/services/* | services |
+| src/utils/*, lib/* | utils |
+| tests/* | test |
+
+## Format
+
+```
+type(scope): Short description (max 72 chars)
+
+- Bullet point for each change
+- Keep it concise
+```
+
+---
+
+# Config Reference
+
+```yaml
+git:
+  pre_commit:
+    enabled: true
+    lint: true
+    type_check: true
+    test_affected: false
+  safety:
+    warn_main_branch: true
+    warn_sensitive_files: true
+    warn_large_files: true
+    large_file_threshold: 1048576
+    sensitive_patterns:
+      - ".env*"
+      - "credentials*"
+      - "secrets*"
+      - "*.pem"
+      - "*.key"
+```
+
+---
+
+# Summary
+
+| Step | Action | Requires User Input? |
+|------|--------|---------------------|
+| 1 | Show files | YES - which files |
+| 2 | Exclusions | YES - any to exclude |
+| 3 | Safety checks | YES - if warnings |
+| 4 | Commit message | YES - use/edit/custom |
+| 5 | Confirm | YES - proceed? |
+| 6 | Push option | YES - push now? |

package/.proagents/workflow-modes/entry-modes.md

@@ -127,8 +127,7 @@ Streamlined workflow for fixing bugs quickly without skipping quality.
 │  Phase 1: Context Scan (2-5 min)                            │
 │  ├── Identify affected files from bug description           │
 │  ├── Scan recent changes (git history)                      │
-│  ├── Check related components                               │
-│  └── Load cached analysis if available                      │
+│  └── Check related components                               │
 │                                                             │
 │  Phase 2: Root Cause Analysis                               │
 │  ├── Identify the bug source                                │
@@ -186,10 +185,6 @@ auto_context:
     components: true
     services: true
     tests: true
-
-  load_cached:
-    analysis: true
-    patterns: true
 ```
 
 ### Guardrails

package/COMMANDS.md

@@ -27,6 +27,7 @@ Complete reference for CLI and AI (`pa:`) commands. For quick start, see [README
 - [Documentation](#documentation)
 - [Quality & Testing](#quality--testing)
 - [Cross-AI Continuity](#cross-ai-continuity)
+- [Worktree Management](#worktree-management)
 - [Learning & Tracking](#learning--tracking)
 - [Navigation & Flow](#navigation--flow)
 - [Context & History](#context--history)
@@ -327,6 +328,21 @@ Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.)
 
 ---
 
+## Worktree Management
+
+| Command | Description |
+|---------|-------------|
+| `pa:worktree-create "name"` | Create worktree for large task |
+| `pa:worktree-list` | List all active worktrees |
+| `pa:worktree-remove "name"` | Remove worktree after merge |
+
+**When to use worktrees:**
+- Large features (days/weeks of work)
+- Parallel work (multiple AIs or developers)
+- Need to run/test multiple versions simultaneously
+
+---
+
 ## Learning & Tracking
 
 | Command | Description |
@@ -487,6 +503,9 @@ Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.)
 
 | Command | Description |
 |---------|-------------|
+| `pa:commit` | Smart commit with file selection and message generation |
+| `pa:c` | Alias for pa:commit |
+| `pa:commit-config` | Configure pre-commit checks (lint, type-check, tests) |
 | `pa:branch` | Branch management |
 | `pa:merge` | Smart merge with conflict preview |
 | `pa:conflict` | Resolve merge conflicts with AI |

package/lib/commands/init.js

@@ -13,10 +13,8 @@ const __dirname = dirname(__filename);
 const PRESERVE_PATHS = [
   'active-features',           // User's work in progress
   '.learning',                 // Learned patterns
-  'cache',                     // Cached analysis
   'changelog',                 // Change history (user data)
   'worklog',                   // Work context (user data)
-  'sessions',                  // Session data
   'backups',                   // User backups
 ];
 
@@ -148,10 +146,9 @@ const CONFIG_FILE = 'proagents.config.yaml';
 const FRAMEWORK_FOLDERS = [
   'prompts',
   'templates',
-  'checklists',
   'standards',
   'examples',
-  'git',
+  'docs',
   'ui-integration',
   'workflow-modes',
   'security',
@@ -161,25 +158,32 @@ const FRAMEWORK_FOLDERS = [
   'scaffolding',
   'cli',
   'adr',
+  'config',
+  'existing-projects',
+  'getting-started',
+];
+
+// Deprecated folders to remove during update (no longer part of framework)
+const DEPRECATED_FOLDERS = [
   'ai-models',
   'ai-training',
   'api-versioning',
   'approval-workflows',
   'automation',
+  'cache',
+  'checklists',
   'cicd',
   'collaboration',
   'compliance',
   'config-versioning',
-  'config',
   'contract-testing',
   'cost',
   'database',
   'dependency-management',
   'disaster-recovery',
   'environments',
-  'existing-projects',
   'feature-flags',
-  'getting-started',
+  'git',
   'i18n',
   'ide-integration',
   'integrations',
@@ -200,11 +204,19 @@ const FRAMEWORK_FOLDERS = [
   'rules',
   'runbooks',
   'secrets',
+  'sprints',
   'team',
   'troubleshooting',
   'webhooks',
 ];
 
+// Deprecated files to remove during update
+const DEPRECATED_FILES = [
+  'checkpoints.json',
+  'history.log',
+  'time-tracking.json',
+];
+
 // Root files to always update (AI files handled separately via platform selection)
 const FRAMEWORK_FILES = [
   'README.md',
@@ -214,6 +226,16 @@ const FRAMEWORK_FILES = [
   'slash-commands.json',
   'AI_INSTRUCTIONS.md',  // Universal instructions kept for reference
   'platforms.yaml',      // Single source of truth for AI platforms
+  // Platform instruction files (updated during init)
+  'AGENTS.md',
+  'CLAUDE.md',
+  '.cursorrules',
+  '.windsurfrules',
+  'GEMINI.md',
+  'BOLT.md',
+  'REPLIT.md',
+  'LOVABLE.md',
+  'KIRO.md',
 ];
 
 // Universal AI file - always copied to project root (not selectable)
@@ -1019,7 +1041,8 @@ export async function initCommand(options = {}) {
         console.log(chalk.gray('  • active-features/ (your work in progress)'));
         console.log(chalk.gray('  • proagents.config.yaml (your values + new options merged)'));
         console.log(chalk.gray('  • .learning/ (learned patterns)'));
-        console.log(chalk.gray('  • cache/ (analysis cache)\n'));
+        console.log(chalk.gray('  • changelog/ (change history)'));
+        console.log(chalk.gray('  • worklog/ (work context)\n'));
         return;
       } catch (error) {
         console.error(chalk.red('\n✗ Error updating ProAgents:'));
@@ -1114,7 +1137,6 @@ Generated by [ProAgents](https://github.com/prakashpro3/proAgents)
         // Default: Ignore only local data
         gitignoreEntries = [
           '# ProAgents - Local data only (workflow config shared with team)',
-          '.proagents/cache/',
           '.proagents/.learning/',
           '.proagents/sessions/',
           '.proagents/active-features/',
@@ -1299,6 +1321,9 @@ For detailed commands, see \`./.proagents/PROAGENTS.md\`
  * Smart update - preserves user files, updates framework files
  */
 async function smartUpdate(sourceDir, targetDir) {
+  // Project root is parent of .proagents folder
+  const projectRoot = join(targetDir, '..');
+
   // Backup preserved paths
   const backups = {};
   for (const path of PRESERVE_PATHS) {
@@ -1340,6 +1365,32 @@ async function smartUpdate(sourceDir, targetDir) {
   }
   console.log(chalk.green(`✓ Updated ${updatedCount} framework folders`));
 
+  // Remove deprecated folders
+  let removedFolders = 0;
+  for (const folder of DEPRECATED_FOLDERS) {
+    const folderPath = join(targetDir, folder);
+    if (existsSync(folderPath)) {
+      rmSync(folderPath, { recursive: true, force: true });
+      removedFolders++;
+    }
+  }
+  if (removedFolders > 0) {
+    console.log(chalk.green(`✓ Removed ${removedFolders} deprecated folders`));
+  }
+
+  // Remove deprecated files
+  let removedFiles = 0;
+  for (const file of DEPRECATED_FILES) {
+    const filePath = join(targetDir, file);
+    if (existsSync(filePath)) {
+      rmSync(filePath, { force: true });
+      removedFiles++;
+    }
+  }
+  if (removedFiles > 0) {
+    console.log(chalk.green(`✓ Removed ${removedFiles} deprecated files`));
+  }
+
   // Restore user files that were migrated (they were saved before folder deletion)
   restoreUserFiles(targetDir, migrationResult);
 
@@ -1357,7 +1408,8 @@ async function smartUpdate(sourceDir, targetDir) {
   console.log(chalk.green(`✓ Updated ${filesUpdated} framework files`));
 
   // Merge config file - keep user values, add new options
-  const userConfigPath = join(targetDir, CONFIG_FILE);
+  // User config is at project root, not inside .proagents
+  const userConfigPath = join(projectRoot, CONFIG_FILE);
   const newConfigPath = join(sourceDir, CONFIG_FILE);
 
   if (existsSync(newConfigPath)) {
@@ -1386,7 +1438,6 @@ async function smartUpdate(sourceDir, targetDir) {
   }
 
   // Copy AI instruction files for configured platforms (merges with existing files)
-  const projectRoot = join(targetDir, '..');
   const configPath = join(projectRoot, 'proagents.config.yaml');
   const selectedPlatforms = loadPlatformConfig(configPath);
 

package/package.json

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