proagents 1.6.12 → 1.6.13

package/.proagents/worklog/_context.md

@@ -8,6 +8,36 @@ Last AI: [None]
 
 ---
 
+## Quick Summary
+<!-- AI auto-generates this section - always keep under 5 lines -->
+```
+Last: [None yet]
+Active: No active features
+Pending: 0 tasks
+Tests: Unknown
+Status: Ready for work
+```
+
+---
+
+## Test Status
+<!-- AI updates after running tests -->
+```
+Status: Unknown
+Last Run: Never
+Failing: None
+```
+
+---
+
+## Feature Progress
+<!-- AI auto-calculates from completed vs pending tasks -->
+```
+No active features
+```
+
+---
+
 ## Active Work
 
 No active features yet. Start with `pa:feature "name"` or `pa:fix "issue"`.
@@ -38,6 +68,6 @@ None.
 
 ## How to Use
 
-1. **Starting work:** Run `pa:sync` to load this context
+1. **Starting work:** Context loads automatically on first pa: command
 2. **After code changes:** AI auto-updates this file
 3. **Check history:** See `./worklog/` for detailed session logs

package/.proagents/worklog/ai-stats.json

@@ -0,0 +1,19 @@
+{
+  "ai_platforms": {},
+  "totals": {
+    "total_sessions": 0,
+    "total_tasks": 0,
+    "total_files_modified": 0,
+    "total_reverts": 0
+  },
+  "_format": {
+    "platform_entry": {
+      "sessions": 0,
+      "tasks_completed": 0,
+      "files_modified": 0,
+      "reverts": 0,
+      "avg_session_minutes": 0,
+      "last_session": null
+    }
+  }
+}

package/README.md

@@ -86,6 +86,13 @@ Multiple AIs can work on the same project with full context sharing:
 | **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 |
 
 ```bash
 # Just start working - context loads automatically!
@@ -94,6 +101,9 @@ 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
@@ -157,8 +167,30 @@ proagents fix "bug description"       # Quick bug fix mode
 
 # Maintenance
 proagents doctor                      # Health check installation
-proagents upgrade                     # Upgrade to latest version
+proagents doctor --full               # Extended checks (branches, logs, features)
 proagents status                      # Show ProAgents status
+proagents version                     # Show detailed version info
+
+# Release Notes
+proagents release                     # Interactive release note generator
+proagents release -t detailed         # Full comprehensive notes
+proagents release -t short            # Quick summary
+proagents release -t client           # Business-focused, non-technical
+proagents release -t developer        # Technical details for devs
+proagents release -t hotfix           # Urgent patch notes
+proagents release -t prerelease       # Beta/RC notes
+proagents release --include fixes     # Only include bug fixes
+proagents release --include features  # Only include features
+proagents release --append -o FILE    # Append to existing notes
+proagents release --bump              # Suggest version bump
+proagents release --module auth       # Filter by module name
+proagents release --changelog         # Update CHANGELOG.md
+proagents release --tag               # Create git tag
+proagents release --json              # JSON output for CI/CD
+
+# Updating ProAgents
+npx proagents init                    # Smart update (recommended)
+proagents upgrade                     # Full replace (use with caution)
 
 # AI Platforms
 proagents ai list                     # List installed AI platforms
@@ -168,6 +200,34 @@ proagents ai remove                   # Remove platforms
 # Configuration
 proagents config show                 # Show current config
 proagents config setup                # Interactive config wizard
+proagents config export               # Export config for sharing
+proagents config import <file>        # Import config from file
+
+# Statistics & Monitoring
+proagents stats                       # Show project & AI usage stats
+proagents stats --json                # JSON output for scripting
+
+# Changelog Management
+proagents changelog view              # View recent changelog entries
+proagents changelog add "entry"       # Add new changelog entry
+proagents changelog list              # List available changelogs
+proagents changelog export            # Export to CHANGELOG.md
+proagents changelog git               # View git history as changelog
+
+# Backup & Restore
+proagents restore <backup.json>       # Restore from uninstall backup
+
+# Shell Completions
+proagents completion bash             # Generate bash completions
+proagents completion zsh              # Generate zsh completions
+proagents completion fish             # Generate fish completions
+
+# Quick File Access
+proagents open                        # Show available shortcuts
+proagents open config                 # Open proagents.config.yaml
+proagents open changelog              # Open recent changelog
+proagents open activity               # Open activity log
+proagents open context                # Open worklog context
 
 # Other
 proagents docs                        # Open documentation
@@ -175,6 +235,27 @@ proagents commands                    # Show all commands
 proagents uninstall                   # Remove ProAgents
 ```
 
