proagents 1.6.21 → 1.6.22

package/.claude/settings.local.json

@@ -175,7 +175,9 @@
       "Bash(git -C /Users/prakash/Saeculum/AI/proAgents diff lib/commands/ai.js)",
       "Bash(for f in .proagents/AI_INSTRUCTIONS.md .proagents/CLAUDE.md .proagents/AGENTS.md .proagents/.cursorrules .proagents/.windsurfrules .proagents/GEMINI.md .proagents/BOLT.md .proagents/REPLIT.md .proagents/LOVABLE.md .proagents/KIRO.md)",
       "Bash(if grep -q \"AI directives\" \"$f\")",
-      "Bash(if grep -q \"ANY.*pa:.*command\" \"$f\")"
+      "Bash(if grep -q \"ANY.*pa:.*command\" \"$f\")",
+      "Bash(git worktree:*)",
+      "Bash(git worktree add:*)"
     ]
   }
 }

package/.proagents/.cursorrules

@@ -33,7 +33,7 @@ Commands that only READ, DISPLAY, or CONFIGURE:
 - **Skip AFTER step** - No logging needed
 
 **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
-`pa:ai-*`, `pa:config-*`, `pa:sync`
+`pa:ai-*`, `pa:config-*`, `pa:sync`, `pa:commit`, `pa:commit-config`
 
 ### AFTER Workflow Commands (Auto-Log)
 

package/.proagents/.windsurfrules

@@ -33,7 +33,7 @@ Commands that only READ, DISPLAY, or CONFIGURE:
 - **Skip AFTER step** - No logging needed
 
 **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
-`pa:ai-*`, `pa:config-*`, `pa:sync`
+`pa:ai-*`, `pa:config-*`, `pa:sync`, `pa:commit`, `pa:commit-config`
 
 ### AFTER Workflow Commands (Auto-Log)
 

package/.proagents/AGENTS.md

@@ -37,7 +37,7 @@ Commands that only READ, DISPLAY, or CONFIGURE:
 - **Skip AFTER step** - No logging needed
 
 **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
-`pa:ai-*`, `pa:config-*`, `pa:sync`
+`pa:ai-*`, `pa:config-*`, `pa:sync`, `pa:commit`, `pa:commit-config`
 
 ### AFTER Workflow Commands (Auto-Log)
 

package/.proagents/AI_INSTRUCTIONS.md

@@ -35,7 +35,7 @@ Commands that only READ, DISPLAY, or CONFIGURE:
 - **Skip AFTER step** - No logging needed
 
 **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
-`pa:ai-*`, `pa:config-*`, `pa:sync`
+`pa:ai-*`, `pa:config-*`, `pa:sync`, `pa:commit`, `pa:commit-config`
 
 ### AFTER Workflow Commands (Auto-Log)
 
@@ -470,6 +470,21 @@ Auto-detect issue numbers from user input and include in changelog:
 
 ---
 
+## Smart Workflow & Worktrees
+
+For smart workflow mode and worktree management:
+
+**See:** `./.proagents/prompts/11-session-tracking.md`
+
+### Quick Reference
+
+| Feature | Description |
+|---------|-------------|
+| Smart Workflow | Small task → auto branch, Large task → ask user |
+| Worktrees | Isolated directories for large/parallel tasks |
+
+---
+
 ## Command Quick Reference
 
 ### Aliases
@@ -488,6 +503,7 @@ Auto-detect issue numbers from user input and include in changelog:
 | `pa:rev` | `pa:review` |
 | `pa:dbg` | `pa:debug` |
 | `pa:l` | `pa:logs` |
+| `pa:c` | `pa:commit` |
 
 ### Core Commands
 | Command | Action |
@@ -592,6 +608,13 @@ Auto-detect issue numbers from user input and include in changelog:
 | `pa:changelog-module X` | View module changelog |
 | `pa:error "desc"` | Log error and solution |
 
+### Worktree Commands
+| Command | Action |
+|---------|--------|
+| `pa:worktree-create "name"` | Create worktree for large task |
+| `pa:worktree-list` | List all active worktrees |
+| `pa:worktree-remove "name"` | Remove worktree after merge |
+
 ### Configuration
 | Command | Action |
 |---------|--------|
@@ -691,6 +714,8 @@ When user types a `pa:` command:
 | `pa:ai-add` | `./prompts/ai-add.md` |
 | `pa:ai-remove` | `./prompts/ai-remove.md` |
 | `pa:ai-sync` | `./prompts/ai-sync.md` |
+| `pa:commit` | `./prompts/13-commit.md` |
+| `pa:commit-config` | `./prompts/13-commit.md` |
 
 ---
 
