Icarus-Mod-Tools 2.2.1 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e65ad8b4c6c5bd0cd903b9f2d9b8d0e09fb1382a776c7177a3aae0e74c60cfaa
-  data.tar.gz: aa19523d4e5cd01aa6439e4cf83e020728a870c439c75552927940314979ddf6
+  metadata.gz: 4de5e1f299177ea6e8681ae6d92fd808086ed601aa0c61346b9dc5552925bb82
+  data.tar.gz: e76f59e4cf4774e737240e310015a5870b99338b7c16f85599d7881f836f090f
 SHA512:
-  metadata.gz: dbf4a04fcd7c8035f22c6833f2beac93ded7a24ea9c73668ac29bdbc6aa41b0798376621b0a2965671fe715712d9f88f91c9270aec90267fe53293137ed0052c
-  data.tar.gz: 95602d38541559babf423d486bd85a3a803e46eb131363391ec8d8904a326f1d84ebde775735c6783cc1ddf05b820e60696d3670541792ca611b4425c37224de
+  metadata.gz: d1e1f69dbf0a7ccb9558e9eac6b4ae802cd14cf78aeac3a18b54cb9c533008d98eaed562347cdf65712429173ddf614e018cf69d3366271753ba27c93c3fb80e
+  data.tar.gz: a95184b4d2be164e626390012630d86bdf94359e2e832396496f30dfd74911cee9d01dc03f605357e408ee912dd4dbf850cbaf8886206babd9cfbb08231facb8

data/.claude-context.md

