{
  "pack_id": "film-and-surface-rule-evaluator",
  "title": "Film and surface rule evaluator",
  "version": "0.1.0",
  "summary": "A collection of nouns and verbs for evaluating declarative film and surface rule nouns, blocking forbidden synthetic or non-functional stamps, scoring frosted-pill caption centering and dual-channel cognitive load, repointing dead repository links to SHA-256-pinned source mirrors and verifying llms.txt parity against MCP tools.",
  "dependencies": [
    "scene-and-cognitive-video-qa",
    "audio-and-narration-qa",
    "rename-and-relink",
    "configuration-grids-and-bounds"
  ],
  "boundaries": [
    "Missing measurements evaluate to unknown rather than fabricated zero passes.",
    "Simulated fallback answers, synthetic disclaimers and non-functional status chips fail readiness checks.",
    "Admitting a film cut or surface readiness receipt requires an independent distinct_reviewer.",
    "Importing the pack writes nothing, enqueues nothing and installs no code."
  ],
  "nouns": [
    {
      "slug": "pack",
      "category": "noun.skill_pack",
      "role": "pack",
      "title": "A collection of nouns and verbs for evaluating declarative film and surface rule nouns, blocking forbidden synthetic or non-functional stamps, scoring frosted-pill caption centering and dual-channel cognitive load, repointing dead repository links to SHA-256-pinned source mirrors and verifying llms.txt parity against MCP tools",
      "value": {
        "lets_workers": "Evaluate declarative film and surface rule nouns across eight comparison operators with honest unknown propagation, detect forbidden synthetic stamps at native frame resolution, check frosted-pill caption centering and competing dual-channel load, rewrite dead external repository URLs to SHA-256-pinned /source/ mirror routes and verify 1:1 llms.txt tool parity against MCP tools/list.",
        "flow": [
          {
            "verb": {
              "$verb": "film-and-surface-rule-evaluator.evaluate-film-rules-and-caption-load"
            },
            "when": "Run declarative pre/post rule nouns, scan native-resolution OCR spans for forbidden stamps and verify frosted-pill centering and dual-channel reading load."
          },
          {
            "verb": {
              "$verb": "film-and-surface-rule-evaluator.repoint-dead-links-and-check-mcp-parity"
            },
            "when": "Rewrite dead external repository links to self-hosted /source/ mirror anchors/archives and verify /llms.txt tool parity against MCP tools/list."
          },
          {
            "verb": {
              "$verb": "film-and-surface-rule-evaluator.review-film-and-surface-readiness"
            },
            "when": "Independently verify zero block failures, zero simulated fallbacks and complete mirror link resolution before sign-off."
          }
        ],
        "guardrails": [
          {
            "$pin": "guardrail.honest-unknown-and-no-simulated-fallback"
          },
          {
            "$pin": "guardrail.distinct-reviewer-on-readiness"
          }
        ],
        "tool": {
          "$pin": "tool.film-surface-rules"
        },
        "worked_example": "Synthetic 9-rule film and surface bundle recomputed in test_film_surface_rules.py: passes 8 active operators plus 1 advisory note, blocks 2 forbidden stamps and 2 non-functional status chips on a dirty fixture, verifies 1.0 px frosted-pill centering, rewrites 3 dead repository URLs to /source/ mirror and intake routes, and confirms 4-tool llms.txt MCP parity."
      },
      "relations": [
        [
          "requires_noun",
          "guardrail.honest-unknown-and-no-simulated-fallback"
        ],
        [
          "requires_noun",
          "guardrail.distinct-reviewer-on-readiness"
        ],
        [
          "requires_noun",
          "spec.declarative-film-and-surface-rules"
        ],
        [
          "requires_noun",
          "rules.mirror-relink-and-mcp-parity"
        ],
        [
          "requires_noun",
          "tool.film-surface-rules"
        ],
        [
          "requires_noun",
          "template.film-surface-rules-receipt"
        ]
      ]
    },
    {
      "slug": "guardrail.honest-unknown-and-no-simulated-fallback",
      "category": "noun.skill_pack",
      "role": "guardrail",
      "title": "Guardrail: missing measurements stay unknown and simulated fallbacks or synthetic stamps fail closed",
      "category_reason": "Prevents unmeasured metrics or simulated demo fallbacks from masquerading as verified functionality.",
      "value": {
        "rule": "Absent or null measurements never coerce to 0; any forbidden non-functional stamp, building/needed chip or simulated demo fallback blocks readiness.",
        "how_it_is_checked": "evaluate_declarative_rule_nouns returns unknown on missing paths, scan_forbidden_stamps_and_chips blocks forbidden text and verify_llms_txt_and_mcp_parity rejects has_simulated_fallback."
      }
    },
    {
      "slug": "guardrail.distinct-reviewer-on-readiness",
      "category": "noun.skill_pack",
      "role": "guardrail",
      "title": "Guardrail: film cut and surface readiness receipts require an independent reviewer",
      "category_reason": "Preserves independent review before publishing cuts or surface mirror updates.",
      "value": {
        "rule": "The worker reviewing rule-noun, mirror-relink and MCP parity receipts cannot share worker_id or key_id with the producer.",
        "how_it_is_checked": "review-film-and-surface-readiness sets review to distinct_reviewer."
      }
    },
    {
      "slug": "spec.declarative-film-and-surface-rules",
      "category": "noun.benchmark_suite",
      "role": "spec",
      "title": "Specification: eight declarative rule operators, frosted-pill geometry and dual-channel load limits",
      "category_reason": "Defines deterministic thresholds and operator semantics for film and surface verification.",
      "value": {
        "operators": [
          "<",
          "<=",
          ">=",
          "abs<=",
          "in_range",
          "empty",
          "is_true",
          "is_false"
        ],
        "hook_windows": [
          "pre",
          "post"
        ],
        "severities": [
          "block",
          "warn",
          "info"
        ],
        "caption_geometry": {
          "stage_width_px": 1920,
          "stage_height_px": 840,
          "band_total_px": 240,
          "center_tol_px": 2,
          "max_lines": 2,
          "max_chars_per_line": 42,
          "max_cps": 17.0
        }
      }
    },
    {
      "slug": "rules.mirror-relink-and-mcp-parity",
      "category": "noun.reflex_procedure",
      "role": "rules",
      "title": "Deterministic /source/ mirror URL rewrite and /llms.txt MCP parity procedure",
      "category_reason": "Zero-model procedure repointing dead external repo links and checking documented MCP tools.",
      "value": {
        "route_rules": [
          "Account root URLs rewrite to /source/.",
          "Repository tree/blob subpaths rewrite to /source/#<slug>:<subpath>@<commit12> with pinned archive SHA-256 prefix.",
          "Repository /issues/new links rewrite to live intake doors (/nonprofits) rather than dead issue trackers."
        ],
        "mcp_parity_rule": "Every stated N tools count and bulleted tool name in /llms.txt matches live MCP tools/list 1:1 with zero simulated fallback.",
        "model_calls": 0
      }
    },
    {
      "slug": "tool.film-surface-rules",
      "category": "noun.code_node",
      "role": "tool_card",
      "title": "Tool card: standard-library declarative film rule evaluator, stamp scanner, mirror rewriter and MCP parity gate",
      "category_reason": "Tested Python 3.10+ standard-library package pinned by path and SHA-256.",
      "value": {
        "name": "film and surface rule evaluator",
        "code": {
          "$code": "film-and-surface-rule-evaluator"
        },
        "runtime": "Python 3.10 or later, standard library only.",
        "commands": [
          "python -m film_surface_rules BUNDLE.json"
        ],
        "does": [
          "Evaluates declarative rule nouns across 8 comparison operators with honest unknown propagation.",
          "Scans native-resolution OCR spans for forbidden synthetic stamps and scores frosted-pill caption centering and dual-channel load.",
          "Rewrites dead repository links to SHA-256-pinned /source/ mirror routes and verifies /llms.txt against MCP tools/list."
        ],
        "does_not": [
          "Modify video binaries in place, fabricate missing metrics or run live network calls."
        ],
        "code_license": "MIT"
      },
      "relations": [
        [
          "verifies",
          "spec.declarative-film-and-surface-rules"
        ]
      ]
    },
    {
      "slug": "template.film-surface-rules-receipt",
      "category": "noun.scene_recipe",
      "role": "template",
      "title": "Template: declarative film rule, stamp scan, caption load, mirror rewrite and MCP parity receipt",
      "value": {
        "describes": "a deterministic receipt covering rule-noun verdicts, forbidden stamp/chip blocks, caption centering, mirror link rewrites and MCP parity",
        "schema": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "rule_verdict",
            "evaluated_rules",
            "passed_rules",
            "advisory_rules",
            "clean_cut_passed",
            "dirty_cut_blocked",
            "dirty_stamp_hit_count",
            "dirty_chip_hit_count",
            "caption_and_load_passed",
            "max_center_offset_px",
            "max_observed_cps",
            "mirror_all_resolved",
            "mirror_rewritten_count",
            "mcp_parity_passed",
            "live_mcp_tool_count"
          ],
          "properties": {
            "rule_verdict": {
              "type": "string"
            },
            "evaluated_rules": {
              "type": "integer",
              "minimum": 0
            },
            "passed_rules": {
              "type": "integer",
              "minimum": 0
            },
            "advisory_rules": {
              "type": "integer",
              "minimum": 0
            },
            "clean_cut_passed": {
              "type": "boolean"
            },
            "dirty_cut_blocked": {
              "type": "boolean"
            },
            "dirty_stamp_hit_count": {
              "type": "integer",
              "minimum": 0
            },
            "dirty_chip_hit_count": {
              "type": "integer",
              "minimum": 0
            },
            "caption_and_load_passed": {
              "type": "boolean"
            },
            "max_center_offset_px": {
              "type": "number",
              "minimum": 0
            },
            "max_observed_cps": {
              "type": "number",
              "minimum": 0
            },
            "mirror_all_resolved": {
              "type": "boolean"
            },
            "mirror_rewritten_count": {
              "type": "integer",
              "minimum": 0
            },
            "mcp_parity_passed": {
              "type": "boolean"
            },
            "live_mcp_tool_count": {
              "type": "integer",
              "minimum": 0
            }
          }
        },
        "example": {
          "rule_verdict": "pass",
          "evaluated_rules": 9,
          "passed_rules": 8,
          "advisory_rules": 1,
          "clean_cut_passed": true,
          "dirty_cut_blocked": true,
          "dirty_stamp_hit_count": 2,
          "dirty_chip_hit_count": 2,
          "caption_and_load_passed": true,
          "max_center_offset_px": 1.0,
          "max_observed_cps": 15.3333,
          "mirror_all_resolved": true,
          "mirror_rewritten_count": 3,
          "mcp_parity_passed": true,
          "live_mcp_tool_count": 4
        }
      }
    },
    {
      "slug": "example.film-surface-rules-bundle",
      "category": "noun.eval_run",
      "role": "example",
      "synthetic": true,
      "title": "Worked example input: synthetic film measurements, clean/dirty OCR spans, frosted-pill cues, dead URLs and llms.txt",
      "category_reason": "Synthetic fixture recomputed by test_film_surface_rules.py.",
      "value": {
        "bundle": {
          "hook_stage": "post",
          "rules": [
            {
              "id": "audio-clipping",
              "metric": "audio.true_peak_dbtp",
              "op": "<",
              "threshold": 0.0,
              "severity": "block",
              "hook": [
                "post"
              ]
            },
            {
              "id": "audio-silence",
              "metric": "audio.max_silence_s",
              "op": "<=",
              "threshold": 2.0,
              "severity": "warn",
              "hook": [
                "post"
              ]
            },
            {
              "id": "audio-music-bed",
              "metric": "audio.speech_over_bed_lu",
              "op": ">=",
              "threshold": 8.0,
              "severity": "warn",
              "hook": [
                "post"
              ]
            },
            {
              "id": "cap-center-x",
              "metric": "caption.center_offset_px",
              "op": "abs<=",
              "threshold": 2,
              "severity": "block",
              "hook": [
                "post"
              ]
            },
            {
              "id": "audio-loudness",
              "metric": "audio.integrated_lufs",
              "op": "in_range",
              "threshold": [
                -18,
                -13
              ],
              "severity": "warn",
              "hook": [
                "post"
              ]
            },
            {
              "id": "forbid-stamps",
              "metric": "ocr.forbidden_hits",
              "op": "empty",
              "threshold": null,
              "severity": "block",
              "hook": [
                "post"
              ]
            },
            {
              "id": "auth-address-bar",
              "metric": "browser.address_bar_visible",
              "op": "is_true",
              "threshold": null,
              "severity": "block",
              "hook": [
                "post"
              ]
            },
            {
              "id": "cap-gap-flicker",
              "metric": "caption.gap_flicker",
              "op": "is_false",
              "threshold": null,
              "severity": "warn",
              "hook": [
                "post"
              ]
            },
            {
              "id": "design-advisory",
              "metric": null,
              "op": null,
              "threshold": null,
              "severity": "info",
              "hook": [
                "post"
              ]
            }
          ],
          "measurements": {
            "audio": {
              "true_peak_dbtp": -1.3,
              "max_silence_s": 1.1,
              "speech_over_bed_lu": 9.8,
              "integrated_lufs": -15.6
            },
            "caption": {
              "center_offset_px": 1.0,
              "gap_flicker": false
            },
            "ocr": {
              "forbidden_hits": []
            },
            "browser": {
              "address_bar_visible": true
            }
          },
          "clean_cut_ocr": [
            {
              "t_s": 4.0,
              "text": "Spare tokens for good."
            },
            {
              "t_s": 18.0,
              "text": "Tell us what you need in plain words."
            }
          ],
          "clean_status_chips": [
            "ready",
            "verified"
          ],
          "dirty_cut_ocr": [
            {
              "t_s": 12.5,
              "text": "SYNTHETIC EXAMPLE - typed into the live box"
            },
            {
              "t_s": 126.0,
              "text": "ILLUSTRATION - feeds are planned, not running"
            }
          ],
          "dirty_status_chips": [
            "building",
            "simulated fallback"
          ],
          "cues": [
            {
              "start_s": 0.5,
              "end_s": 3.5,
              "text": "Nonprofits say what they need,\nin plain words.",
              "plate_center_x_px": 961.0,
              "plate_held_across_gap": true
            },
            {
              "start_s": 3.7,
              "end_s": 7.3,
              "text": "Authorized workers claim steps\nand check each receipt.",
              "plate_center_x_px": 959.5,
              "plate_held_across_gap": true
            }
          ],
          "ost_events": [
            {
              "start_s": 0.5,
              "end_s": 3.5,
              "text": "Nonprofits say what they need"
            }
          ],
          "dead_urls": [
            "https://localhost/org",
            "https://localhost/org/seed-packs-library-of-nouns-and-verbs/tree/main/packs/checks-of-checks",
            "https://localhost/org/public-good-marketplace/issues/new?template=request.yml"
          ],
          "mirror_manifest": {
            "repositories": [
              {
                "slug": "seed-packs",
                "repo_name": "seed-packs-library-of-nouns-and-verbs",
                "archive": "seed-packs-library-of-nouns-and-verbs.tar.gz",
                "readme": "seed-packs-README.md",
                "commit": "cdb6aa2fdee9e79cd183672a03e8f4006d49d89b",
                "tar_sha256": "548ef1209ab8c45678901234567890abcdef1234567890abcdef1234567890ab"
              },
              {
                "slug": "public-marketplace",
                "repo_name": "public-good-marketplace",
                "archive": "public-good-marketplace.tar.gz",
                "readme": "public-marketplace-README.md",
                "commit": "4f11d90aa11bb22cc33dd44ee55ff6677889900a",
                "tar_sha256": "99887766554433221100ffeeddccbbaa99887766554433221100ffeeddccbbaa"
              }
            ]
          },
          "llms_txt": "# Work Engine\nExposes 4 tools total:\n- `claim`\n- `complete`\n- `get_record`\n- `put_record`\n",
          "mcp_tools": [
            "claim",
            "complete",
            "get_record",
            "put_record"
          ],
          "has_simulated_fallback": false
        },
        "shows": "Synthetic film cut and surface readiness bundle exercising all 8 operators, stamp/chip blocking, frosted-pill caption load, /source/ mirror rewriting and MCP parity.",
        "source": "Synthetic. Written for this pack."
      }
    },
    {
      "slug": "example.film-surface-rules-receipt",
      "category": "noun.eval_run",
      "role": "example",
      "synthetic": true,
      "title": "Worked example output: recomputed film rule, stamp scan, caption load, mirror rewrite and MCP parity receipt",
      "category_reason": "Synthetic receipt verified by test_film_surface_rules.py.",
      "value": {
        "conforms_to": {
          "$pin": "template.film-surface-rules-receipt"
        },
        "instance": {
          "rule_verdict": "pass",
          "evaluated_rules": 9,
          "passed_rules": 8,
          "advisory_rules": 1,
          "clean_cut_passed": true,
          "dirty_cut_blocked": true,
          "dirty_stamp_hit_count": 2,
          "dirty_chip_hit_count": 2,
          "caption_and_load_passed": true,
          "max_center_offset_px": 1.0,
          "max_observed_cps": 15.3333,
          "mirror_all_resolved": true,
          "mirror_rewritten_count": 3,
          "mcp_parity_passed": true,
          "live_mcp_tool_count": 4
        },
        "shows": "Recomputes exact rule-noun pass counts, dirty fixture stamp/chip blocks, frosted-pill centering, 3 /source/ mirror rewrites and 4-tool MCP parity.",
        "source": "Synthetic. Recomputed directly from example.film-surface-rules-bundle."
      },
      "relations": [
        [
          "derives_from",
          "example.film-surface-rules-bundle"
        ],
        [
          "verifies",
          "template.film-surface-rules-receipt"
        ]
      ]
    }
  ],
  "verbs": [
    {
      "slug": "evaluate-film-rules-and-caption-load",
      "kind": "verb.verify_gate",
      "title": "Evaluate declarative film rule nouns, scan native OCR spans for forbidden stamps and score caption cognitive load",
      "claimant": "agent",
      "model_use": "none",
      "summary": "Run declarative rule nouns across 8 comparison operators, reject forbidden synthetic disclaimers at native resolution and verify frosted-pill centering and dual-channel reading rates.",
      "outcome": "Deterministic rule-noun, forbidden-stamp and caption cognitive-load metrics.",
      "ready_outcome": "film_rules_evaluated",
      "pinned": [
        "spec.declarative-film-and-surface-rules",
        "guardrail.honest-unknown-and-no-simulated-fallback",
        "tool.film-surface-rules"
      ],
      "slots": [
        {
          "name": "film_measurement_bundle",
          "category": "noun.eval_run",
          "description": "Pin of measured film loudness, OCR spans, caption plates and on-screen text intervals."
        }
      ],
      "produces": [
        {
          "name": "film_rule_receipt",
          "template": "template.film-surface-rules-receipt"
        }
      ],
      "steps": [
        "Evaluate declarative rule nouns with honest unknown propagation for absent metrics.",
        "Scan OCR spans for forbidden synthetic stamps and score frosted-pill centering, CPS and dual-channel word overlap."
      ],
      "acceptance": [
        {
          "id": "zero-block-and-stamp-free",
          "check": "All block-severity rules pass, forbidden stamp count is 0 and frosted-pill centering stays within tolerance.",
          "method": "deterministic"
        }
      ]
    },
    {
      "slug": "repoint-dead-links-and-check-mcp-parity",
      "kind": "verb.verify_gate",
      "title": "Rewrite dead external repository URLs to SHA-256-pinned /source/ mirror routes and verify /llms.txt MCP parity",
      "claimant": "agent",
      "model_use": "none",
      "summary": "Map dead external repository links to self-hosted /source/ mirror anchors, archives and live intake doors, and verify 1:1 tool parity between /llms.txt and MCP tools/list.",
      "outcome": "Deterministic /source/ mirror link mapping and /llms.txt MCP parity verdict.",
      "ready_outcome": "surface_links_and_mcp_checked",
      "pinned": [
        "rules.mirror-relink-and-mcp-parity",
        "guardrail.honest-unknown-and-no-simulated-fallback",
        "tool.film-surface-rules"
      ],
      "slots": [
        {
          "name": "surface_link_and_mcp_bundle",
          "category": "noun.eval_run",
          "description": "Pin of surface URLs, /source/ manifest.json and /llms.txt + MCP tools/list snapshot."
        }
      ],
      "produces": [
        {
          "name": "surface_parity_receipt",
          "template": "template.film-surface-rules-receipt"
        }
      ],
      "steps": [
        "Rewrite dead repository URLs to /source/ anchors/archives with commit and bundle SHA-256 prefixes.",
        "Verify every stated tool count and bulleted tool name in /llms.txt matches MCP tools/list with zero simulated fallback."
      ],
      "acceptance": [
        {
          "id": "mirror-resolved-and-mcp-parity",
          "check": "Unresolved link count is 0, MCP tool sets match 1:1 and simulated_fallback_detected is false.",
          "method": "deterministic"
        }
      ],
      "follows": [
        "film-and-surface-rule-evaluator.evaluate-film-rules-and-caption-load"
      ]
    },
    {
      "slug": "review-film-and-surface-readiness",
      "kind": "verb.verify_gate",
      "title": "Independently review film rule-noun, mirror-relink and MCP parity receipts before admission",
      "claimant": "agent",
      "model_use": "none",
      "summary": "Verify with a distinct reviewer that a candidate film cut and surface bundle pass all block rules, stamp bans, mirror rewrites and MCP parity checks.",
      "outcome": "Reviewed film and surface readiness receipt.",
      "ready_outcome": "readiness_reviewed",
      "review": "distinct_reviewer",
      "pinned": [
        "spec.declarative-film-and-surface-rules",
        "rules.mirror-relink-and-mcp-parity",
        "guardrail.distinct-reviewer-on-readiness",
        "tool.film-surface-rules",
        "template.film-surface-rules-receipt"
      ],
      "slots": [
        {
          "name": "candidate_readiness_bundle",
          "category": "noun.eval_run",
          "description": "Pin of recomputed film and surface evaluation bundle."
        }
      ],
      "produces": [
        {
          "name": "reviewed_readiness_receipt",
          "template": "template.film-surface-rules-receipt"
        }
      ],
      "steps": [
        "Recompute run_worked_example deterministically and confirm zero block failures and zero unresolved links.",
        "Confirm reviewer worker_id and key_id differ from the producer."
      ],
      "acceptance": [
        {
          "id": "independent-readiness-signoff",
          "check": "Recomputed receipt matches expected schema and passes under a distinct reviewer.",
          "method": "deterministic"
        }
      ],
      "follows": [
        "film-and-surface-rule-evaluator.repoint-dead-links-and-check-mcp-parity"
      ]
    }
  ]
}