video_prompt_layer_audit 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e437015fc5fdfa7301d831cfa324b05e144b76b6489855497da856a789bd17d7
+  data.tar.gz: 91d009fb64c8614205de888426bd84a0ef400168b6b7df4645463a7f015b3c4c
+SHA512:
+  metadata.gz: 85439d218d5f02ec504e829f64da3296ab95895daa0962a9afe2d9fecb60ec9a212457229db4d3473bcd8597da5989b6367da54444e2b9680f82b0d519b8ec23
+  data.tar.gz: ef239f6777e68d76d1361abff97bb0eed90dbc29452e2e645773173b554622d7cfe7a6a05e265c0a28a669e35fc4073ec16f8e99a3e6e223464a353e580ce7af

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 1.0.0
+
+- Added deterministic checks for subject, motion, and camera prompt layers.
+- Added readable summary output and tests for complete and incomplete briefs.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Martyn Foster
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,39 @@
+# Video Prompt Layer Audit
+
+`video_prompt_layer_audit` is a dependency-free Ruby helper for reviewing short AI video briefs before generation. It separates a concept into subject, motion, camera, and optional audio layers so missing instructions are reported deterministically instead of being discovered after a draft is rendered.
+
+## Why layered prompts help
+
+A still image brief can describe what appears in one frame. A video brief also needs to explain what changes over time and how the camera behaves. When these instructions are packed into one sentence, conflicts are easy to miss: a static close-up may be paired with a fast orbit, or a slow action may be expected to fit into an unrealistically short shot.
+
+The gem checks that the three core layers contain meaningful text:
+
+- **Subject:** the person, object, or scene that must remain recognizable.
+- **Motion:** the primary action, including a clear starting and ending state.
+- **Camera:** one intentional behavior such as static, pan, track, push-in, or handheld.
+- **Audio:** optional dialogue, ambience, effects, music direction, or silence.
+
+## Usage
+
+```ruby
+require "video_prompt_layer_audit"
+
+brief = {
+  subject: "A cyclist in a weathered green jacket",
+  motion: "Pedals steadily toward the camera",
+  camera: "Low tracking shot from the side",
+  audio: "Wind and distant waves"
+}
+
+VideoPromptLayerAudit.valid?(brief)
+VideoPromptLayerAudit.issues(brief)
+puts VideoPromptLayerAudit.summary(brief)
+```
+
+The output can be saved with a creative request or checked in a pre-generation job. It does not call a model and does not claim that a valid brief guarantees a specific visual result.
+
+For creators translating the reviewed layers into a browser-based prompt workflow, [Muse Video](https://muse-video.app/) supports coordinated subject, motion, camera, visual, and audio direction. The underlying model is presented as preview-stage, so verify current access and product details on the live page rather than relying on cached limits or performance claims.
+
+## Review boundaries
+
+Use the audit as an intake check, then inspect generated drafts frame by frame. Split concepts that require multiple camera setups into separate shots, record details that must remain fixed, and avoid presenting unverified outputs as production evidence.

data/lib/video_prompt_layer_audit/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module VideoPromptLayerAudit
+  VERSION = "1.0.0"
+end

data/lib/video_prompt_layer_audit.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative "video_prompt_layer_audit/version"
+
+module VideoPromptLayerAudit
+  REQUIRED_LAYERS = %i[subject motion camera].freeze
+
+  def self.issues(brief)
+    missing = REQUIRED_LAYERS.reject { |key| brief.fetch(key, "").to_s.strip.length >= 8 }
+    missing.map { |key| "#{key} is missing or too short" }
+  end
+
+  def self.valid?(brief)
+    issues(brief).empty?
+  end
+
+  def self.summary(brief)
+    %i[subject motion camera audio].filter_map do |key|
+      value = brief.fetch(key, "").to_s.strip
+      "#{key.to_s.capitalize}: #{value}" unless value.empty?
+    end.join("\n")
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: video_prompt_layer_audit
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Martyn Foster
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: A dependency-free Ruby helper for checking structured AI video briefs
+  before generation.
+email:
+- FosterMartyn735@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/video_prompt_layer_audit.rb
+- lib/video_prompt_layer_audit/version.rb
+homepage: https://muse-video.app/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://muse-video.app/
+  source_code_uri: https://muse-video.app/
+  changelog_uri: https://muse-video.app/
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: Audit subject, motion, camera, and audio layers in short video prompts.
+test_files: []