| 1 | # Migrate Agents DOX |
| 2 | |
| 3 | ## Purpose |
| 4 | |
| 5 | - Own the bundled workflow for previewing and importing retained work from OpenClaw, Hermes Agent, OpenCode, Claude Code, and Codex. |
| 6 | |
| 7 | ## Ownership |
| 8 | |
| 9 | - `helpers/migration.py` owns source parsing, redaction, limits, preview data, and native chat conversion. |
| 10 | - `api/migration_preview.py` owns read-only upload inspection; `api/migration_import.py` owns confirmed writes. |
| 11 | - `webui/` owns source selection, upload, review, consent, and progress UI. |
| 12 | - `tests/` owns parser, privacy, archive-safety, native-chat, project, and import-helper regression coverage. |
| 13 | |
| 14 | ## Local Contracts |
| 15 | |
| 16 | - The bundled folder, manifest name, Python imports, and HTTP routes use `_migrate_agents`. |
| 17 | - Preview must not write Agent Zero state. Import starts only after explicit category selection and review consent. |
| 18 | - Credentials, authentication state, hidden reasoning, schedules, live services, and replayable tool execution stay excluded. |
| 19 | - Imported knowledge and skills remain namespaced below `usr/knowledge/_migrate_agents/` and `usr/skills/_migrate_agents/`. |
| 20 | - Preserve source provenance and do not claim transcript metadata can reconstruct unavailable project files. |
| 21 | |
| 22 | ## Work Guidance |
| 23 | |
| 24 | - Extend the shared parser and redaction path instead of adding source-specific import side channels. |
| 25 | - Keep source commands, supported artifacts, exclusions, and mapping limits accurate in both WebUI copy and README. |
| 26 | - Keep bundled harness assets local and update `webui/assets/ATTRIBUTION.md` when their provenance changes. |
| 27 | |
| 28 | ## Verification |
| 29 | |
| 30 | - Run `conda run -n a0 python -m pytest plugins/_migrate_agents/tests -q`. |
| 31 | - For WebUI changes, verify the mounted modal and upload flow against the named live Agent Zero runtime. |
| 32 | |
| 33 | ## Child DOX Index |
| 34 | |
| 35 | No child DOX files. |