@@ -0,0 +1,178 @@
+# Claude Code Session Context - 2026-01-11
+
+## Status: COMPLETE - PR Open for Review
+
+**Date:** 2026-01-11
+**Pull Request:** #13 - https://github.com/DonovanMods/icarus-mod-tools/pull/13
+**Branch:** feature/remove-mods-tools
+**Issues Resolved:** #12, #5
+
+---
+
+## What Was Implemented
+
+Added three new removal commands to the CLI:
+
+1. **`imt remove mod <MOD_ID>`** - Removes entries from the `mods` collection
+2. **`imt remove tool <TOOL_ID>`** - Removes entries from the `tools` collection
+3. **Enhanced `imt remove repos`** - Added cascade delete functionality (enabled by default via `--cascade` flag)
+
+### Cascade Delete Feature
+
+When removing a repository with `--cascade` (default: true):
+- Removes the repository from `meta/repos/list`
+- Finds and removes all associated modinfo URLs from `meta/modinfo/list`
+- Finds and removes all associated toolinfo URLs from `meta/toolinfo/list`
+- Fetches each modinfo/toolinfo JSON and removes associated mods/tools from collections
+- Gracefully handles fetch errors with warnings
+
+Users can disable cascade with `--no-cascade` to only remove the repository entry.
+
+---
+
+## Files Modified
+
+1. **lib/icarus/mod/cli/remove.rb** (+151 lines)
+   - Added `mod(mod_id)` method
+   - Added `tool(tool_id)` method
+   - Enhanced `repos(repo)` with cascade logic
+   - Added private methods: `remove_entity`, `cascade_delete_repo`, `delete_entities_from_url`
+   - Includes `Tools::Sync::Helpers` for `retrieve_from_url` functionality
+
+2. **spec/icarus/mod/cli/remove_spec.rb** (+192 lines)
+   - Comprehensive test coverage for all new commands
+   - Tests for cascade delete functionality
+   - Tests for `--dry-run` compatibility
+   - Tests for error handling when URL fetch fails
+
+3. **lib/icarus/mod/version.rb**
+   - Bumped from 2.3.0 → 2.4.0
+
+4. **CHANGELOG.md**
+   - Added v2.4.0 entry documenting all changes
+
+5. **README.md**
+   - Updated `imt remove` command documentation
+   - Added `--cascade` and `--dry-run` options
+
+6. **Gemfile.lock**
+   - Updated version reference
+
+---
+
+## Test Results
+
+✅ All 290 tests passing
+- 16 tests for remove command (including new mod/tool/cascade tests)
+- Full test suite verified
+
+---
+
+## Key Implementation Details
+
+### Finding Entities by ID
+Both `mod` and `tool` commands find entities by their Firestore document ID:
+```ruby
+entity = collection.find { |e| e.id == entity_id }
+```
+
+### Cascade Delete Logic
+1. Filters modinfo/toolinfo URLs by repository name
+2. Deletes each URL from meta collections
+3. Fetches the JSON from each URL to get entity names
+4. Finds and deletes matching entities from mods/tools collections by name+author
+5. Finally removes the repository
+
+### Error Handling
+- Warnings (not failures) when URLs can't be fetched during cascade
+- Proper exit codes for not found scenarios
+- Dry-run support for all operations
+
+---
+
+## PR Details
+
+**Title:** feat: add remove commands for mods and tools collections (#12)
+**URL:** https://github.com/DonovanMods/icarus-mod-tools/pull/13
+**Status:** Open, mergeable
+**Reviewer:** GitHub Copilot (auto-requested)
+**Changes:** +349 lines, -19 lines across 6 files
+
+**PR Body:**
+```markdown
+## Summary
+
+Resolves #12
+Resolves #5
+
+Adds direct removal commands for the `mods` and `tools` collections, along with cascade delete functionality for repository removal.
+
+## Changes
+
+- Add `imt remove mod <MOD_ID>` to delete entries from mods collection
+- Add `imt remove tool <TOOL_ID>` to delete entries from tools collection
+- Enhance `imt remove repos` with `--cascade` flag (enabled by default) to automatically remove associated modinfo, toolinfo, mods, and tools
+- Include comprehensive test coverage for all new functionality
+- Update documentation (README, CHANGELOG) for new commands
+- Bump version to 2.4.0
+
+## Test Plan
+
+- [x] All 290 tests passing
+- [x] Added comprehensive test coverage for new commands
+- [x] Tested cascade delete functionality
+- [x] Tested --dry-run flag compatibility
+- [x] Updated documentation
+```
+
+---
+
+## Git State
+
+**Current Branch:** main (reset to match origin/main after creating PR)
+**Main HEAD:** de2146d - "Add comprehensive test coverage and fix sync 404 errors (#9)"
+
+**Feature Branch:** feature/remove-mods-tools
+**Feature HEAD:** 5109a1a - "feat: add remove commands for mods and tools collections (#12)"
+**Pushed to:** origin/feature/remove-mods-tools
+
+---
+
+## Next Steps
+
+1. ✅ PR created and open for review
+2. ⏳ Wait for PR review/approval
+3. ⏳ Merge PR when approved
+4. ⏳ Issues #12 and #5 will auto-close on merge
+5. ⏳ Consider tagging v2.4.0 release after merge
+
+---
+
+## How to Resume
+
+When you move the repository and restart Claude Code:
+
+1. The PR is already created: https://github.com/DonovanMods/icarus-mod-tools/pull/13
+2. All code is committed to `feature/remove-mods-tools` branch
+3. The main branch is clean
+4. If you need to make changes to the PR, checkout the feature branch:
+   ```bash
+   git checkout feature/remove-mods-tools
+   # make changes
+   git add -A && git commit -m "update: ..."
+   git push
+   ```
+
+5. To merge the PR (when ready):
+   ```bash
+   gh pr merge 13 --squash  # or --merge or --rebase
+   ```
+
+---
+
+## Related Issues
+
+- **#12** - "Add remove commands for mods and tools collections" (main issue)
+- **#5** - "When a repo is deleted, the associated entry is not removed from the modinfo db" (cascade delete)
+
+Both issues are linked in the PR and will auto-close when merged.

data/CHANGELOG.md

@@ -4,6 +4,39 @@ All notable changes to this project will be documented in this file.
 
 ## History (reverse chronological order)
 
+### v2.5.0 - 2026-01-12
+
+- Add automatic conversion of GitHub URLs to `raw.githubusercontent.com` format during sync
+  - Converts both `/blob/` and `/raw/` URLs from `github.com` domain
+  - Applies to all file URLs in modinfo and toolinfo files
+  - Also applies to imageURL and readmeURL fields
+  - Warnings added to alert users to update source files
+  - Ensures compatibility with GitHub's current raw file hosting on `raw.githubusercontent.com`
+
+### v2.4.1 - 2026-01-12
+
+- Fix JSON parsing error messages during sync to show concise error instead of full stack trace
+- Include URL in JSON parsing error messages to identify which repository has invalid JSON
+
+### v2.4.0 - 2026-01-11
+
+- Add `imt remove mod` command to remove entries from `mods` collection
+- Add `imt remove tool` command to remove entries from `tools` collection
+- Add cascade delete to `imt remove repos` (enabled by default via `--cascade` flag)
+  - When removing a repository, also removes associated modinfo, toolinfo, mods, and tools entries
+- Improvements to cascade delete functionality:
+  - Fix URL matching to prevent false matches (e.g., "owner/repo" no longer matches "owner/repo-fork")
+  - Handle multiple entities with same name and author (deletes all matches)
+  - Improve error handling with specific exception types and comprehensive reporting
+  - Track and report both fetch failures and delete failures with detailed summaries
+  - Enhanced dry-run output showing all entities that would be deleted
+  - Add Firestore cache invalidation for mod/tool deletions
+
+### v2.3.0 - 2025-12-18
+
+- Add comprehensive test coverage
+- Fix sync 404 errors
+
 ### v2.1 - 2023-02-11
 
 - Remove support for `fileType` and `fileURL` in `modinfo.json` files

data/CLAUDE.md

@@ -0,0 +1,152 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Icarus Mod Tools (`imt`) is a Ruby CLI gem that manages a bidirectional sync between GitHub repositories and Google Firestore for the Icarus game mods database. The tool discovers `modinfo.json` and `toolinfo.json` files across repositories and maintains a centralized Firestore database.
+
+## Development Commands
+
+### Setup & Installation
+
+```bash
+bin/setup                    # Install dependencies
+bundle install               # Install gems
+bundle exec rake install     # Install gem locally
+```
+
+### Testing
+
+```bash
+bundle exec rake             # Run tests (default task)
+bundle exec rspec            # Run tests only (with Fuubar formatter)
+bundle exec rspec spec/path/to/file_spec.rb  # Run single test file
+bundle exec rspec spec/path/to/file_spec.rb:42  # Run single test at line 42
+guard                        # Auto-run tests on file changes
+```
+
+### Console & Debugging
+
+```bash
+bin/console                  # Interactive IRB console with project loaded
+```
+
+### Running the CLI
+
+```bash
+bundle exec exe/imt [command]  # Run CLI during development
+imt [command]                  # Run installed gem
+```
+
+## Architecture
+
+### Data Flow Pipeline
+
+The tool implements a two-stage sync pipeline:
+
+1. **GitHub → Meta Collections**: Scan repositories for metadata files and sync to `meta/modinfo`, `meta/toolinfo`, `meta/repos`
+2. **Meta → Entity Collections**: Process meta lists to populate/update `mods` and `tools` collections
+
+All operations support `--dry-run` for safe testing.
+
+### Core Components
+
+**CLI Layer** (`lib/icarus/mod/cli/`)
+
+- `Command`: Main entry point, defines subcommands (sync, list, add, remove, validate)
+- `Base`: Inherited by all commands, provides `--config` and `--version` options
+- `SubcommandBase`: Base for subcommands, adds `--verbose` option
+- Subcommands: `Sync`, `List`, `Add`, `Remove`, `Validate` (all Thor-based)
+
+**Data Models** (`lib/icarus/mod/tools/`)
+
+- `Baseinfo`: Shared validation/transformation logic for mod and tool data
+- `Modinfo`: Validates and processes mod metadata
+- `Toolinfo`: Validates and processes tool metadata
+- `Validator`: Standalone validation utilities
+
+**Sync Operations** (`lib/icarus/mod/tools/sync/`)
+
+- `ModinfoList`: GitHub → meta/modinfo sync
+- `ToolinfoList`: GitHub → meta/toolinfo sync
+- `Mods`: meta/modinfo → mods sync
+- `Tools`: meta/toolinfo → tools sync
+- `Helpers`: HTTP utilities with custom SSL verification for Ruby 3.4+ CRL issues
+
+**External Services** (`lib/icarus/mod/`)
+
+- `Firestore`: Google Cloud Firestore client with collection management
+- `Github`: Octokit wrapper with recursive file discovery
+- `Config`: JSON config reader for `.imtconfig.json`
+
+### Global State
+
+The CLI uses a global `$firestore` variable in sync commands to share the Firestore instance across operations. This is set in `CLI::Sync` and used by sync modules.
+
+### Configuration
+
+The tool reads from `~/.imtconfig.json` (configurable via `--config`):
+
+- Firebase credentials (full JSON object, not path)
+- GitHub OAuth token
+- Collection paths (configurable)
+
+See README.md for configuration structure.
+
+## Development Patterns
+
+### CLI Command Structure
+
+All commands inherit from `CLI::Base` or `CLI::SubcommandBase`:
+
+```ruby
+class MyCommand < CLI::SubcommandBase
+  desc "mycommand ARGS", "Description"
+  method_option :my_option, aliases: "-m", type: :string, desc: "Option description"
+  def mycommand(args)
+    # Config is already loaded by CLI::Command#initialize
+    # Access via Icarus::Mod::Config.config
+  end
+end
+```
+
+### Error Handling
+
+Domain errors use `Icarus::Mod::Tools::Error`. Validation errors/warnings are stored in `@errors` and `@warnings` arrays on data model instances.
+
+```ruby
+rescue Icarus::Mod::Tools::Error => e
+  warn "Error: #{e.message}"
+  exit 1
+end
+```
+
+### Validation Rules
+
+All mod/tool data inherits from `Baseinfo`:
+
+- Required fields: `name`, `author`, `description`
+- URL validation for `imageURL`, `readmeURL`, file URLs
+- File types must match `/\.(zip|pak|exmodz?)/i`
+- Version strings should match `/^\d+[.\d+]*/`
+
+### SSL Certificate Handling
+
+Ruby 3.4+ with newer OpenSSL may fail CRL checking. The codebase handles this in `Sync::Helpers#retrieve_from_url` with a custom `verify_callback` that allows `V_ERR_UNABLE_TO_GET_CRL` errors.
+
+### Testing Patterns
+
+- Fixtures in `spec/fixtures/`
+- Tests run in random order (`config.order = :random`)
+- Use `:focus` metadata to run specific tests
+- Fuubar formatter provides progress bar display
+
+## Key Gotchas
+
+- **Firestore credentials**: Must be the full JSON object in config, not a file path
+- **GitHub repo format**: `owner/repo` format (URL prefixes are stripped automatically)
+- **Ruby version**: 3.1+ required for pattern matching and modern features
+- **Platform**: WSL2/Linux recommended; not tested on Windows
+- **Require paths**: The gemspec sets `require_paths` to both `lib` and `lib/icarus/mod`, so files use relative requires like `require "cli/base"` instead of `require_relative`
+- **Verbosity**: `-v` and `-vv` flags control output detail in subcommands

data/Gemfile

@@ -15,5 +15,4 @@ group :develop do
   gem "rspec", "~> 3.12"
   gem "rubocop", "~> 1.41"
   gem "rubocop-rspec", "~> 2.16", require: false
-  gem "standard", ">= 1.35.1"
 end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    Icarus-Mod-Tools (2.2.1)
+    Icarus-Mod-Tools (2.5.0)
       google-cloud-firestore (~> 2.7)
       octokit (~> 6.0)
       paint (~> 2.3)
@@ -10,13 +10,13 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.7)
-      public_suffix (>= 2.0.2, < 7.0)
+    addressable (2.8.8)
+      public_suffix (>= 2.0.2, < 8.0)
     ast (2.4.3)
     base64 (0.3.0)
     bigdecimal (3.3.1)
     coderay (1.1.3)
