/manage

description: "Manage track lifecycle: archive, restore, delete, rename, and cleanup"
argument-hint: "[--archive | --restore | --delete | --rename | --list | --cleanup]"

Track Manager

Manage the complete track lifecycle including archiving, restoring, deleting, renaming, and cleaning up orphaned artifacts.

Pre-flight Checks

1. Verify Conductor is initialized:

• Check `conductor/product.md` exists
• Check `conductor/tracks.md` exists
• Check `conductor/tracks/` directory exists
• If missing: Display error and suggest running `/conductor:setup` first

2. Ensure archive directory exists (for archive/restore operations):

• Check if `conductor/tracks/_archive/` exists
• Create if needed when performing archive operation

Mode Detection

Parse arguments to determine operation mode:

| Argument | Mode | Description | | ---------------------- | ------------ | ------------------------------------------------------- | | `--list [filter]` | List | Show all tracks (optional: active, completed, archived) | | `--archive <id>` | Archive | Move completed track to archive | | `--archive --bulk` | Bulk Archive | Multi-select completed tracks | | `--restore <id>` | Restore | Restore archived track to active | | `--delete <id>` | Delete | Permanently remove a track | | `--rename <old> <new>` | Rename | Change track ID | | `--cleanup` | Cleanup | Detect and fix orphaned artifacts | | (none) | Interactive | Menu-driven operation selection |

---

Interactive Mode (no argument)

When invoked without arguments, display the main menu:

1. Gather Quick Stats

Read `conductor/tracks.md` and scan directories:

• Count active tracks (status `[ ]` or `[~]`)
• Count completed tracks (status `[x]`, not archived)
• Count archived tracks (in `_archive/` directory)

2. Display Main Menu

================================================================================
                          TRACK MANAGER
================================================================================

What would you like to do?

1. List all tracks
2. Archive a completed track
3. Restore an archived track
4. Delete a track permanently
5. Rename a track
6. Cleanup orphaned artifacts
7. Exit

Quick stats:
- {N} active tracks
- {M} completed (ready to archive)
- {P} archived

Select option:

3. Handle Selection

• Option 1: Execute List Mode
• Option 2: Execute Archive Mode (without argument)
• Option 3: Execute Restore Mode (without argument)
• Option 4: Execute Delete Mode (without argument)
• Option 5: Execute Rename Mode (without argument)
• Option 6: Execute Cleanup Mode
• Option 7: Exit with "Track management cancelled."

---

List Mode (`--list`)

Display comprehensive track overview with optional filtering.

1. Data Collection

**For Active Tracks:**

• Read `conductor/tracks.md`
• For each track with status `[ ]` or `[~]`:
• Read `conductor/tracks/{trackId}/metadata.json` for type, dates
• Read `conductor/tracks/{trackId}/plan.md` for task counts
• Calculate progress percentage

**For Completed Tracks:**

• Find tracks with status `[x]` not in `_archive/`
• Read metadata for completion dates

**For Archived Tracks:**

• Scan `conductor/tracks/_archive/` directory
• Read each `metadata.json` for archive reason and date

2. Output Format

**Full list (no filter):**

================================================================================
                          TRACK MANAGER
================================================================================

ACTIVE TRACKS ({count})
| Status | Track ID           | Type    | Progress    | Updated    |
|--------|-------------------|---------|-------------|------------|
| [~]    | dashboard_20250112| feature | 7/15 (47%)  | 2025-01-15 |
| [ ]    | nav-fix_20250114  | bug     | 0/4 (0%)    | 2025-01-14 |

COMPLETED TRACKS ({count})
| Track ID           | Type    | Completed  | Duration |
|-------------------|---------|------------|----------|
| auth_20250110     | feature | 2025-01-12 | 2 days   |

ARCHIVED TRACKS ({count})
| Track ID              | Type    | Reason     | Archived   |
|-----------------------|---------|------------|------------|
| old-feature_20241201  | feature | Superseded | 2025-01-05 |

================================================================================
Commands: /conductor:manage --archive | --restore | --delete | --rename | --cleanup
================================================================================

**Filtered list (`--list active`, `--list completed`, `--list archived`):**

Show only the requested section with the same format.

3. Empty States

**No tracks at all:**

================================================================================
                          TRACK MANAGER
================================================================================

No tracks found.

To create your first track: /conductor:new-track

================================================================================

**No tracks in filter:**

================================================================================
                          TRACK MANAGER
================================================================================

No {filter} tracks found.

================================================================================

---

Archive Mode (`--archive`)

Move completed tracks to the archive directory.

With Argument (`--archive <track-id>`)

1. Validate Track

• Check track exists in `conductor/tracks/{track-id}/`
• If not found, display error with availa