44 lines
1.4 KiB
Markdown
44 lines
1.4 KiB
Markdown
# renamer Development Guidelines
|
|
|
|
Auto-generated from all feature plans. Last updated: 2025-10-29
|
|
|
|
## Active Technologies
|
|
- Local filesystem (no persistent database) (002-add-replace-command)
|
|
- Go 1.24 + `spf13/cobra`, `spf13/pflag` (001-list-command-filters)
|
|
|
|
## Project Structure
|
|
|
|
```text
|
|
cmd/
|
|
internal/
|
|
scripts/
|
|
tests/
|
|
```
|
|
|
|
## Commands
|
|
|
|
- `renamer list` — preview rename scope with shared flags before executing changes.
|
|
- `renamer replace` — consolidate multiple literal patterns into a single replacement (supports `--dry-run` + `--yes`).
|
|
- `renamer undo` — revert the most recent rename/replace batch using ledger entries.
|
|
- Persistent scope flags: `--path`, `-r/--recursive`, `-d/--include-dirs`, `--hidden`, `--extensions`, `--yes`, `--dry-run`.
|
|
|
|
## Code Style
|
|
|
|
- Go 1.24: follow gofmt (already checked in CI)
|
|
- Prefer composable packages under `internal/` for reusable logic
|
|
- Keep CLI wiring thin; place business logic in services
|
|
|
|
## Testing
|
|
|
|
- `go test ./...`
|
|
- Contract tests: `tests/contract/replace_command_test.go`
|
|
- Integration tests: `tests/integration/replace_flow_test.go`
|
|
- Smoke: `scripts/smoke-test-replace.sh`
|
|
|
|
## Recent Changes
|
|
- 002-add-replace-command: Added `renamer replace` command, ledger metadata, and automation docs.
|
|
- 001-list-command-filters: Added `renamer list` command with shared scope flags and formatters.
|
|
|
|
<!-- MANUAL ADDITIONS START -->
|
|
<!-- MANUAL ADDITIONS END -->
|