--- name: rename-loop description: Rename a loop and update all references in YAMLs, tests, and docs. disable-model-invocation: true argument-hint: " [--dry-run] [--yes]" model: sonnet allowed-tools: - Bash(git:*, mv:*, test:*) - Read - Edit - Glob - Grep - AskUserQuestion arguments: - name: old_name description: Current loop name (bare identifier, no .yaml extension) required: true - name: new_name description: New loop name (bare identifier, no .yaml extension) required: true - name: flags description: "--dry-run to preview all changes without applying; --yes to skip confirmation prompt" required: false metadata: short-description: Rename a loop and update all references in YAMLs, tests, and docs. --- # Rename Loop Rename a loop YAML file and update every reference to it so the loop system remains fully functional after the rename. --- ## Step 1: Parse and Validate Arguments Extract `old_name`, `new_name`, and flags from the arguments: - Strip any `.yaml` extension from `old_name` or `new_name` if present; note that you stripped it. - Validate `new_name` is a valid kebab-case identifier (lowercase letters, numbers, hyphens, optional path prefix for sub-directory loops like `oracles/name`). - Set `DRY_RUN=true` if `--dry-run` is present in flags. - Set `YES=true` if `--yes` is present in flags. --- ## Step 2: Locate the Loop and Determine Scope Check for the loop file in this priority order: 1. **Project-level**: `.loops/.yaml` → scope = `project` 2. **Built-in**: `scripts/little_loops/loops/.yaml` → scope = `builtin` If neither file exists, abort: ``` Error: Loop '' not found. Checked: .loops/.yaml scripts/little_loops/loops/.yaml ``` --- ## Step 3: Guard — Check for Naming Conflict Check whether the destination file already exists in the same directory as the source. If `/.yaml` already exists, abort: ``` Error: A loop named '' already exists at . Remove or rename it first. ``` --- ## Step 4: Guard — Check If Loop Is Running Check for active PID files (any instance): ```bash ls .loops/.running/-*.pid 2>/dev/null | head -1 ``` If the output is non-empty (at least one PID file found), abort: ``` Error: Loop '' appears to be running (PID file found). Stop it first: ll-loop stop ``` --- ## Step 5: Collect All Changes Gather every change that needs to be made. Do not apply anything yet — just build the list. ### 5a. File rename - **Scope `project`**: plain `mv` (`.loops/` is git-ignored) ``` mv .loops/.yaml .loops/.yaml ``` - **Scope `builtin`**: `git mv` (file is git-tracked) ``` git mv scripts/little_loops/loops/.yaml scripts/little_loops/loops/.yaml ``` ### 5b. `name:` field inside the renamed YAML Read the YAML file and find the `name:` field at the top level. The value may be quoted or unquoted: ```yaml name: "old-name" # or: name: old-name ``` Record an Edit to replace the old name value with `new_name`. ### 5c. Sub-loop `loop:` references Search for `loop: ` (exact bare name, no extension) across all loop YAML files: - `scripts/little_loops/loops/**/*.yaml` (includes `oracles/`) - `.loops/*.yaml` Use Grep with pattern `loop:\s+` across those paths. For each match, record an Edit to replace `loop: ` with `loop: `. ### 5d. Tests (built-in scope only) Search `scripts/tests/` for all occurrences of the old name: ``` Grep pattern: "" across scripts/tests/**/*.py ``` For each match, record an Edit to replace every string occurrence of `""` with `""` and `".yaml"` with `".yaml"`. ### 5e. Documentation (built-in scope only) Search for all occurrences of the old name in non-historical docs: ``` Grep pattern: across docs/**/*.md, scripts/little_loops/loops/README.md ``` Record an Edit for each file that contains the old name, replacing all occurrences with `new_name`. --- ## Step 6: If `--dry-run`, Print the Change Plan and Stop Print a structured preview of every change collected in Step 5: ``` DRY RUN: rename-loop → [scope: builtin|project] FILE RENAME: → YAML NAME FIELD: : — name: "" → name: "" LOOP REFERENCES ( found): : — loop: → loop: ... TESTS ( occurrences): [builtin only] : — "" → "" ... DOCS ( occurrences): [builtin only] : — ...... → ...... ... Total: files affected, changes. No changes applied (--dry-run). ``` Stop after printing this output. --- ## Step 7: Confirm (Unless `--yes`) If `YES` is not set, use `AskUserQuestion`: ```yaml questions: - question: "Apply changes to rename '' → ''?" header: "Confirm rename" multiSelect: false options: - label: "Yes, apply all changes (Recommended)" description: "Rename the file and update all references" - label: "No, cancel" description: "Abort without making any changes" ``` If the user selects "No, cancel": report "Cancelled. No changes made." and stop. --- ## Step 8: Execute Changes Apply each change collected in Step 5 in this order: 1. **Rename the file** (Bash: `git mv` or `mv`) 2. **Edit `name:` field** in the renamed YAML (Edit tool) 3. **Edit each sub-loop reference** (Edit tool, one file at a time) 4. **Edit test files** (Edit tool, builtin only) 5. **Edit doc files** (Edit tool, builtin only) For each Edit, use `replace_all: true` when replacing the old name string to catch all occurrences in that file in a single call. --- ## Step 9: Report Results Print a summary of every file changed: ``` Renamed: → [scope: builtin|project] Changes applied: RENAMED → EDITED (name: field) EDITED — loop reference(s) updated EDITED — occurrence(s) [builtin only] EDITED — occurrence(s) [builtin only] Total: files modified. ``` If any `.loops/tmp/-*` files exist, note: ``` Note: Leftover temp files found (cosmetic, no functional impact): .loops/tmp/-* Remove manually if desired: rm .loops/tmp/-* ``` --- ## Usage Examples ```bash # Preview all changes without applying them /ll:rename-loop refine-to-ready-issue refine-to-ready --dry-run # Rename with confirmation prompt /ll:rename-loop refine-to-ready-issue refine-to-ready # Rename without confirmation (for automation) /ll:rename-loop refine-to-ready-issue refine-to-ready --yes # Rename a project-level loop /ll:rename-loop my-custom-loop my-renamed-loop ```