+### Updating ProAgents
+
+| Command | What It Does | When to Use |
+|---------|--------------|-------------|
+| `npx proagents init` | **Smart update** - Updates 60 framework folders, merges config, preserves your work | **Recommended** for regular updates |
+| `proagents upgrade` | **Full replace** - Removes everything, installs fresh, restores backups | Only when you need a complete reset |
+
+**What's preserved with `init` (smart update):**
+- `active-features/` - Your work in progress
+- `changelog/` - Your change history (_recent.md, modules/, features/)
+- `worklog/` - Your work context (_context.md, ai-stats.json)
+- `.learning/` - Learned patterns
+- `cache/` - Analysis cache
+- `proagents.config.yaml` - Your values kept, new options merged
+
+**What's preserved with `upgrade` (full replace):**
+- `proagents.config.yaml`, `activity.log`, `handoff.md`, `.lock`
+- `active-features/` - All files
+- `changelog/` - _recent.md, modules/, features/, yearly folders
+- `worklog/` - _context.md, ai-stats.json
+
 ---
 
 ## AI Commands (pa:)
@@ -240,6 +321,8 @@ Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.):
 | `pa:session-start` | Begin new work session |
 | `pa:session-end` | Finalize session, update logs |
 | `pa:conflict-check` | Check if files modified by other AI |
+| `pa:undo-last` | Undo last AI's entire session (revert all changes) |
+| `pa:undo-file "path"` | Undo changes to specific file |
 | `pa:changelog` | Update all changelogs |
 | `pa:changelog --from-git` | Auto-populate from git commits |
 | `pa:changelog-feature X` | View feature changelog |
@@ -529,6 +612,7 @@ your-project/
 │   ├── custom-commands.yaml    # Custom pa: commands
 │   ├── worklog/                # Cross-AI session tracking
 │   │   ├── _context.md         # Quick context for any AI
+│   │   ├── ai-stats.json       # AI performance stats
 │   │   └── YYYY-MM-DD-ai-*.md  # Session logs
 │   ├── changelog/              # Detailed changelogs
 │   │   ├── _recent.md          # Last 10 changes

package/bin/proagents.js

@@ -8,10 +8,17 @@ import { statusCommand } from '../lib/commands/status.js';
 import { helpCommand } from '../lib/commands/help.js';
 import { aiAddCommand, aiListCommand, aiRemoveCommand } from '../lib/commands/ai.js';
 import { uninstallCommand } from '../lib/commands/uninstall.js';
-import { configListCommand, configShowCommand, configEditCommand, configSetCommand, configGetCommand, configSetupCommand, configCustomizeCommand } from '../lib/commands/config.js';
+import { configListCommand, configShowCommand, configEditCommand, configSetCommand, configGetCommand, configSetupCommand, configCustomizeCommand, configExportCommand, configImportCommand } from '../lib/commands/config.js';
 import { doctorCommand } from '../lib/commands/doctor.js';
 import { upgradeCommand } from '../lib/commands/upgrade.js';
 import { migrateCommand } from '../lib/commands/migrate.js';
+import { versionCommand } from '../lib/commands/version.js';
+import { releaseCommand } from '../lib/commands/release.js';
+import { statsCommand } from '../lib/commands/stats.js';
+import { restoreCommand } from '../lib/commands/restore.js';
+import { changelogCommand, changelogAddCommand, changelogListCommand, changelogExportCommand, changelogViewCommand } from '../lib/commands/changelog.js';
+import { completionCommand } from '../lib/commands/completion.js';
+import { openCommand } from '../lib/commands/open.js';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
@@ -149,6 +156,20 @@ config
   .description('Copy templates to create custom configurations')
   .action(configCustomizeCommand);
 
+config
+  .command('export')
+  .description('Export configuration for sharing or backup')
+  .option('-o, --output [path]', 'Output to file instead of stdout')
+  .action(configExportCommand);
+
+config
+  .command('import <file>')
+  .description('Import configuration from export file')
+  .option('-f, --force', 'Skip confirmation prompt')
+  .option('-q, --quiet', 'Minimal output')
+  .option('--json', 'Output in JSON format')
+  .action(configImportCommand);
+
 // Uninstall command
 program
   .command('uninstall')
