Skip to content

feat: Add config migration script and documentation (Sprint 3) - #3

Merged
ldangelo merged 1 commit into
mainfrom
feature/ensemble-rename-sprint3
Dec 14, 2025
Merged

feat: Add config migration script and documentation (Sprint 3)#3
ldangelo merged 1 commit into
mainfrom
feature/ensemble-rename-sprint3

Conversation

@ldangelo

Copy link
Copy Markdown
Contributor

Summary

Sprint 3 deliverables for the ensemble rename project - user configuration migration support.

Changes

New: Config Migration Script (scripts/migrate-config.js)

  • Migrates legacy ai-mesh config directories to XDG-compliant ensemble structure
  • Supports --dry-run mode to preview changes
  • Supports --force to overwrite existing files
  • Migrates:
    • ~/.ai-mesh-task-progress/~/.config/ensemble/plugins/task-progress-pane/
    • ~/.ai-mesh-pane-viewer/~/.config/ensemble/plugins/pane-viewer/

Updated: README.md

  • Added "Configuration" section documenting:
    • XDG-compliant config directory locations
    • Directory structure for plugins, logs, cache, sessions
    • Migration instructions from ai-mesh

Test plan

  • Migration script dry-run tested successfully
  • Script correctly identifies legacy directories
  • Documentation is clear and accurate

Related

🤖 Generated with Claude Code

Sprint 3 deliverables:

- Add scripts/migrate-config.js for migrating legacy ai-mesh config
  - Supports --dry-run mode for preview
  - Supports --force to overwrite existing
  - Migrates ~/.ai-mesh-task-progress/ and ~/.ai-mesh-pane-viewer/
  - Creates XDG-compliant directory structure

- Update README.md with Configuration section
  - Document XDG-compliant config paths
  - Document directory structure
  - Document migration process

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@ldangelo
ldangelo merged commit c1521f3 into main Dec 14, 2025
0 of 4 checks passed
ldangelo added a commit that referenced this pull request Dec 15, 2025
- Updated ~85 tasks from [ ] to [x] reflecting actual completion
- Marked all PREP tasks complete (scripts exist, directory renamed)
- Marked all CODE tasks complete (packages renamed to v5.0.0)
- Marked GitHub tasks GH-1 through GH-3, GH-6 complete
- Marked migration tasks MIG-001 through MIG-003, MIG-005 complete
- Updated sprint checklists with completion status
- Changed document status from "In Progress" to "~95% Complete"

Remaining items (~10 tasks):
- DOC-001: Create MIGRATION.md guide
- MIG-004: Add migration script to package.json bin
- MIG-006/007: Test migration on Linux/WSL
- TEST-001: Fix 14 pre-existing test failures
- GH-4/005: Update repo description and topics
- TEST-003/005: Integration tests and GitHub install test

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
ldangelo added a commit that referenced this pull request Jun 18, 2026
…rint3

Merging Sprint 3 - config migration script and documentation
ldangelo added a commit that referenced this pull request Jun 18, 2026
- Updated ~85 tasks from [ ] to [x] reflecting actual completion
- Marked all PREP tasks complete (scripts exist, directory renamed)
- Marked all CODE tasks complete (packages renamed to v5.0.0)
- Marked GitHub tasks GH-1 through GH-3, GH-6 complete
- Marked migration tasks MIG-001 through MIG-003, MIG-005 complete
- Updated sprint checklists with completion status
- Changed document status from "In Progress" to "~95% Complete"

Remaining items (~10 tasks):
- DOC-001: Create MIGRATION.md guide
- MIG-004: Add migration script to package.json bin
- MIG-006/007: Test migration on Linux/WSL
- TEST-001: Fix 14 pre-existing test failures
- GH-4/005: Update repo description and topics
- TEST-003/005: Integration tests and GitHub install test

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant