From 94e33c07637be170a0a9a8e672d856d8ddd06d34 Mon Sep 17 00:00:00 2001 From: rob Date: Fri, 30 Jan 2026 03:50:28 -0400 Subject: [PATCH] Update docs for tool ratings, reviews, and issue reporting Co-Authored-By: Claude Opus 4.5 --- CHANGELOG.md | 19 +++++++++++++++++++ README.md | 2 ++ 2 files changed, 21 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 614a624..37dc15c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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 - 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///my-review` returns the authenticated user's review + #### GUI Improvements - Version display and bump buttons in publish dialog - Auto-fetch registry version when opening publish dialog diff --git a/README.md b/README.md index 100a0ed..4845e70 100644 --- a/README.md +++ b/README.md @@ -724,6 +724,8 @@ The graphical interface provides a modern desktop experience: - Double-click a tool to edit it - Create new tools with the built-in Tool Builder - 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 - **Local Collections**: Create and manage your own tool bundles