-    concurrent-ruby (1.3.5)
+    concurrent-ruby (1.3.6)
     diff-lcs (1.6.2)
     faraday (2.14.0)
       faraday-net_http (>= 2.0, < 3.5)
@@ -24,20 +24,20 @@ GEM
       logger
     faraday-net_http (3.4.2)
       net-http (~> 0.5)
-    faraday-retry (2.3.2)
+    faraday-retry (2.4.0)
       faraday (~> 2.0)
-    ffi (1.17.2)
-    ffi (1.17.2-aarch64-linux-gnu)
-    ffi (1.17.2-aarch64-linux-musl)
-    ffi (1.17.2-arm-linux-gnu)
-    ffi (1.17.2-arm-linux-musl)
-    ffi (1.17.2-arm64-darwin)
-    ffi (1.17.2-x86-linux-gnu)
-    ffi (1.17.2-x86-linux-musl)
-    ffi (1.17.2-x86_64-darwin)
-    ffi (1.17.2-x86_64-linux-gnu)
-    ffi (1.17.2-x86_64-linux-musl)
-    formatador (1.2.2)
+    ffi (1.17.3)
+    ffi (1.17.3-aarch64-linux-gnu)
+    ffi (1.17.3-aarch64-linux-musl)
+    ffi (1.17.3-arm-linux-gnu)
+    ffi (1.17.3-arm-linux-musl)
+    ffi (1.17.3-arm64-darwin)
+    ffi (1.17.3-x86-linux-gnu)
+    ffi (1.17.3-x86-linux-musl)
+    ffi (1.17.3-x86_64-darwin)
+    ffi (1.17.3-x86_64-linux-gnu)
+    ffi (1.17.3-x86_64-linux-musl)
+    formatador (1.2.3)
       reline
     fuubar (2.5.1)
       rspec-core (~> 3.0)