@@ -762,6 +787,9 @@ ProAgents Help
     pa:resume             Quick resume with next action
     pa:handoff            Create handoff notes
     pa:conflict-check     Check for conflicts
+    pa:worktree-create    Create worktree for large task
+    pa:worktree-list      List all active worktrees
+    pa:worktree-remove    Remove worktree after merge
 
   Learning & Tracking:
     pa:feedback "text"    Log feedback for AI learning

package/.proagents/BOLT.md

@@ -33,7 +33,7 @@ Commands that only READ, DISPLAY, or CONFIGURE:
 - **Skip AFTER step** - No logging needed
 
 **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
-`pa:ai-*`, `pa:config-*`, `pa:sync`
+`pa:ai-*`, `pa:config-*`, `pa:sync`, `pa:commit`, `pa:commit-config`
 
 ### AFTER Workflow Commands (Auto-Log)
 

package/.proagents/CLAUDE.md

@@ -33,7 +33,7 @@ Commands that only READ, DISPLAY, or CONFIGURE:
 - **Skip AFTER step** - No logging needed
 
 **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
-`pa:ai-*`, `pa:config-*`, `pa:sync`
+`pa:ai-*`, `pa:config-*`, `pa:sync`, `pa:commit`, `pa:commit-config`
 
 ### AFTER Workflow Commands (Auto-Log)
 

package/.proagents/GEMINI.md

@@ -33,7 +33,7 @@ Commands that only READ, DISPLAY, or CONFIGURE:
 - **Skip AFTER step** - No logging needed
 
 **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
-`pa:ai-*`, `pa:config-*`, `pa:sync`
+`pa:ai-*`, `pa:config-*`, `pa:sync`, `pa:commit`, `pa:commit-config`
 
 ### AFTER Workflow Commands (Auto-Log)
 

package/.proagents/KIRO.md

@@ -33,7 +33,7 @@ Commands that only READ, DISPLAY, or CONFIGURE:
 - **Skip AFTER step** - No logging needed
 
 **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
-`pa:ai-*`, `pa:config-*`, `pa:sync`
+`pa:ai-*`, `pa:config-*`, `pa:sync`, `pa:commit`, `pa:commit-config`
 
 ### AFTER Workflow Commands (Auto-Log)
 

package/.proagents/LOVABLE.md

@@ -33,7 +33,7 @@ Commands that only READ, DISPLAY, or CONFIGURE:
 - **Skip AFTER step** - No logging needed
 
 **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
-`pa:ai-*`, `pa:config-*`, `pa:sync`
+`pa:ai-*`, `pa:config-*`, `pa:sync`, `pa:commit`, `pa:commit-config`
 
 ### AFTER Workflow Commands (Auto-Log)
 

package/.proagents/REPLIT.md

@@ -33,7 +33,7 @@ Commands that only READ, DISPLAY, or CONFIGURE:
 - **Skip AFTER step** - No logging needed
 
 **Examples:** `pa:help`, `pa:status`, `pa:progress`, `pa:history`,
-`pa:ai-*`, `pa:config-*`, `pa:sync`
+`pa:ai-*`, `pa:config-*`, `pa:sync`, `pa:commit`, `pa:commit-config`
 
 ### AFTER Workflow Commands (Auto-Log)
 

package/.proagents/custom-commands.yaml

@@ -25,7 +25,7 @@ standup:
 sprint_review:
   description: "Generate sprint review summary"
   steps:
-    - "Read all session summaries from ./.proagents/sessions/"
+    - "Read all session summaries from ./.proagents/worklog/"
     - "Read ./CHANGELOG.md for completed features"
     - "Generate sprint review with completed items, metrics, and highlights"
   output: "./.proagents/sprint-reviews/YYYY-MM-DD.md"

package/.proagents/proagents.config.yaml

@@ -40,6 +40,61 @@ git:
   commit_convention: "conventional"  # conventional | simple | custom
   require_pr: true
 
