File Tree Reorganization¶

| Current item | Proposed destination | Action | Migration note | |----|----|----|----| | PlexHD system tree | Unchanged macOS-managed locations | Keep | Do not reorganize `/System` or `/Library`. | | PlexHD/Users/toddmcguckin | PlexHD/Users/todd | Stage | Perform as a separately documented macOS account short-name migration; verify ownership, login, application settings, and rollback before retiring the old home path. | | PlexDB/Backups | Backups/Legacy/2026-pre-standard/PlexDB-Backups | Copy | Preserve first, then classify exports and recovery assets into the new Backups tree. | | PlexDB/Exports | Backups/Application-Exports/\ | Classify | File by originating application. The export format is application-native and does not change when that application moves into Docker. | | PlexDB/Logs | PlexDB/Logs/\ | Classify | Make this the universal retained file-log search root; assign every retained log to its owning application and apply rotation. | | PlexDB/Plex Media Server | PlexDB/Plex | Rename | Stop Plex, preserve and verify the complete directory, rename only the top-level folder, redirect Plex to `/Volumes/PlexDB/Plex`, and test before retiring the old path reference. | | PlexDB/Plex Media Server.rar | Backups/Legacy/2026-pre-standard/archives | Hold | Preserve as a legacy archive until its contents and recovery value are verified. | | PlexDB/Scripts | PlexDB/Docker/scripts or Backups/Platform-Recovery/scripts | Classify | Working operational scripts live on PlexDB; protected recovery copies live on Backups. | | PlexDB/Tautulli | PlexDB/Docker/appdata/tautulli | Copy | Use the container migration procedure and retain the native source through rollback acceptance. | | Docker Desktop VM disk — current location to be recorded from Settings › Resources › Advanced | PlexDB/Docker/docker-desktop/vm-data | Stage | Record the displayed source path, maximum size, actual allocated size, engine version, projects, images, and volumes. Create and verify platform recovery artifacts; stop containers; then use Docker Desktop’s Disk image location Browse/Apply control. Never move `Docker.raw` in Finder. Verify the new displayed location, engine startup, projects, containers, networks, volumes, and application health. Roll back through the same Docker Desktop control or, with Docker Desktop fully stopped, restore the pre-change VM-disk copy to its recorded original location. No source or recovery copy is deleted without separate approval. | | PlexDB/TestShare | Backups/Legacy/2026-pre-standard/quarantine/TestShare | Hold | Quarantine for review. Delete only after contents are proven unnecessary and deletion is separately approved. | | Backups/Scripts | Backups/Legacy/2026-pre-standard/Backups-Scripts | Classify | Determine whether each file is an operational source, a recovery copy, or obsolete. | | Storage/Downloads | Storage/Downloads/{incomplete,complete,watch}/{bittorrent,usenet} | Stage | Map current client folders into protocol and lifecycle stages without crossing volumes. | | Storage/Libraries | Storage/Libraries/{Movies,Music,Reading,Software,Television} | Normalize | Preserve these approved library names unless a separate media-library review approves renaming. | | Storage/Unsorted | Storage/Unsorted/{incoming,review,quarantine} | Stage | Separate newly found content from reviewed and quarantined material. | | TARDIS snapshots | Time Machine-managed layout | Keep | No manual restructuring. | Current items, approved target locations, migration actions, and item-specific controls {.plan}

| Action | Prerequisite and execution | Verification and acceptance | Rollback and deletion boundary | |----|----|----|----| | Keep | Inventory and baseline the existing path; make no structural change. | Confirm mount, owner, permissions, application access, and expected contents. | Rollback is not applicable because no cutover occurs. Nothing is deleted. | | Stage | Create the approved target structure and recovery evidence without redirecting the application. Quiesce first if data is copied. | Verify target ownership, permissions, ACLs, extended attributes, symbolic links, file counts, checksums, and free space. | Original source remains authoritative until a later approved cutover. Staged data may be removed only through a separately approved cleanup record. | | Copy | Quiesce the owner, take a readable recovery copy, then copy—never move—the source to the approved target. | Verify counts, checksums, metadata, application startup, functional tests, and the defined observation period. | Restore the unchanged original path and configuration. Delete neither source until acceptance and separate cleanup approval. | | Classify | Inventory each item’s owner, purpose, sensitivity, dependency, and recovery value before assigning a final target. | Review and approve a manifest mapping every classified item to a destination or explicit hold. | Source remains unchanged. Unclassified or disputed content is held; no deletion is permitted. | | Rename | Quiesce the owner, create and verify a recovery copy, record all path consumers, and change only the approved path component. | Verify metadata, every path reference, application startup, functional tests, and observation period. | Restore the original name and references from the recorded manifest. The recovery copy remains until separate cleanup approval. | | Hold | Copy the item into the named read-only Legacy or quarantine location with provenance and hash evidence. | Verify the held copy is complete, readable, attributable, and included in the inventory. | Original remains available until the hold is accepted. Release or deletion requires a separately approved disposition. | | Normalize | Preserve approved names, create only missing standard subdirectories, and inventory every path consumer before reclassification. | Verify library visibility, application references, permissions, counts, and checksums for any copied content. | Retain the prior structure or manifest as the rollback source. Cleanup is a later, separately approved action. | Normative meaning of every migration action used above {.plan}