@@ -73,31 +73,31 @@ GEM
       gapic-common (~> 1.2)
       google-cloud-errors (~> 1.0)
     google-logging-utils (0.2.0)
-    google-protobuf (4.33.0)
+    google-protobuf (4.33.2)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.33.0-aarch64-linux-gnu)
+    google-protobuf (4.33.2-aarch64-linux-gnu)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.33.0-aarch64-linux-musl)
+    google-protobuf (4.33.2-aarch64-linux-musl)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.33.0-arm64-darwin)
+    google-protobuf (4.33.2-arm64-darwin)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.33.0-x86-linux-gnu)
+    google-protobuf (4.33.2-x86-linux-gnu)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.33.0-x86-linux-musl)
+    google-protobuf (4.33.2-x86-linux-musl)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.33.0-x86_64-darwin)
+    google-protobuf (4.33.2-x86_64-darwin)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.33.0-x86_64-linux-gnu)
+    google-protobuf (4.33.2-x86_64-linux-gnu)
       bigdecimal
       rake (>= 13)
-    google-protobuf (4.33.0-x86_64-linux-musl)
+    google-protobuf (4.33.2-x86_64-linux-musl)
       bigdecimal
       rake (>= 13)
     googleapis-common-protos (1.9.0)
@@ -106,7 +106,7 @@ GEM
       grpc (~> 1.41)
     googleapis-common-protos-types (1.22.0)
       google-protobuf (~> 4.26)
