Remove gearcut_ground.py from public space (moved to private repo)

gearcut_ground.py

@@ -1,112 +0,0 @@
-"""
-GearCut — operation grounding (constrained-decoding safety layer).
-
-Takes the operations the model produced + the user's instruction, and forces the
-output to be CONSISTENT with what the user actually wrote:
-
-  * numbers must come from the instruction  (kills hallucinated values like 600)
-  * filenames must come from the instruction (fixes out.mp4 -> output.mp4 drift)
-  * presets / ops / clip ids must be valid
-  * a number-requiring op with no number to ground is REJECTED (and reported),
-    so a misunderstanding becomes a visible warning, never a wrong silent edit.
-
-Pure standard library — no torch. Fully unit-tested.
-"""
-import re
-
-KNOWN_OPS = {"trim", "split", "import", "append", "delete", "reorder", "export"}
-PRESETS = {"youtube_1080p", "tiktok_vertical", "instagram_square", "web_720p", "master_4k"}
-NUM_FIELDS = ("seconds", "at", "start", "end")
-
-_FILE_RE = re.compile(r"\b[\w-]+\.(?:mp4|mov|webm|mkv|avi|m4v|mp3|wav|aac)\b", re.I)
-_NUM_RE = re.compile(r"\d+(?:\.\d+)?")
-
-
-def _to_float(x):
-    try:
-        return float(x)
-    except (TypeError, ValueError):
-        return None
-
-
-def instruction_facts(instruction: str):
-    """Extract the numbers, filenames and presets the user actually wrote."""
-    files = _FILE_RE.findall(instruction)
-    # strip filenames and clip references first so their digits
-    # (test2.mp4, "clip 1") don't get mistaken for editing numbers
-    text = _FILE_RE.sub(" ", instruction)
-    text = re.sub(r"\bclips?\s*\d+", " ", text, flags=re.I)   # "clip 1", "clips 2"
-    text = re.sub(r"\bc\d+\b", " ", text, flags=re.I)          # "c1", "c2"
-    numbers = [float(m) for m in _NUM_RE.findall(text)]
-    presets = [p for p in PRESETS if p in instruction]
-    return numbers, files, presets
-
-
-def ground_operations(ops, instruction, clip_ids=None):
-    """Return (grounded_ops, repairs). `repairs` is a list of human-readable notes."""
-    repairs = []
-    if not isinstance(ops, list):
-        return [], ["model output was not a list of operations"]
-
-    numbers, files, presets = instruction_facts(instruction)
-    unused = list(numbers)            # instruction numbers still available to assign
-    clip_ids = set(clip_ids or [])
-    grounded = []
-
-    def take_match(v):                # consume an instruction number equal to v
-        for i, x in enumerate(unused):
-            if abs(x - v) < 0.01:
-                return unused.pop(i)
-        return None
-
-    for op in ops:
-        if not isinstance(op, dict) or op.get("op") not in KNOWN_OPS:
-            repairs.append(f"dropped unrecognized op: {op!r}")
-            continue
-        op = dict(op)
-        kind = op["op"]
-        drop = False
-
-        # 1) ground numeric fields against the instruction's numbers
-        for key in NUM_FIELDS:
-            if key not in op:
-                continue
-            v = _to_float(op[key])
-            if v is not None and take_match(v) is not None:
-                op[key] = v                       # the model copied a real number — keep it
-            elif unused:
-                new = unused.pop(0)               # hallucinated/wrong -> next instruction number
-                repairs.append(f"{kind}.{key}: {op[key]} -> {new} (grounded to instruction)")
-                op[key] = new
-            else:
-                drop = True                       # no number to ground -> unsafe, reject
-                repairs.append(f"rejected {kind}: '{key}={op[key]}' has no matching number "
-                               f"in the instruction (possible misread)")
-                break
-        if drop:
-            continue
-
-        # 2) ground export path + preset
-        if kind == "export":
-            if files and op.get("path") not in files:
-                repairs.append(f"export.path: {op.get('path')!r} -> {files[-1]!r} (from instruction)")
-                op["path"] = files[-1]
-            if op.get("preset") not in PRESETS:
-                op["preset"] = presets[0] if presets else "youtube_1080p"
-                repairs.append(f"export.preset -> {op['preset']}")
-            elif presets and op["preset"] not in presets:
-                repairs.append(f"export.preset: {op['preset']} -> {presets[0]} (from instruction)")
-                op["preset"] = presets[0]
-
-        # 3) ground import source
-        if kind == "import" and files and op.get("source") not in files:
-            repairs.append(f"import.source: {op.get('source')!r} -> {files[0]!r} (from instruction)")
-            op["source"] = files[0]
-
-        # 4) sanity-check clip id (don't auto-fix; flag so the app can warn)
-        if "clip" in op and clip_ids and op["clip"] not in clip_ids:
-            repairs.append(f"warning: {kind} refers to unknown clip {op['clip']!r}")
-
-        grounded.append(op)
-
-    return grounded, repairs