proagents 1.6.10 → 1.6.12

package/.proagents/docs/command-details.md

@@ -327,11 +327,313 @@ Generate release notes:
 
 ### pa:changelog
 
-Update changelog:
+**AI updates ALL changelog files for cross-AI continuity.**
 
-1. Read changes since last entry
-2. Format according to Keep a Changelog
-3. Update `./CHANGELOG.md`
+1. Update `./CHANGELOG.md` (public changelog)
+2. Prepend to `.proagents/changelog/_recent.md` (last 10 changes)
+3. Update feature changelog if working on a feature
+4. Update module changelog based on files modified
+
+```bash
+# AI workflow:
+# 1. Identify what changed
+# 2. Determine feature/module from context
+
+# 3. Update root changelog
+# Edit ./CHANGELOG.md
+
+# 4. Prepend to recent changes
+# Edit .proagents/changelog/_recent.md
+
+# 5. Update feature changelog (if applicable)
+# Edit .proagents/changelog/features/[feature-name].md
+
+# 6. Update module changelog (auto-detect from paths)
+# Edit .proagents/changelog/modules/[module].md
+```
+
+### pa:changelog-feature [name]
+
+View/update specific feature changelog:
+```bash
+cat .proagents/changelog/features/[name].md
+```
+
+### pa:changelog-module [name]
+
+View/update specific module changelog:
+```bash
+cat .proagents/changelog/modules/[name].md
+```
+
+---
+
+## Cross-AI Continuity Commands
+
+### pa:sync
+
+**Run FIRST when starting work on any AI platform.**
+
+AI reads context files to understand current state:
+
+```bash
+# AI executes:
+cat .proagents/worklog/_context.md
+cat .proagents/changelog/_recent.md
+ls -t .proagents/worklog/*.md | head -3 | xargs cat
+cat .proagents/active-features/_index.json
+tail -20 .proagents/activity.log
+```
+
+Then reports:
+```
+Project Context Loaded!
+
+Active Work:
+- Feature: user-auth (70% complete)
+- Last: JWT validation added by Claude
+
+Recent Changes:
+1. Added login validation (Claude, Mar 11)
+2. Fixed API endpoint (Gemini, Mar 10)
+
+Pending:
+- [ ] Complete email verification
+- [ ] Add unit tests
+
+Ready to continue. What would you like to work on?
+```
+
+### pa:session-start
+
+Begin a new work session:
+
+```bash
+# AI creates session log
+DATE=$(date '+%Y-%m-%d')
+# Creates: .proagents/worklog/YYYY-MM-DD-[ai]-001.md
+```
+
+### pa:session-end
+
+Finalize session and update all tracking:
+
+```bash
+# AI updates:
+# 1. Session log with summary and next steps
+# 2. .proagents/worklog/_context.md
+# 3. .proagents/changelog/_recent.md
+# 4. Feature/module changelogs
+# 5. activity.log
+```
+
+Output:
+```
+Session Complete!
+- Duration: 45 min
+- Tasks: 3 completed
+- Files: 5 modified
+
+Updated:
+✓ worklog/_context.md
+✓ worklog/2024-03-11-claude-001.md
+✓ changelog/features/user-auth.md
+✓ changelog/_recent.md
+✓ activity.log
+
+Next AI can continue from: [next steps listed]
+```
+
+### pa:resume
+
+**Quick resume for returning AI - loads context and shows next action.**
+
+```bash
+# AI executes:
+cat .proagents/worklog/_context.md
+cat .proagents/changelog/_recent.md
+ls -t .proagents/worklog/*.md 2>/dev/null | head -2 | tail -1 | xargs cat
+tail -10 .proagents/activity.log
+```
+
+Output:
+```
+Resume Context
+══════════════
+Last Session: 2024-03-11 by Claude (opus-4)
+Duration: 45 min
+
+What Was Done:
+- Added JWT validation
+- Fixed login bug
+- Updated API docs
+
+Pending Tasks:
+1. [ ] Complete email verification
+2. [ ] Add unit tests for auth
+
+Files Recently Modified:
+- src/auth/login.ts (2 hours ago)
+- src/auth/validate.ts (2 hours ago)
+
+Suggested Next Action:
+→ Continue with "Complete email verification"
+
+Ready to proceed?
+```
+
+### pa:conflict-check
+
+**Check if files you're about to modify were changed by another AI.**
+
+AI runs before editing any file:
+
+```bash
+# Check recent changes to files
+cat .proagents/changelog/_recent.md | grep -A2 "Files:"
+cat .proagents/worklog/_context.md | grep -A5 "Recent Changes"
+```
+
+Output if conflict detected:
+```
+⚠️ CONFLICT WARNING
+═══════════════════
+File: src/auth/login.ts
+Last modified: 2 hours ago by Gemini (1.5-pro)
+Changes: Added email validation
+
+Options:
+1. Review changes first (recommended)
+2. Proceed with caution
+3. Coordinate with previous AI's work
+
+Your action?
+```
+
+### Validation Reminder
+
+**AI checks if previous session logged changes properly.**
+
+On `pa:sync`, AI also checks:
+
+```bash
+# Compare git changes vs changelog entries
+git diff --name-only HEAD~3 > /tmp/git_changes.txt
+grep -o "src/[^ ]*" .proagents/changelog/_recent.md > /tmp/logged_changes.txt
+
+# If git has changes not in changelog:
+echo "⚠️ Warning: Some changes may not be logged"
+```
+
+Output if missing logs:
+```
+⚠️ LOGGING VALIDATION
+═════════════════════
+Git shows 5 files changed since last session.
+Changelog shows 2 files logged.
+
+Missing from changelog:
+- src/utils/helpers.ts
+- src/api/endpoints.ts
+- tests/auth.test.ts
+
+Previous AI may have forgotten to log. Consider adding entries.
+```
+
+---
+
+## Issue/Fix Linking
+
+**Link changes to issue numbers in changelogs.**
+
+Format for _recent.md:
+```markdown
+### YYYY-MM-DD - Bug Fix
+**Issue:** #123
+**Module:** auth
+**AI:** Claude (opus-4)
+**Files:** src/auth/login.ts (+5, -2)
+**Summary:** Fixed null check in email validation
+**Closes:** #123
+
+---
+```
+
+AI auto-detects issue numbers from:
+- User message: "fix issue #123" or "closes #456"
+- Branch name: `fix/123-login-bug`
+- Commit message: `Fixes #123`
+
+---
+
+## File-Level Lock Tracking
+
+**Track which files each AI is actively editing.**
+
+When AI starts editing a file:
+
+```bash
+# Add to .proagents/.active-files
+echo "src/auth/login.ts|Claude|opus-4|$(date -Iseconds)" >> .proagents/.active-files
+```
+
+Before editing any file, AI checks:
+```bash
+grep "src/auth/login.ts" .proagents/.active-files
+```
+
+If file is locked by another AI:
+```
+⚠️ FILE IN USE
+══════════════
+File: src/auth/login.ts
+Locked by: Gemini (1.5-pro)
+Since: 10 minutes ago
+
+Options:
+1. Wait and retry
+2. Edit different file
+3. Force proceed (may cause conflicts)
+```
+
+On session end, AI clears its file locks:
+```bash
+grep -v "|Claude|" .proagents/.active-files > /tmp/active && mv /tmp/active .proagents/.active-files
+```
+
+---
+
+## Git Commit Integration
+
+**Auto-populate changelog from git commits.**
+
+### pa:changelog --from-git
+
+AI parses recent commits and updates changelog:
+
+```bash
+# Get recent commits
+git log --oneline --since="24 hours ago" --format="%h|%s|%an"
+```
+
+For each commit, AI:
+1. Extracts files changed: `git show --name-only HASH`
+2. Detects module from file paths
+3. Extracts issue numbers from message
+4. Prepends to `_recent.md`
+
+Example auto-generated entry:
+```markdown
+### 2024-03-11 - Commit abc123
+**Module:** auth (auto-detected)
+**Author:** Developer
+**Files:** src/auth/login.ts, src/auth/validate.ts
+**Summary:** Add JWT token validation
+**Commit:** abc123
+**Issues:** #123, #124
+
+---
+```
 
 ---
 

