nextaltair/video-library-pipeline-extract-review

V2 Metadata Review Gate

Rule

• Use only video_pipeline_status, video_pipeline_inspect_artifact, and supported video_pipeline_resume actions.
• Do not search for latest extraction JSONL/YAML files.
• The run manifest and ReviewGate.artifactIds define the review scope.
• Do not ask the user to decide destination folders in this stage.
• SourceRoot metadata review resumes through the returned apply_reviewed_metadata action after the user confirms YAML review is complete.

Review Scope

Review only metadata fields represented by the run artifact:

• program_title should be the series/program title only.
• air_date should be correct when present.
• needs_review and review reasons should be addressed or intentionally left unresolved.
• YAML alias/canonical-title entries should map contaminated or variant titles to the correct canonical title.

Out of scope:

• destination folder taxonomy
• physical move approval
• dedup decisions
• genre routing decisions

Tool Sequence

1. If the current result is not already available, call:

   video_pipeline_status {
     "runId": "<runId>",
     "includeArtifacts": true
   }
   

2. Find open review gates in gates / reviewGates.
3. For each referenced artifact ID, inspect it:

   video_pipeline_inspect_artifact {
     "runId": "<runId>",
     "artifactId": "<artifactId>",
     "includeContentPreview": true
   }
   

4. Present the artifact path and concrete review scope to the user.
5. After the user confirms review is complete, execute the returned follow-up params:

   video_pipeline_resume {
     "runId": "<runId>",
     "resumeAction": "<resumeAction from nextActions>",
     "...": "other params from nextActions.params"
   }
   

Required Behavior

• Use params exactly as returned by followUpToolCalls or nextActions.params.
• If a follow-up has requiresHumanReview: true, never call it before user confirmation.
• Do not synthesize resume params by scanning latest files; use status/result nextActions.
• After resume, read the returned phase:
  • plan_ready: hand off to skills/move-review/SKILL.md.
  • review_required: repeat this skill for the new/open gate.
  • blocked or failed: report diagnostics and stop.

Legacy Guardrail

The old standalone extraction/apply tools are hidden in the V2 public surface. Do not instruct the operator to call hidden legacy tools directly. If metadata repair cannot be completed through the returned video_pipeline_resume action, report diagnostics rather than guessing a latest JSONL/YAML path.