@oh-story/dsh 0.1.17 → 0.1.19

package/lib/drama/skills/short-drama-video-prompts/assets/coverage-scope.fragment.json

@@ -1,21 +0,0 @@
-{
-  "coverage_scope": {
-    "mode": "pickup | alternate",
-    "master_motion_id": "MOTION-<master-id>",
-    "supplements_motion_ids": [
-      "MOTION-<same-file-record-id>"
-    ],
-    "source_obligations": [
-      {
-        "kind": "action | reaction | dialogue | reveal | directive | end_boundary",
-        "source_ref": {
-          "src": "screenplay-index",
-          "record_id": "BLK-<EP>-<SC>-<kind><nn>"
-        },
-        "disposition": "covered_now | retained_in_master | separate_pickup | requires_storyboard_revision",
-        "motion_field": "/<current-motion-field-or-none>"
-      }
-    ],
-    "replacement_intent": "does_not_replace_master | requests_supersession"
-  }
-}

package/lib/drama/skills/short-drama-video-prompts/assets/motion-terminal.example.jsonl

@@ -1,2 +0,0 @@
-{"record_type": "sources", "schema_version": "1.0.0", "sources": {"shots": {"owner": "short-drama-storyboard", "artifact": "剧集/EP001/storyboard/shots.jsonl"}, "keyframes": {"owner": "short-drama-storyboard", "artifact": "剧集/EP001/storyboard/keyframes.jsonl"}}}
-{"example_only": true, "motion_id": "MOTION-EP001-LAST", "status": "candidate", "authority": "candidate", "shot_ref": {"src": "shots", "record_id": "SHOT-EP001-LAST", "authority": "candidate"}, "keyframe_ref": {"src": "keyframes", "record_id": "KEY-EP001-LAST", "authority": "candidate"}, "next_start_locator": {"owner": "short-drama-storyboard", "artifact": "剧集/EP002/storyboard/shots.jsonl", "selector": {"record_id": "SHOT-EP002-FIRST", "field": "/start_boundary"}, "status": "future_until_episode_materializes", "access": "comparison_only"}, "rule": "next_start_locator is not an ArtifactRef and cannot satisfy accepted continuity until resolved"}

package/lib/drama/skills/short-drama-video-prompts/assets/performance.fragment.json

@@ -1,38 +0,0 @@
-{
-  "performance_arcs": [
-    {
-      "actor_ref": {
-        "src": "characters",
-        "record_id": "CHAR-<id>"
-      },
-      "trigger_ref": {
-        "src": "screenplay-index",
-        "record_id": "BLK-<EP>-<SC>-<kind><nn>"
-      },
-      "agenda": "<本镜需要读出的当前策略；无增益时删除>",
-      "receive": "<角色怎样接收触发；无内在处理时删除>",
-      "mask": "<确有掩饰时才保留>",
-      "visible_leak": "<当前景别可读的目光/尾音/手部/距离信号；没有则删除>",
-      "choice": "<说、做或刻意不做的方向性选择>",
-      "landing": "<选择怎样落到 accepted end>"
-    }
-  ],
-  "attention_handoffs": [
-    {
-      "from_ref": {
-        "src": "<注意归属方产物的 sources key>",
-        "record_id": "<exact-attention-owner-record-id>"
-      },
-      "trigger_ref": {
-        "src": "screenplay-index",
-        "record_id": "BLK-<EP>-<SC>-<kind><nn>"
-      },
-      "to_ref": {
-        "src": "<注意归属方产物的 sources key>",
-        "record_id": "<exact-attention-owner-record-id>"
-      },
-      "signal": "<使注意转移的可见或可听信号>",
-      "readability": "<当前景别、遮挡和声源为何读得到>"
-    }
-  ]
-}

package/lib/drama/skills/short-drama-video-prompts/examples/minimal-music-specs.jsonl

@@ -1,2 +0,0 @@
-{"record_type": "sources", "schema_version": "1.0.0", "sources": {"screenplay": {"owner": "short-drama-write", "artifact": "剧集/EP001/screenplay.md"}}}
-{"music_id": "MUS-EP001-01", "scope": {"episode_id": "EP001", "start_seconds": 0, "end_seconds": 12}, "source_refs": [{"src": "screenplay", "record_id": "EP001-SC001"}], "narrative_function": "在开场压低情绪，只在人物做出决定后抬升，不替代表演。", "prompt": "Instrumental restrained urban drama score, low pulse, sparse piano, muted strings, controlled tension, no triumphant release.", "mode": "instrumental", "lyrics": null, "mix_intent": {"entry": "fade in under room tone after the first visible action", "exit": "resolve before the final spoken line", "duck_under_dialogue": true, "loop": false}, "status": "candidate"}

package/lib/drama/skills/short-drama-video-prompts/scripts/container_check.py

@@ -1,329 +0,0 @@
-#!/usr/bin/env python3
-"""Reconcile an episode's delivery containers against its shot set (`VID-15`).
-
-Every container can be correct on its own while the episode is wrong: a shot
-packed into two containers bills its seconds twice, and a shot packed into none
-disappears although its dialogue, bindings, and keyframe prompts are already
-done. Neither error is visible from inside a single container, so the check is
-a set comparison at episode scope.
-
-The script reads accepted creator files and writes nothing.
-"""
-
-from __future__ import annotations
-
-import argparse
-import json
-import sys
-from pathlib import Path
-from typing import Any
-
-
-# Creators run these scripts on whatever interpreter their machine provides, so
-# an unsupported version must say so instead of failing inside an import.
-MINIMUM_PYTHON = (3, 9)
-if sys.version_info < MINIMUM_PYTHON:
-    raise SystemExit(
-        "short-drama needs Python {}.{} or newer; this interpreter is {}.{}".format(
-            *MINIMUM_PYTHON, sys.version_info.major, sys.version_info.minor
-        )
-    )
-
-SCHEMA_VERSION = "1.0.0"
-# A .jsonl file opens with a header record declaring the upstream snapshots its
-# references name. The header is a declaration, not one of the file's records.
-SOURCES_RECORD_TYPE = "sources"
-
-
-class CheckError(ValueError):
-    """The inputs cannot be checked at all, as opposed to failing a check."""
-
-
-def _load_jsonl(path: Path) -> list[dict[str, Any]]:
-    records: list[dict[str, Any]] = []
-    try:
-        text = path.read_text(encoding="utf-8")
-    except (OSError, UnicodeError) as error:
-        raise CheckError(f"unreadable JSONL: {path}") from error
-    for number, line in enumerate(text.splitlines(), start=1):
-        if not line.strip():
-            continue
-        try:
-            record = json.loads(line)
-        except json.JSONDecodeError as error:
-            raise CheckError(f"invalid JSONL at {path.name}:{number}") from error
-        if not isinstance(record, dict):
-            raise CheckError(f"JSONL needs one object per line: {path.name}:{number}")
-        records.append(record)
-    if records and records[0].get("record_type") == SOURCES_RECORD_TYPE:
-        del records[0]
-    return records
-
-
-def _finding(code: str, message: str, **detail: Any) -> dict[str, Any]:
-    return {"code": code, "message": message, **detail}
-
-
-def _seconds(value: Any) -> float | None:
-    if isinstance(value, bool) or not isinstance(value, (int, float)):
-        return None
-    return float(value)
-
-
-# The three conclusions `delivery-container.jsonl.md` requires a container to
-# state about why its members belong together.
-MEMBERSHIP_BASIS_KEYS = (
-    "source_order_contiguous",
-    "binding_chain_equal",
-    "scene_boundary_not_crossed",
-)
-
-
-def _member_shot_id(member: Any) -> str | None:
-    if not isinstance(member, dict):
-        return None
-    ref = member.get("shot_ref")
-    if isinstance(ref, dict) and isinstance(ref.get("record_id"), str):
-        return ref["record_id"]
-    return None
-
-
-def reconcile(
-    containers: list[dict[str, Any]],
-    shots: list[dict[str, Any]],
-) -> dict[str, Any]:
-    findings: list[dict[str, Any]] = []
-    durations = {
-        shot["shot_id"]: _seconds(shot.get("duration_seconds"))
-        for shot in shots
-        if isinstance(shot.get("shot_id"), str)
-    }
-    episode_shots = set(durations)
-
-    owner_of: dict[str, str] = {}
-    packed: set[str] = set()
-    container_total = 0.0
-    for container in containers:
-        container_id = container.get("container_id")
-        if not isinstance(container_id, str):
-            findings.append(
-                _finding("VID15_CONTAINER_HAS_NO_ID", "a container record has no id")
-            )
-            continue
-        members = container.get("members")
-        if not isinstance(members, list) or not members:
-            findings.append(
-                _finding(
-                    "VID15_CONTAINER_HAS_NO_MEMBERS",
-                    "a container carries no members",
-                    container_id=container_id,
-                )
-            )
-            continue
-        # Checkpoint 1: `order` unique, contiguous and ascending. A delivery
-        # package is assembled in this order, so a repeated or skipped number is
-        # an ambiguous cut list, not a cosmetic flaw.
-        orders = [
-            member.get("order") for member in members if isinstance(member, dict)
-        ]
-        if not all(
-            isinstance(value, int) and not isinstance(value, bool) for value in orders
-        ) or orders != list(range(1, len(members) + 1)):
-            findings.append(
-                _finding(
-                    "VID15_MEMBER_ORDER_IS_NOT_A_SEQUENCE",
-                    "members must carry order 1..n, ascending and without gaps",
-                    container_id=container_id,
-                    orders=orders,
-                )
-            )
-
-        # Checkpoint 7: the three membership_basis conclusions. Each is a claim
-        # about why these shots belong in one container; leaving one blank makes
-        # the container's own justification unreadable.
-        basis = container.get("membership_basis")
-        if not isinstance(basis, dict):
-            findings.append(
-                _finding(
-                    "VID15_MEMBERSHIP_BASIS_MISSING",
-                    "a container must record why its members belong together",
-                    container_id=container_id,
-                )
-            )
-        else:
-            blank = sorted(
-                key
-                for key in MEMBERSHIP_BASIS_KEYS
-                if not str(basis.get(key) or "").strip()
-            )
-            if blank:
-                findings.append(
-                    _finding(
-                        "VID15_MEMBERSHIP_BASIS_INCOMPLETE",
-                        "every membership_basis conclusion must be stated",
-                        container_id=container_id,
-                        missing=blank,
-                    )
-                )
-
-        member_total = 0.0
-        for member in members:
-            shot_id = _member_shot_id(member)
-            if shot_id is None:
-                findings.append(
-                    _finding(
-                        "VID15_MEMBER_HAS_NO_SHOT_REF",
-                        "a member does not name the shot it packs",
-                        container_id=container_id,
-                    )
-                )
-                continue
-            if shot_id not in episode_shots:
-                findings.append(
-                    _finding(
-                        "VID15_MEMBER_IS_NOT_AN_EPISODE_SHOT",
-                        "a container packs a shot that is not in this episode",
-                        container_id=container_id,
-                        shot_id=shot_id,
-                    )
-                )
-                continue
-            previous = owner_of.get(shot_id)
-            if previous is not None:
-                findings.append(
-                    _finding(
-                        "VID15_SHOT_PACKED_TWICE",
-                        "a shot belongs to more than one container",
-                        shot_id=shot_id,
-                        container_ids=sorted({previous, container_id}),
-                    )
-                )
-                continue
-            owner_of[shot_id] = container_id
-            packed.add(shot_id)
-            seconds = durations.get(shot_id)
-            if seconds is None:
-                findings.append(
-                    _finding(
-                        "VID15_MEMBER_SHOT_HAS_NO_DURATION",
-                        "a packed shot carries no numeric duration",
-                        container_id=container_id,
-                        shot_id=shot_id,
-                    )
-                )
-                continue
-
-            # Checkpoint 3: the member's own `accepted_duration` against the
-            # shot it projects. This field was never read: the total was summed
-            # straight from `shots.jsonl`, so a member could claim 12.0s for a
-            # 6.3s shot and pass, and the execution end would be handed the 12.0.
-            # `motion_timing_check` guards exactly this staleness class; this
-            # file had no equivalent.
-            claimed = _seconds(member.get("accepted_duration"))
-            if claimed is None:
-                findings.append(
-                    _finding(
-                        "VID15_MEMBER_HAS_NO_ACCEPTED_DURATION",
-                        "a member must project the duration it packs",
-                        container_id=container_id,
-                        shot_id=shot_id,
-                    )
-                )
-            elif abs(claimed - seconds) > 1e-6:
-                findings.append(
-                    _finding(
-                        "VID15_MEMBER_DURATION_IS_STALE",
-                        "a member's accepted_duration does not match its shot",
-                        container_id=container_id,
-                        shot_id=shot_id,
-                        claimed=claimed,
-                        accepted=seconds,
-                    )
-                )
-            member_total += seconds
-        stated = _seconds(container.get("container_duration"))
-        if stated is None:
-            findings.append(
-                _finding(
-                    "VID15_CONTAINER_DURATION_MISSING",
-                    "container_duration must be present and a number of seconds",
-                    container_id=container_id,
-                )
-            )
-        elif abs(stated - member_total) > 1e-6:
-            findings.append(
-                _finding(
-                    "VID15_CONTAINER_DURATION_IS_NOT_THE_SUM",
-                    "container_duration does not equal its members' durations",
-                    container_id=container_id,
-                    stated=stated,
-                    computed=round(member_total, 6),
-                )
-            )
-        container_total += member_total
-
-    loose = sorted(episode_shots - packed)
-    # A shot whose duration is still open is a legal state upstream, so it is
-    # held out of the arithmetic instead of being reported as an error. Only a
-    # shot packed into a container must already have one, because the
-    # container's own duration claim depends on it.
-    unmeasured = sorted(
-        shot_id for shot_id in episode_shots if durations.get(shot_id) is None
-    )
-    loose_total = sum(
-        durations[shot_id] or 0.0 for shot_id in loose if durations.get(shot_id) is not None
-    )
-
-    episode_total = sum(value for value in durations.values() if value is not None)
-    if abs((container_total + loose_total) - episode_total) > 1e-6:
-        findings.append(
-            _finding(
-                "VID15_EPISODE_TOTAL_DOES_NOT_RECONCILE",
-                "containers plus loose shots do not add up to the episode total",
-                packed_seconds=round(container_total, 6),
-                loose_seconds=round(loose_total, 6),
-                episode_seconds=round(episode_total, 6),
-            )
-        )
-
-    return {
-        "schema_version": SCHEMA_VERSION,
-        "containers": len(containers),
-        "episode_shots": len(episode_shots),
-        "packed_shots": len(packed),
-        # Loose shots are legal: containers need not cover everything. They are
-        # reported so the count is a decision rather than an oversight.
-        "loose_shots": loose,
-        # Reported, not a finding: these shots are excluded from every total
-        # above, so a caller can tell an incomplete episode from a wrong one.
-        "unmeasured_shots": unmeasured,
-        "packed_seconds": round(container_total, 6),
-        "loose_seconds": round(loose_total, 6),
-        "episode_seconds": round(episode_total, 6),
-        "findings": findings,
-        "status": "pass" if not findings else "fail",
-    }
-
-
-def build_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(
-        description="Reconcile delivery containers with the episode's shot set."
-    )
-    parser.add_argument("containers", type=Path, help="the episode containers JSONL")
-    parser.add_argument("--shots", type=Path, required=True)
-    return parser
-
-
-def main(argv: list[str] | None = None) -> int:
-    args = build_parser().parse_args(argv)
-    try:
-        result = reconcile(_load_jsonl(args.containers), _load_jsonl(args.shots))
-    except CheckError as error:
-        print(f"{type(error).__name__}: {error}", file=sys.stderr)
-        return 2
-    print(json.dumps(result, ensure_ascii=True, sort_keys=True))
-    return 0 if result["status"] == "pass" else 1
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())