# LAKA Volumetric Media Grammar

> A tool-agnostic, machine-readable production grammar for podcast and video work: transcript intelligence, clip mining, narrative construction, camera, lighting, generation, editing, graphics, sound, finishing, delivery and QA — expressed as typed dimensions and declarative IF/THEN production rules.

Version 1.0.0. 196 production rules (100 hard, 96 soft) across 14 domains; 989 enumerated states in 62 dimensions plus 38 continuous dimensions; 12 JSON Schemas; 22 documentation chapters; a complete fictional worked example.

Boundaries: A specification and reference set with a reference rule engine — not an editing application, a rendering pipeline, or a completed production. The worked example is entirely fictional and exists to demonstrate the method.

## API
Base URL: https://video.bowtiekreative.com
OpenAPI: https://video.bowtiekreative.com/v1/openapi.json
Index: https://video.bowtiekreative.com/v1

Read:
- https://video.bowtiekreative.com/v1 — This index
- https://video.bowtiekreative.com/v1/health — Liveness and corpus counts
- https://video.bowtiekreative.com/v1/openapi.json — OpenAPI 3.1 description of this API
- https://video.bowtiekreative.com/v1/manifest — Package manifest and inventory
- https://video.bowtiekreative.com/v1/model — The volumetric model: change levels, meta-variables, decision variables, operators
- https://video.bowtiekreative.com/v1/dimensions — All 62 enumerated (989 states) and 38 continuous dimensions — filter by group or kind
- https://video.bowtiekreative.com/v1/dimensions/{id} — One dimension with its full state list, e.g. shot_sizes
- https://video.bowtiekreative.com/v1/rules — The 196 production rules — filter by category, type (hard/soft), min_priority or q
- https://video.bowtiekreative.com/v1/rules/{id} — One production rule, in full, e.g. TXT-001
- https://video.bowtiekreative.com/v1/schemas — The twelve JSON Schemas
- https://video.bowtiekreative.com/v1/schemas/{name} — One schema, e.g. clip
- https://video.bowtiekreative.com/v1/example — The fictional worked example — stage list
- https://video.bowtiekreative.com/v1/example/{stage} — One example stage, e.g. clips or rule-evaluation
- https://video.bowtiekreative.com/v1/docs — The 22 documentation chapters
- https://video.bowtiekreative.com/v1/docs/{slug} — One chapter, as markdown
- https://video.bowtiekreative.com/v1/sources — The primary source register

Act:
- POST https://video.bowtiekreative.com/v1/evaluate — run the production-rule engine on a submitted {"context": {...}}. Returns triggered rules with hard/soft classification, priorities, rationales, the accumulated state and the block decision.
- POST https://video.bowtiekreative.com/v1/validate — check a {"schema": name, "document": {...}} pair against one of the 12 packaged JSON Schemas. Structural validity only.

## Pages
- https://video.bowtiekreative.com/model — The volumetric model: Five change levels, 14 measurement lenses, the media unit
- https://video.bowtiekreative.com/dimensions — Dimensions: 989 enumerated states, 38 continuous dimensions
- https://video.bowtiekreative.com/quickref — Quick reference: The whole grammar on one page
- https://video.bowtiekreative.com/rules — Production rules: All 196 IF/THEN rules, browsable
- https://video.bowtiekreative.com/schemas — JSON Schemas: 12 document schemas, with a public validator
- https://video.bowtiekreative.com/example — Worked example: Transcript → claims → clips → shots → edit → QA (fictional)
- https://video.bowtiekreative.com/chapters — All 22 chapters: First principles through glossary
- https://video.bowtiekreative.com/chapters/story-narrative-grammar — Story & narrative: Promises, payoffs, open loops and tension
- https://video.bowtiekreative.com/chapters/editing-cut-grammar — Editing & cuts: Cut types, motivations and transitions
- https://video.bowtiekreative.com/api — API reference: Every endpoint, with examples
- https://video.bowtiekreative.com/sources — Sources & boundaries: 12 primary sources, scope limits

## Usage note
Hard rules protect meaning, rights, continuity, loudness and accessibility — when one matches, the pipeline blocks until the condition is repaired or a human accepts the risk. Soft rules flag and propose. The grammar is tool-agnostic and the worked example is entirely fictional; the value is the method, not the material.