ruvnet/ruflo · error

itemId required

Error message

itemId required

What it means

The 'get-ratings' action found no itemId in the query string. Input-presence guard: ratings are stored per item under ratings/<itemType>/<itemId>, so without an item id there is no file to read and the function returns 400.

Source

Thrown at v3/@claude-flow/cli/cloud-functions/publish-registry/index.js:431

        });

        // Track rating event
        await trackEvent(bucket, 'rating', itemId, { rating, itemType });

        return res.json({
          success: true,
          itemId,
          average: Math.round(ratings.average * 10) / 10,
          count: ratings.count,
        });
      }

      case 'get-ratings': {
        // Get ratings for a plugin or model
        const { itemId, itemType = 'plugin' } = req.query;

        if (!itemId) {
          return res.status(400).json({ error: 'itemId required' });
        }

        const ratingsFile = bucket.file(`ratings/${itemType}/${itemId}.json`);

        try {
          const [exists] = await ratingsFile.exists();
          if (!exists) {
            return res.json({ itemId, average: 0, count: 0, ratings: [] });
          }

          const [content] = await ratingsFile.download();
          const ratings = JSON.parse(content.toString());

          return res.json({
            itemId,
            average: Math.round(ratings.average * 10) / 10,
            count: ratings.count,
            // Don't expose individual user ratings

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Provide all required parameters listed in the message.
2. Validate required fields before dispatch and report the full set of missing fields at once.

When it happens

Trigger: Thrown at v3/@claude-flow/cli/cloud-functions/publish-registry/index.js:431 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/1a54e295d96a7b55. Report an issue: GitHub.