+  # Pre-commit checks for pa:commit
+  pre_commit:
+    enabled: true           # Master toggle for pre-commit checks
+    lint: true              # Run linter before commit
+    type_check: true        # Run type checker before commit
+    test_affected: false    # Run tests for changed files
+
+  # Safety warnings for pa:commit
+  safety:
+    warn_main_branch: true      # Warn if committing to main/master
+    warn_sensitive_files: true  # Warn for .env, credentials, etc.
+    warn_large_files: true      # Warn if file > threshold
+    large_file_threshold: 1048576  # 1MB in bytes
+    sensitive_patterns:
+      - ".env*"
+      - "credentials*"
+      - "secrets*"
+      - "*.pem"
+      - "*.key"
+      - "id_rsa*"
+
+# Workflow Configuration
+# Controls how AI handles task size and worktrees
+workflow:
+  # Worktree mode: auto | always-ask | always-branch | always-worktree
+  # - auto: Small tasks use branch (no ask), large tasks ask user
+  # - always-ask: Always ask user for workflow choice
+  # - always-branch: Never use worktree, always simple branch
+  # - always-worktree: Always create worktree for each task
+  worktree_mode: "auto"
+
+  # Task size indicators for auto mode
+  task_indicators:
+    small:
+      - "fix typo"
+      - "small bug"
+      - "quick fix"
+      - "update text"
+      - "minor change"
+      - "hotfix"
+    large:
+      - "implement"
+      - "create feature"
+      - "refactor"
+      - "new module"
+      - "authentication"
+      - "payment"
+      - "integration"
+      - "migration"
+
+  # Worktree naming
+  worktree_naming:
+    prefix: "../"  # Relative to current directory
+    format: "{project}-{taskname}"  # e.g., myapp-user-auth
+
 # Parallel Feature Development
 parallel_features:
   enabled: true

package/.proagents/prompts/11-session-tracking.md

@@ -76,6 +76,106 @@ AI: "Fixed the login bug in src/auth/login.ts"
 | `pa:session-start` | Begin work session (AUTO) |
 | `pa:session-end` | End session (AUTO - logs on each change) |
 | `pa:handoff` | Create detailed handoff |
+| `pa:worktree-create "name"` | Create worktree for large task |
+| `pa:worktree-list` | List all active worktrees |
+| `pa:worktree-remove "name"` | Remove worktree after merge |
+
+---
+
+## Smart Workflow Mode
+
+AI automatically detects task size and chooses workflow.
+
+### Task Size Indicators
+
+| Small Task | Large Task |
+|------------|------------|
+| "fix typo", "small bug", "quick fix" | "implement", "feature", "refactor" |
+| 1-2 files | Multiple files |
+| Single function | New module |
+
+### Workflow Decision
+
+Read `workflow.worktree_mode` from `proagents.config.yaml`:
+
+- **auto** (default): Small → branch, Large → ask user
+- **always-ask**: Always ask user
+- **always-branch**: Never use worktree
+- **always-worktree**: Always create worktree
+
+### Small Task (Auto Branch)
+
+```
+User: "Fix the typo in README"
+AI: [Creates branch, proceeds immediately, no question]
+```
+
+### Large Task (Ask User)
+
+```
+User: "Implement user authentication"
+AI:
+═══════════════════════════════════════
+📋 LARGE TASK DETECTED
+
+Task: "Implement user authentication"
+
+1. Continue here (current branch)
+2. Create worktree (isolated directory)
+
+Which approach? [1/2]
+═══════════════════════════════════════
+```
+
+---
+
+## Worktree Commands
+
+### pa:worktree-create "name"
+
+Creates isolated worktree for task:
+
+```bash
+git worktree add ../[project]-[name] feature/[name]
+```
+
+Output:
+```
+═══════════════════════════════════════
+✅ Worktree Created
+
+Directory: ../myapp-user-auth/
+Branch: feature/user-auth
+
+Next Steps:
+1. Open the new directory in your IDE
+2. Work there - all changes go to feature/user-auth
+3. When done: pa:worktree-remove "user-auth"
+═══════════════════════════════════════
+```
+
+### pa:worktree-list
+
+```bash
+git worktree list
+```
+
+Output:
+```
+═══════════════════════════════════════
+📁 Active Worktrees
+
+/path/to/myapp                    main
+/path/to/myapp-user-auth          feature/user-auth [Claude]
+/path/to/myapp-rate-limiting      feature/rate-limiting [Cursor]
+═══════════════════════════════════════
+```
+
+### pa:worktree-remove "name"
+
+```bash
+git worktree remove ../myapp-[name]
+```
 
 ---
 

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/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

@@ -15,7 +15,6 @@ const PRESERVE_PATHS = [
   '.learning',                 // Learned patterns
   'changelog',                 // Change history (user data)
   'worklog',                   // Work context (user data)
-  'sessions',                  // Session data
   'backups',                   // User backups
 ];
 
@@ -1322,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) {
@@ -1406,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)) {
@@ -1435,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.21",
+  "version": "1.6.22",
   "description": "AI-agnostic development workflow framework that automates the full software development lifecycle",
   "type": "module",
   "main": "lib/index.js",

package/.proagents/sessions/README.md

@@ -1,5 +0,0 @@
-# Session Summaries
-
-This folder contains session summaries generated by `pa:session-end`.
-
-Each file is named: `YYYY-MM-DD-HHMMSS.md`