Scope Validator

Helps users and contributors understand whether a feature belongs in:

OSS Core → Submit a PR or feature request to genfeedai/core
Cloud SaaS → Subscribe at genfeed.ai/cloud

When This Activates

User asks "should this be in core or cloud?"
User wants to contribute a new node or feature
User requests social publishing features
User asks about RSS/Twitter/feed integration
Feature request triage
PR review for scope compliance

OSS Core Scope

Included Nodes (26 total)

Input Nodes (5)

Node	Type	Description
Image Input	`imageInput`	Upload or reference an image
Audio Input	`audioInput`	Upload an audio file (MP3, WAV)
Video Input	`videoInput`	Upload or reference a video file
Prompt	`prompt`	Text prompt for AI generation
Template	`template`	Preset prompt template

AI Nodes (7)

Node	Type	Description
Image Generator	`imageGen`	Generate images with nano-banana models
Video Generator	`videoGen`	Generate videos with veo-3.1 models
LLM	`llm`	Generate text with meta-llama
Lip Sync	`lipSync`	Generate talking-head video from image/video and audio
Voice Change	`voiceChange`	Replace or mix audio track in a video
Text to Speech	`textToSpeech`	Convert text to natural-sounding speech
Transcribe	`transcribe`	Convert video or audio to text transcript

Processing Nodes (12)

Node	Type	Description
Resize	`resize`	Resize media to different aspect ratios using Luma AI
Animation	`animation`	Apply easing curve to video
Video Stitch	`videoStitch`	Concatenate multiple videos
Video Trim	`videoTrim`	Trim video to a specific time range
Frame Extract	`videoFrameExtract`	Extract a specific frame from video as image
Luma Reframe Image	`lumaReframeImage`	AI-powered image outpainting
Luma Reframe Video	`lumaReframeVideo`	AI-powered video reframing
Topaz Image Upscale	`topazImageUpscale`	AI-powered image upscaling with face enhancement
Topaz Video Upscale	`topazVideoUpscale`	AI-powered video upscaling to 4K
Grid Split	`imageGridSplit`	Split image into grid cells
Annotation	`annotation`	Add shapes, arrows, and text to images
Subtitle	`subtitle`	Burn subtitles into video using FFmpeg

Output Nodes (2)

Node	Type	Description
Output	`output`	Final workflow output
Preview	`preview`	Preview media with playback controls

Cloud-Only Nodes (EXCLUDED from OSS)

Node	Type	Reason
Social Publish	`socialPublish`	Requires OAuth integrations for 7 platforms
RSS Input	`rssInput`	Content aggregation is Cloud feature
Tweet Input	`tweetInput`	Twitter API dependency, feed feature
Tweet Remix	`tweetRemix`	Depends on tweet input, social-focused

Cloud-Only Providers (EXCLUDED from OSS)

Provider	Reason
FAL.ai	Cloud-only provider
HuggingFace	Cloud-only provider

OSS Provider: Replicate only

Validation Rules

Rule 1: Node Type Check

IF node.type IN [socialPublish, rssInput, tweetInput, tweetRemix]
THEN FAIL: "Node type '{node.type}' is Cloud-only. Use OSS alternatives or upgrade to Cloud."

Rule 2: Provider Check

IF node.provider IN [fal, huggingface]
THEN FAIL: "Provider '{node.provider}' is Cloud-only. OSS only supports Replicate."

Rule 3: Template Check

IF template contains Cloud-only nodes
THEN FAIL: "Template uses Cloud-only nodes. Remove: {cloud_nodes}"

Rule 4: Feature Request Check

IF request mentions [publish, social, twitter, rss, feed, youtube upload]
THEN WARN: "Social publishing and feed features are Cloud-only."

Validation Examples

Valid OSS Workflow

{
  "nodes": [
    { "type": "prompt" },
    { "type": "imageGen" },
    { "type": "videoGen" },
    { "type": "subtitle" },
    { "type": "output" }
  ]
}

✅ All nodes are within OSS scope.

Invalid OSS Workflow

{
  "nodes": [
    { "type": "rssInput" },
    { "type": "tweetRemix" },
    { "type": "socialPublish" }
  ]
}

❌ Contains Cloud-only nodes: rssInput, tweetRemix, socialPublish

Response Templates

When Cloud Feature Requested

The feature you're requesting ({feature}) is available in Genfeed Cloud.

OSS Core includes:
- 26 nodes for media generation and processing
- Replicate provider for AI models
- Visual workflow editor with queue-based execution
- Gallery asset management

For social publishing and content aggregation features,
consider upgrading to Genfeed Cloud: https://genfeed.ai/cloud

When Suggesting Alternatives

Instead of {cloud_feature}, consider these OSS alternatives:

1. {alternative_1}
2. {alternative_2}

These achieve similar results within the OSS scope.

Common Requests & Responses

"Can I publish to YouTube?"

Response: Social publishing is Cloud-only. In OSS, use the output node to export your video, then manually upload to YouTube.

"Can I fetch RSS feeds?"

Response: RSS/feed aggregation is Cloud-only. In OSS, use the prompt node with manually entered content, or the template node with predefined prompts.

"Can I use FAL.ai models?"

Response: FAL.ai is Cloud-only. OSS uses Replicate provider. Check if the model you need is available on Replicate.

"Can I remix tweets?"

Response: Tweet remix is Cloud-only. In OSS, use the llm node with a custom prompt to rewrite text in different tones.

Integration

When validating:

Parse the request - Identify node types, providers, and features mentioned
Check against scope - Compare with OSS node list
Report violations - List all Cloud-only features found
Suggest alternatives - Provide OSS workarounds when possible
Link to Cloud - Mention upgrade path for full feature access

Quick Reference

OSS Node Types (26):
  Input:      imageInput, audioInput, videoInput, prompt, template
  AI:         imageGen, videoGen, llm, lipSync, voiceChange, textToSpeech, transcribe
  Processing: resize, animation, videoStitch, videoTrim, videoFrameExtract,
              lumaReframeImage, lumaReframeVideo, topazImageUpscale,
              topazVideoUpscale, imageGridSplit, annotation, subtitle
  Output:     output, preview

Cloud-Only (4):
  socialPublish, rssInput, tweetInput, tweetRemix

OSS Provider:
  replicate (only)

Cloud Providers:
  fal, huggingface

scope-validator