package/.proagents/prompts/07-documentation.md

@@ -840,6 +840,110 @@ MAINTENANCE:
 
 ---
 
+## Enhanced Changelog System (Cross-AI Continuity)
+
+**AI must update multiple changelog files for cross-AI continuity.**
+
+### pa:changelog Workflow:
+
+```bash
+# 1. Update root CHANGELOG.md
+# 2. Update .proagents/changelog/_recent.md (prepend)
+# 3. Update feature changelog if applicable
+# 4. Update module changelog based on files changed
+```
+
+### Changelog Locations:
+
+| File | Purpose | Updated When |
+|------|---------|--------------|
+| `./CHANGELOG.md` | Public changelog | Major changes |
+| `.proagents/changelog/_recent.md` | Last 10 changes | Every change |
+| `.proagents/changelog/features/[name].md` | Feature history | Working on feature |
+| `.proagents/changelog/modules/[name].md` | Module history | Modifying module |
+
+### Feature Changelog Format:
+
+Create `.proagents/changelog/features/[feature-name].md`:
+
+```markdown
+# Feature: [Feature Name]
+
+Created: YYYY-MM-DD
+Status: active | completed | paused
+Branch: feature/[name]
+
+---
+
+## Changelog
+
+### YYYY-MM-DD - [AI Platform]
+**Phase:** implementation | testing | review
+**Changes:**
+- Change 1
+- Change 2
+**Files:**
+- src/path/file.ts (+50, -10)
+- src/path/other.ts (new)
+**Decisions:**
+- Decision and reason
+**Next:** What comes next
+
+---
+```
+
+### Module Changelog Format:
+
+Create `.proagents/changelog/modules/[module].md`:
+
+```markdown
+# Module: [Module Name]
+
+Path: src/[module]/
+Type: api | service | component | utility
+
+---
+
+## Changelog
+
+### YYYY-MM-DD - [AI Platform]
+**Context:** [Feature or Fix name]
+**Changes:**
+- Change description
+**Files:**
+- file.ts (+lines, -lines)
+
+---
+```
+
+### Module Auto-Detection:
+
+AI detects module from file path:
+- `src/api/*`, `routes/*` → `modules/api.md`
+- `src/auth/*` → `modules/auth.md`
+- `src/components/*` → `modules/ui.md`
+- `src/services/*` → `modules/services.md`
+- `src/utils/*`, `lib/*` → `modules/utils.md`
+- `tests/*` → `modules/tests.md`
+
+### _recent.md Format:
+
+Prepend to `.proagents/changelog/_recent.md`:
+
+```markdown
+### YYYY-MM-DD - [Change Type]
+**Feature/Module:** name
+**AI:** Platform (model)
+**Files:** file1.ts, file2.ts
+**Summary:** Brief description of change
+
+---
+```
+
+Keep only last 10 entries (remove oldest when adding new).
+
+---
+
 ## Commands Reference
 
 | Command | Description | Output Location |