Update docs for tool ratings, reviews, and issue reporting

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
rob 2026-01-30 03:50:28 -04:00
parent 23631ff4e7
commit 94e33c0763
2 changed files with 21 additions and 0 deletions

View File

@ -181,6 +181,25 @@ All notable changes to CmdForge will be documented in this file.
- Admin dashboard UI with "Dry Run" and "Run Cleanup" buttons - Admin dashboard UI with "Dry Run" and "Run Cleanup" buttons
- Shows count of rejected versions pending cleanup - Shows count of rejected versions pending cleanup
#### Tool Ratings, Reviews & Issue Reporting
- **Rate and review tools from My Tools page**: Registry-installed tools show a rating bar at the bottom of the tool details panel
- Star rating display with average score and review count
- "Rate Tool" button opens a review dialog with 5-star selector, title, and content fields
- Edit or delete your existing review
- Button hidden for your own published tools (server enforces restriction)
- **Report issues on registry tools**: "Report Issue" button next to Rate Tool
- Issue type selector: Bug, Compatibility Issue, Security Issue
- Severity selector: Low, Medium, High, Critical
- Title (required) and description (optional) fields with character limits
- **Registry owner tracking**: New `registry_owner` field in tool config
- Saved at publish time (GUI, CLI, and collection publish paths)
- Backfilled by background status sync for existing tools
- Enables correct owner resolution for flat-directory tools (e.g., official tools)
- **Registry field preservation**: `save_tool()` now preserves `registry_hash`, `registry_status`, `registry_owner`, and `registry_feedback` fields when editing tools
- **Background slug fetch**: User slug fetched in background thread to prevent UI freeze
- **New RegistryClient methods**: `get_tool_rating()`, `get_my_review()`, `submit_review()`, `update_review()`, `delete_review()`, `submit_issue()`
- **New server endpoint**: `GET /api/v1/tools/<owner>/<name>/my-review` returns the authenticated user's review
#### GUI Improvements #### GUI Improvements
- Version display and bump buttons in publish dialog - Version display and bump buttons in publish dialog
- Auto-fetch registry version when opening publish dialog - Auto-fetch registry version when opening publish dialog

View File

@ -724,6 +724,8 @@ The graphical interface provides a modern desktop experience:
- Double-click a tool to edit it - Double-click a tool to edit it
- Create new tools with the built-in Tool Builder - Create new tools with the built-in Tool Builder
- Connect to the registry to publish your tools - Connect to the registry to publish your tools
- **Rate & review** registry-installed tools with a 5-star rating system
- **Report issues** on registry tools (bug, compatibility, security)
### Collections Page ### Collections Page
- **Local Collections**: Create and manage your own tool bundles - **Local Collections**: Create and manage your own tool bundles