-    googleauth (1.15.1)
+    googleauth (1.16.0)
       faraday (>= 1.0, < 3.a)
       google-cloud-env (~> 2.2)
       google-logging-utils (~> 0.1)
@@ -157,8 +157,8 @@ GEM
       guard (~> 2.1)
       guard-compat (~> 1.1)
       rspec (>= 2.99.0, < 4.0)
-    io-console (0.8.1)
-    json (2.16.0)
+    io-console (0.8.2)
+    json (2.18.0)
     jwt (3.1.2)
       base64
     language_server-protocol (3.17.0.5)
@@ -169,10 +169,10 @@ GEM
     logger (1.7.0)
     lumberjack (1.4.2)
     method_source (1.1.0)
-    multi_json (1.17.0)
+    multi_json (1.19.1)
     nenv (0.3.0)
-    net-http (0.7.0)
-      uri
+    net-http (0.9.1)
+      uri (>= 0.11.1)
     notiffany (0.1.3)
       nenv (~> 0.1)
       shellany (~> 0.0)
@@ -186,11 +186,11 @@ GEM
     parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
-    prism (1.6.0)
+    prism (1.7.0)
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    public_suffix (6.0.2)
+    public_suffix (7.0.2)
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.3.1)
@@ -199,7 +199,7 @@ GEM
       ffi (~> 1.0)
     rbtree (0.4.6)
     regexp_parser (2.11.3)
-    reline (0.6.2)
+    reline (0.6.3)
       io-console (~> 0.5)
     rspec (3.13.2)
       rspec-core (~> 3.13.0)
@@ -214,7 +214,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.6)
-    rubocop (1.80.2)
+    rubocop (1.82.1)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -222,22 +222,18 @@ GEM
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
-      rubocop-ast (>= 1.46.0, < 2.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 4.0)
-    rubocop-ast (1.48.0)
+    rubocop-ast (1.49.0)
       parser (>= 3.3.7.2)
-      prism (~> 1.4)
+      prism (~> 1.7)
     rubocop-capybara (2.22.1)
       lint_roller (~> 1.1)
       rubocop (~> 1.72, >= 1.72.1)
-    rubocop-factory_bot (2.27.1)
+    rubocop-factory_bot (2.28.0)
       lint_roller (~> 1.1)
       rubocop (~> 1.72, >= 1.72.1)