@@ -166,6 +187,7 @@ program
 program
   .command('doctor')
   .description('Check health of ProAgents installation')
+  .option('--full', 'Run extended health checks')
   .action(doctorCommand);
 
 // Upgrade command
@@ -182,4 +204,113 @@ program
   .option('-f, --force', 'Skip confirmation prompt')
   .action(migrateCommand);
 
+// Version command (detailed)
+program
+  .command('version')
+  .description('Show detailed version information')
+  .option('--offline', 'Skip checking npm for latest version')
+  .action(versionCommand);
+
+// Stats command
+program
+  .command('stats')
+  .description('Show project and AI usage statistics')
+  .option('--json', 'Output in JSON format')
+  .action(statsCommand);
+
+// Restore command
+program
+  .command('restore <backup-file>')
+  .description('Restore ProAgents data from backup')
+  .option('-f, --force', 'Skip confirmation prompt')
+  .option('-q, --quiet', 'Minimal output')
+  .option('--json', 'Output in JSON format')
+  .action(restoreCommand);
+
+// Changelog commands
+const changelog = program
+  .command('changelog')
+  .description('Manage project changelogs');
+
+changelog
+  .command('view')
+  .description('View recent changelog entries (default)')
+  .option('-l, --limit <number>', 'Number of entries to show', '10')
+  .option('--json', 'Output in JSON format')
+  .action(changelogViewCommand);
+
+changelog
+  .command('add <entry>')
+  .description('Add a new changelog entry')
+  .option('--json', 'Output in JSON format')
+  .action(changelogAddCommand);
+
+changelog
+  .command('list')
+  .description('List available changelogs (features, modules, years)')
+  .option('--json', 'Output in JSON format')
+  .action(changelogListCommand);
+
+changelog
+  .command('export')
+  .description('Export changelog to CHANGELOG.md')
+  .option('--git', 'Include git commit history')
+  .option('--json', 'Output in JSON format')
+  .action(changelogExportCommand);
+
+changelog
+  .command('feature <name>')
+  .description('View changelog for a specific feature')
+  .action((name) => changelogCommand('feature', name));
+
+changelog
+  .command('module <name>')
+  .description('View changelog for a specific module')
+  .action((name) => changelogCommand('module', name));
+
+changelog
+  .command('git')
+  .description('View git commit history as changelog')
+  .option('--since <ref>', 'Start from tag/commit/date')
+  .option('--until <ref>', 'End at tag/commit/date')
+  .option('-l, --limit <number>', 'Number of commits', '20')
+  .action((options) => changelogCommand('git', null, options));
+
+// Release command
+program
+  .command('release')
+  .description('Generate release notes with type selection')
+  .option('-t, --type <type>', 'Release type: detailed, short, client, developer, hotfix, prerelease')
+  .option('-v, --version <version>', 'Version number (defaults to package.json)')
+  .option('-o, --output [path]', 'Output to file (optional path)')
+  .option('-a, --append', 'Append to existing release notes file')
+  .option('-i, --include <categories>', 'Include only: features,fixes,improvements,security,breaking,docs,deps,perf')
+  .option('-e, --exclude <categories>', 'Exclude categories (comma-separated)')
+  .option('-m, --module <name>', 'Filter by module/component name in commits')
+  .option('-p, --path <path>', 'Filter commits by file path')
+  .option('--since <ref>', 'Start from tag/commit/date')
+  .option('--until <ref>', 'End at tag/commit/date')
+  .option('--bump', 'Suggest version bump based on changes')
+  .option('--prerelease <stage>', 'Mark as pre-release (beta, rc, alpha)')
+  .option('--urgency <level>', 'Hotfix urgency level (low, medium, high, critical)')
+  .option('--interactive', 'Interactive mode with filter selection')
+  .option('--changelog', 'Update CHANGELOG.md with release notes')
+  .option('--tag', 'Create git tag for this release')
+  .option('--tag-message <message>', 'Custom message for git tag')
+  .option('--json', 'Output in JSON format (for scripting)')
+  .action(releaseCommand);
+
+// Completion command
+program
+  .command('completion [shell]')
+  .description('Generate shell completion scripts (bash, zsh, fish)')
+  .option('-q, --quiet', 'Skip install instructions')
+  .action(completionCommand);
+
+// Open command
+program
+  .command('open [target]')
+  .description('Open ProAgents files quickly (config, changelog, activity, etc.)')
+  .action(openCommand);
+
 program.parse();