Skip to content

feat: Agent Marketplace Review & Rating System#83

Merged
memplethee-lab merged 1 commit into
SourceXXL:mainfrom
kike-alt:feat/issue-74-agent-marketplace-review-rating
Jun 24, 2026
Merged

feat: Agent Marketplace Review & Rating System#83
memplethee-lab merged 1 commit into
SourceXXL:mainfrom
kike-alt:feat/issue-74-agent-marketplace-review-rating

Conversation

@kike-alt

Copy link
Copy Markdown
Contributor

Summary

Implements a full review and rating system for the agent discovery marketplace.

Implementation Details

New files

  • src/discovery/reviews/entities/agent-review.entity.ts — TypeORM entity with 5-star rating, review text, developer response, spam score, moderation status
  • src/discovery/reviews/dto/review.dto.ts — Validated DTOs for create, developer response, moderation, and query
  • src/discovery/reviews/agent-reviews.service.ts — Core business logic
  • src/discovery/reviews/agent-reviews.controller.ts — REST API endpoints
  • src/discovery/reviews/agent-reviews.module.ts — NestJS module
  • src/discovery/reviews/agent-reviews.service.spec.ts — 10 unit tests

Features implemented

  • 5-star rating — validated 1–5 integer per review
  • One review per user per agent — enforced at DB (unique index) + service level
  • Verified-user gatehasUsedAgent flag prevents non-users from reviewing
  • Spam detection — keyword/pattern scoring; reviews scoring ≥ 0.5 are auto-FLAGGED
  • Review aggregation — average rating + distribution; exposes getUserRatingForScoring() feeding the existing AgentScoring userRating field (10% weight)
  • Developer responsesPATCH /api/discovery/reviews/:id/developer-response
  • Moderation dashboard — admin-only GET /api/discovery/reviews/moderation with status/agentId filter + PATCH /api/discovery/reviews/:id/moderate
  • Search indexing — reviews indexed via TypeORM with agentId + status columns; getApprovedReviews() feeds the discovery API

API Endpoints

Method Path Auth
POST /api/discovery/reviews JWT
GET /api/discovery/reviews/agent/:agentId JWT
GET /api/discovery/reviews/agent/:agentId/aggregation JWT
PATCH /api/discovery/reviews/:id/developer-response JWT
PATCH /api/discovery/reviews/:id/moderate JWT + ADMIN
GET /api/discovery/reviews/moderation JWT + ADMIN

Validation Results

  • npm run build — ✅ webpack compiled successfully
  • npx jest --testPathPattern="agent-reviews" — ✅ 10/10 tests pass
  • Existing tests (agent-scoring) — ✅ 20/20 no regressions

Closes #74

- Add AgentReview TypeORM entity with 5-star rating, review text,
  developer response, spam score, and moderation status columns
- Add AgentReviewsService with:
  - One review per user per agent enforcement
  - Keyword-based spam detection with automatic FLAGGED status
  - Review aggregation (averageRating, distribution) for scoring engine
  - Developer response on reviews
  - Admin moderation (approve/reject/flag) with notes
- Add AgentReviewsController exposing REST endpoints:
  POST /api/discovery/reviews
  GET  /api/discovery/reviews/agent/:agentId
  GET  /api/discovery/reviews/agent/:agentId/aggregation
  PATCH /api/discovery/reviews/:id/developer-response
  PATCH /api/discovery/reviews/:id/moderate  (ADMIN)
  GET  /api/discovery/reviews/moderation     (ADMIN)
- Register AgentReview entity and AgentReviewsModule in AppModule
- getUserRatingForScoring() integrates with existing AgentScoring
  userRating weight (10% of composite score as per issue spec)
- 10 unit tests, all passing; build compiles successfully
@memplethee-lab memplethee-lab merged commit d4cd4ea into SourceXXL:main Jun 24, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Agent Marketplace Review & Rating System

2 participants