-    rubocop-performance (1.25.0)
-      lint_roller (~> 1.1)
-      rubocop (>= 1.75.0, < 2.0)
-      rubocop-ast (>= 1.38.0, < 2.0)
     rubocop-rspec (2.31.0)
       rubocop (~> 1.40)
       rubocop-capybara (~> 2.17)
@@ -255,22 +251,10 @@ GEM
       faraday (>= 0.17.5, < 3.a)
       jwt (>= 1.5, < 4.0)
       multi_json (~> 1.10)
-    standard (1.51.1)
-      language_server-protocol (~> 3.17.0.2)
-      lint_roller (~> 1.0)
-      rubocop (~> 1.80.2)
-      standard-custom (~> 1.0.0)
-      standard-performance (~> 1.8)
-    standard-custom (1.0.2)
-      lint_roller (~> 1.0)
-      rubocop (~> 1.50)
-    standard-performance (1.8.0)
-      lint_roller (~> 1.1)
-      rubocop-performance (~> 1.25.0)
     thor (1.4.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
-    unicode-emoji (4.1.0)
+    unicode-emoji (4.2.0)
     uri (1.1.1)
 
 PLATFORMS
@@ -283,6 +267,7 @@ PLATFORMS
   x86-linux-gnu
   x86-linux-musl
   x86_64-darwin
+  x86_64-linux
   x86_64-linux-gnu
   x86_64-linux-musl
 
@@ -296,7 +281,6 @@ DEPENDENCIES
   rspec (~> 3.12)
   rubocop (~> 1.41)
   rubocop-rspec (~> 2.16)
-  standard (>= 1.35.1)
 
 BUNDLED WITH
    2.6.9

data/README.md

@@ -58,6 +58,7 @@ Commands:
   imt add             # Adds entries to the databases
   imt help [COMMAND]  # Describe available commands or one specific command
   imt list            # Lists the databases
+  imt remove          # Removes entries from the databases
   imt sync            # Syncs the databases
   imt validate        # Validates various entries
 
@@ -104,6 +105,28 @@ Options:
                                    # Default: [true]
 ```
 
+#### `imt remove`
+
+```sh
+Commands:
+  imt remove help [COMMAND]  # Describe subcommands or one specific subcommand
+  imt remove mod MOD_ID      # Removes a mod from the 'mods' collection
+  imt remove modinfo ITEM    # Removes an entry from 'meta/modinfo/list'
+  imt remove repos REPO      # Removes an entry from 'meta/repos/list' and cascades to associated mods/tools
+  imt remove tool TOOL_ID    # Removes a tool from the 'tools' collection
+  imt remove toolinfo ITEM   # Removes an entry from 'meta/toolinfo/list'
+
+Options:
+  -C, [--config=CONFIG]            # Path to the config file
+                                   # Default: /Users/dyoung/.imtconfig.json
+  -V, [--version], [--no-version]  # Print the version and exit
+  -v, [--verbose], [--no-verbose]  # Increase verbosity. May be repeated for even more verbosity.
+                                   # Default: [true]
+      [--dry-run], [--no-dry-run]  # Dry run (no changes will be made)
+      [--cascade], [--no-cascade]  # Also remove associated modinfo, toolinfo, mods, and tools entries (for repos only)
+                                   # Default: true
+```
+
 #### `imt sync`
 
 ```sh
@@ -124,6 +147,8 @@ Options:
       [--dry-run], [--no-dry-run]  # Dry run (no changes will be made)
 ```
 
+**Note**: Sync operations automatically convert GitHub URLs to the correct `raw.githubusercontent.com` format for direct downloads. If you're using GitHub URLs in `modinfo.json` or `toolinfo.json` files, you can use either `/blob/` or `/raw/` formats and they will be automatically converted. Warnings will be displayed when URLs are auto-fixed so you can update your source files.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -132,4 +157,4 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/DonovanMods/icarus-mod-tools.
+Bug reports and pull requests are welcome on GitHub at <https://github.com/DonovanMods/icarus-mod-tools>.

data/Rakefile

@@ -3,10 +3,9 @@
 require "bundler/gem_tasks"
 require "rake/testtask"
 require "rspec/core/rake_task"
-require "standard/rake"
 
 RSpec::Core::RakeTask.new(:spec) do |task|
   task.rspec_opts = ["--color", "--format", "Fuubar"]
 end
 
-task default: %i[spec standard]
+task default: %i[spec]