{
  "schemaVersion": 1,
  "id": "conceptual-tutorial",
  "title": "NovusLens: the core concepts",
  "audience": "Business sponsors, executives, team owners and readers new to the Concepts documentation",
  "maxDurationSeconds": 420,
  "sourceRevision": "fa10e3244fc708b82d6d60a407a41dae14b3ef24",
  "contentSha256": "9e556876a1f2d696fc571eec2d7c8678c130c85056e675c854fadc3c600695b8",
  "sourcePages": [
    {
      "path": "apps/docs/content/concepts/activity-log.mdx",
      "sha256": "6773b7feabbaf372fc169bfe580f44ad8906726ec0c698f8671ca98dec1a963c",
      "scenes": [
        "s12"
      ]
    },
    {
      "path": "apps/docs/content/concepts/agentic-accountability.mdx",
      "sha256": "0a5f6117c683981a02ebb8ec6f35e15c2fcb4fc1d814b027bd029c0e245839ee",
      "scenes": [
        "s09",
        "s10",
        "s13"
      ]
    },
    {
      "path": "apps/docs/content/concepts/car.mdx",
      "sha256": "e1174e965720bde70d21cb45df98fb8e498584daa6b247d3b91ef1c10c6dcf9f",
      "scenes": [
        "s01",
        "s05",
        "s06",
        "s07",
        "s13"
      ]
    },
    {
      "path": "apps/docs/content/concepts/cpl.mdx",
      "sha256": "0265043385d7901649bb7a45862819da192959c09a7d18a97c778f8f9c7412e4",
      "scenes": [
        "s08",
        "s13"
      ]
    },
    {
      "path": "apps/docs/content/concepts/epistemics.mdx",
      "sha256": "39f91c6700a1f6f19d53d72d8b8bb6c4efd947a7b2b72baf3cd41a4a5e12b665",
      "scenes": [
        "s00",
        "s01",
        "s13"
      ]
    },
    {
      "path": "apps/docs/content/concepts/evidence-ladder.mdx",
      "sha256": "4213a601a61c2ca7b753b2887e69e080cd00e69ac5e488ae9611d443c515a2df",
      "scenes": [
        "s02"
      ]
    },
    {
      "path": "apps/docs/content/concepts/federation.mdx",
      "sha256": "c92280b33c3e8c33e93f4e44a16b7cf70949022f97b58fc6607313f6926a6b33",
      "scenes": [
        "s11"
      ]
    },
    {
      "path": "apps/docs/content/concepts/findings.mdx",
      "sha256": "c0d9e944195348ea37467c16fcbee08e71dae09e234c1101dd4654ae1b93e3d1",
      "scenes": [
        "s04",
        "s13"
      ]
    },
    {
      "path": "apps/docs/content/concepts/index.mdx",
      "sha256": "3b05834835b9968b70fe0dad4b58d7e111f1dd9f91c43e66421fb7047fd1da25",
      "scenes": [
        "s00",
        "s13"
      ]
    },
    {
      "path": "apps/docs/content/concepts/layer-boundary.mdx",
      "sha256": "7df6b77f8ecf57aed2a1ece3142943ba0c62715972e1772483277eb988fa283f",
      "scenes": [
        "s10"
      ]
    },
    {
      "path": "apps/docs/content/concepts/meaning.mdx",
      "sha256": "fced10de15097ef6a5d6c870293d4d467f7fc19963777d3110baa3f7347cd516",
      "scenes": [
        "s04"
      ]
    },
    {
      "path": "apps/docs/content/concepts/organisation-model.mdx",
      "sha256": "b5e9010ad8107131077bf37b979bb80bd076da188df482936abf75d34ce0b8d7",
      "scenes": [
        "s03",
        "s13"
      ]
    },
    {
      "path": "apps/docs/content/concepts/privacy-floor.mdx",
      "sha256": "12f59c1632862661a5761887763e13d85ce9ca31a6addcbe7149510ae7c13dd7",
      "scenes": [
        "s12"
      ]
    }
  ],
  "diagrams": [],
  "scenes": [
    {
      "id": "s00",
      "chapter": "1 · What the evidence supports",
      "sourcePages": [
        "apps/docs/content/concepts/index.mdx",
        "apps/docs/content/concepts/epistemics.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s01",
      "chapter": "1 · What the evidence supports",
      "sourcePages": [
        "apps/docs/content/concepts/epistemics.mdx",
        "apps/docs/content/concepts/car.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s02",
      "chapter": "1 · What the evidence supports",
      "sourcePages": [
        "apps/docs/content/concepts/evidence-ladder.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s03",
      "chapter": "2 · The organisation model",
      "sourcePages": [
        "apps/docs/content/concepts/organisation-model.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s04",
      "chapter": "2 · The organisation model",
      "sourcePages": [
        "apps/docs/content/concepts/meaning.mdx",
        "apps/docs/content/concepts/findings.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s05",
      "chapter": "3 · The measures",
      "sourcePages": [
        "apps/docs/content/concepts/car.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s06",
      "chapter": "3 · The measures",
      "sourcePages": [
        "apps/docs/content/concepts/car.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s07",
      "chapter": "3 · The measures",
      "sourcePages": [
        "apps/docs/content/concepts/car.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s08",
      "chapter": "3 · The measures",
      "sourcePages": [
        "apps/docs/content/concepts/cpl.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s09",
      "chapter": "4 · Accountability and the boundary",
      "sourcePages": [
        "apps/docs/content/concepts/agentic-accountability.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s10",
      "chapter": "4 · Accountability and the boundary",
      "sourcePages": [
        "apps/docs/content/concepts/agentic-accountability.mdx",
        "apps/docs/content/concepts/layer-boundary.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s11",
      "chapter": "5 · Where to read next",
      "sourcePages": [
        "apps/docs/content/concepts/federation.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s12",
      "chapter": "5 · Where to read next",
      "sourcePages": [
        "apps/docs/content/concepts/activity-log.mdx",
        "apps/docs/content/concepts/privacy-floor.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s13",
      "chapter": "5 · Where to read next",
      "sourcePages": [
        "apps/docs/content/concepts/index.mdx",
        "apps/docs/content/concepts/car.mdx",
        "apps/docs/content/concepts/cpl.mdx",
        "apps/docs/content/concepts/organisation-model.mdx",
        "apps/docs/content/concepts/agentic-accountability.mdx",
        "apps/docs/content/concepts/findings.mdx",
        "apps/docs/content/concepts/epistemics.mdx"
      ],
      "diagram": null
    }
  ],
  "visualAssets": {
    "style": "Novus navy, paper, blue; original decorative SVG shapes and gradients; docs diagram-design figures",
    "photography": "none",
    "fonts": [
      "Source Sans 3",
      "Source Serif 4"
    ],
    "diagramSkill": ".claude/skills/diagram-design/SKILL.md"
  },
  "generation": {
    "referenceProject": "Novus-i2/novus-video",
    "renderer": "scripts/docs-videos/video.mjs + apps/docs/videos/shared/film.js",
    "frame": {
      "width": 1920,
      "height": 1080,
      "fps": 30
    },
    "voiceDefault": {
      "provider": "openrouter",
      "model": "heygen/heygen-voice-1",
      "voice": "tabitha",
      "responseFormat": "pcm",
      "pcmEncoding": "s16le",
      "sampleRate": 44100,
      "channels": 1,
      "mp3Bitrate": "192k",
      "pronunciation": "Replace NovusLens with Novus Lens before speech synthesis",
      "maxInputCharacters": 5000,
      "timing": "Whisper word timestamps"
    },
    "captions": "burned-in phrase captions plus captions.vtt",
    "commands": {
      "refresh": "node scripts/docs-videos/video.mjs manifest conceptual-tutorial --provider openrouter",
      "regenerate": "node scripts/docs-videos/video.mjs voice conceptual-tutorial --provider openrouter; node scripts/docs-videos/video.mjs timeline conceptual-tutorial; node scripts/docs-videos/video.mjs stills conceptual-tutorial; node scripts/docs-videos/video.mjs render conceptual-tutorial"
    }
  },
  "build": {
    "durationSeconds": 362.034,
    "voice": {
      "provider": "openrouter",
      "model": "heygen/heygen-voice-1",
      "voice": "tabitha",
      "responseFormat": "pcm",
      "pcmEncoding": "s16le",
      "sampleRate": 44100,
      "channels": 1,
      "mp3Bitrate": "192k",
      "pronunciation": "Replace NovusLens with Novus Lens before speech synthesis",
      "maxInputCharacters": 5000,
      "timing": "Whisper word timestamps"
    },
    "captionTiming": "Whisper word timestamps",
    "mp4": "out/conceptual-tutorial.mp4",
    "mp4Sha256": "635b0d0b40adb67fd0150902cb2ba7f32f20e00843a25846446255ab7e13d5b0",
    "timelineSha256": "cf2c001750ad5c0525476c52c5779b6cb56bc06c26e50788671e1265dd172e0a",
    "rendererSha256": "ca7053a7b3b6b41b6563159fecbb528d3a06529bd915230d18a72944740a0435",
    "slidesSha256": "78130b1609f8f1db3d562c98ec917e2ec215adc4206b9e07f824dd8ef00f759c",
    "filmSha256": "12816c4f493a8ce0b2f17ec8c1fb8168b25e76f5ea70a1dd0667dc0d9ad12972",
    "mastering": {
      "profile": "aac-final-headroom-v1",
      "gainDb": -1.5,
      "inputSha256": "81ef061b1fff18244e15f06ffc96552a71e188c44a7b96c47d75296cb4e475ca",
      "outputSha256": "5a89686efd146097a043f9771df9a11eccf3fbffea6a7ce9a66898256608a6d8",
      "helperSha256": "0d4eb99d43aff2dd3eab7209d646c494dfb0df424c55257b27c55bc06d2a39d4"
    },
    "brandFront": {
      "profile": "novus-photo-front-v1",
      "title": "NovusLens: the core concepts",
      "duration": 3.5,
      "inputs": [
        {
          "path": "scripts/docs-videos/brand-front.mjs",
          "sha256": "acc34d1610f2713b78e0d9f806279bf200b4032b5a46b1afd391a159335b5d29"
        },
        {
          "path": "scripts/docs-videos/brand-front-proof.mjs",
          "sha256": "7709d323fb9201b870ee8a6fa80f1b00be4c7f25b7851d3db49be667d4d64013"
        },
        {
          "path": "scripts/docs-videos/architecture-slides.mjs",
          "sha256": "35a1c0cb43fee298692be1f0addf286ce7cda4ac6d28052d568056ffe9e0b509"
        },
        {
          "path": "apps/docs/videos/architectural-overview/assets/u-MQctADD-Ctg.jpg",
          "sha256": "7d838e5026c49eeac68725522f1826530c81bdc8b7c2dbf5bb9edd260dcddc38"
        },
        {
          "path": "apps/docs/videos/shared/fonts/SourceSans3-Regular.otf",
          "sha256": "08df266400933d3178d081a45f94a08814c3e55b4b7dd2e0ff69cb1329f13ab6"
        },
        {
          "path": "apps/docs/videos/shared/fonts/SourceSans3-Semibold.otf",
          "sha256": "36f1cd2c344aa3109e64429bce41a41e4b2b923beb2db19b8dbf9bb56f05a4f9"
        }
      ],
      "inputSha256": "5a89686efd146097a043f9771df9a11eccf3fbffea6a7ce9a66898256608a6d8",
      "outputSha256": "635b0d0b40adb67fd0150902cb2ba7f32f20e00843a25846446255ab7e13d5b0",
      "audioSha256": "SHA256=ea3c451906edc242cf47ab4b239c871d78c9093da7dc51fcd7ca6b9b3eff52f5",
      "outputAudioSha256": "SHA256=ea3c451906edc242cf47ab4b239c871d78c9093da7dc51fcd7ca6b9b3eff52f5",
      "poster": {
        "path": "apps/docs/videos/conceptual-tutorial/out/brand-poster.png",
        "sha256": "cf30c8125986060538b5b672fd69c8de24cc1553e8be0ee0a3368d8e4267ad8f",
        "time": 0.5
      }
    }
  },
  "sourceReviews": [
    {
      "path": "apps/docs/content/concepts/organisation-model.mdx",
      "previousSha256": "848801dd838a954ceb66f58b4d3afe320eef466d704f3aa527e2f1532b244d40",
      "sha256": "84eaad1034a61378a080a87ca3f30786274a5bcf04b4a6cf33fefc70019611b2",
      "checkedSceneIds": [
        "s03",
        "s13"
      ],
      "authoredBodyUnchanged": false,
      "reviewedAt": "2026-10-19T17:01:05.638Z",
      "frameworkIntegrity": {
        "status": "pass",
        "finding": "Compared actual frozen MDX against the source snapshot that matches each selected manifest. All changed authored bodies are identical after excluding frontmatter, docs-map comments and SourceFiles appendices, except the incoming Concepts organisation-model page. That page adds the existing Docker/version context and explicit launcher version flag; s03/s13 narrate model and evidence concepts, not those commands. Advisory boundaries, evidence, scope, units, ownership and recovery claims remain unchanged."
      },
      "audienceReadability": {
        "status": "pass",
        "finding": "Reviewed source migration hunks separately for audience meaning. Moving code/wiki citations into YAML and removing appendices does not alter the spoken explanation, commands or visuals. Read the complete organisation-model page and all 14 incoming Concepts narrations; its model and reading pointers remain accurate with the added operational context. Existing selected scene and delivery reviews remain bound to their unchanged content and media."
      },
      "mediaChangeRequired": false,
      "reviewReport": "out/issue41-pr46-merge-source-review.json"
    },
    {
      "kind": "source-only-semantic-review",
      "reviewedAt": "2026-10-20T08:24:13Z",
      "reviewRevision": "732e38847a8bd58557a1a3f2c061241b5183ceec",
      "contentSha256": "9e556876a1f2d696fc571eec2d7c8678c130c85056e675c854fadc3c600695b8",
      "checkedSceneIds": [
        "s03",
        "s13"
      ],
      "sourceChanges": [
        {
          "path": "apps/docs/content/concepts/organisation-model.mdx",
          "previousSha256": "84eaad1034a61378a080a87ca3f30786274a5bcf04b4a6cf33fefc70019611b2",
          "sha256": "08f54a944980c48e2e8279c3ae641ed59902b60b93fa1e6d7b9aed9c22b5ad51",
          "scenes": [
            "s03",
            "s13"
          ]
        }
      ],
      "frameworkIntegrity": {
        "status": "pass",
        "finding": "The changed organisation-model source adds lens command wrappers and preserves the organisation, ownership, dependency and evidence semantics narrated in s03 and revisited in s13. No framework or epistemic claim changed."
      },
      "audienceReadability": {
        "status": "pass",
        "finding": "Reviewed s03 and s13 narration and slides. They explain the model and direct viewers to relevant Concepts pages; neither quotes a command or depends on the revised command syntax. Visuals remain accurate."
      },
      "mediaDisposition": "Preserve current narration, slides, manifest build provenance, media hashes and delivery evidence. No TTS, rendering, playback or listening was performed for this source-only review.",
      "limits": [
        "Reviewed changed cited MDX diffs and every affected authored scene and visual; unchanged source pages were not re-reviewed.",
        "Hash values identify current uncommitted working-tree bytes; sourceRevision remains the original manifest provenance.",
        "This review does not establish current lens command execution, playback, audio quality or delivery validity."
      ]
    },
    {
      "reviewed": "2026-10-23",
      "sourceSnapshot": "#126 replaced the launcher command for connector runs with ./lens connectors and removed the NOVUSLENS_VERSION/NOVUSLENS_ENV selection lines; the cell, ownership, dependency and domain definitions are unchanged. Exact reviewed source hashes below.",
      "checkedSceneIds": [
        "s03",
        "s13"
      ],
      "sources": [
        {
          "path": "apps/docs/content/concepts/organisation-model.mdx",
          "sha256": "b5e9010ad8107131077bf37b979bb80bd076da188df482936abf75d34ce0b8d7",
          "scenes": [
            "s03",
            "s13"
          ],
          "previousSha256": "08f54a944980c48e2e8279c3ae641ed59902b60b93fa1e6d7b9aed9c22b5ad51"
        }
      ],
      "frameworkIntegrity": {
        "status": "pass",
        "finding": "s03 and s13 describe cells, ownership, dependencies, domains and where to read next. None depends on the installation route. Advisory role and Capability, Authority and Responsibility wording unaffected."
      },
      "audienceReadability": {
        "status": "pass",
        "finding": "No narration or slide wording names the changed lines; both scenes remain accurate and plain for the business audience."
      },
      "result": "Source-only review. Narration, slides, captions, timeline, encoded media and existing delivery evidence remain unchanged.",
      "preserved": {
        "contentSha256": "9e556876a1f2d696fc571eec2d7c8678c130c85056e675c854fadc3c600695b8",
        "mp4Sha256": "635b0d0b40adb67fd0150902cb2ba7f32f20e00843a25846446255ab7e13d5b0",
        "buildUnchanged": true
      },
      "limits": [
        "No new encoding, playback or human voice listening. Existing unchanged media evidence is retained."
      ]
    },
    {
      "reviewed": "2026-10-23",
      "sourceSnapshot": "evidence-ladder.mdx: the observation-window sentence now links to the environment variable reference (Connectors), because #126 removed the Retention heading from operating/configuration. No other text changed. Exact reviewed source hashes below.",
      "checkedSceneIds": [
        "s02"
      ],
      "sources": [
        {
          "path": "apps/docs/content/concepts/evidence-ladder.mdx",
          "sha256": "c5a9ac2aa4211356d71afae2aaaca03e71ffb1ac2e8ddeff318c714785963489",
          "scenes": [
            "s02"
          ],
          "previousSha256": "66eac76e5dda96c1f92aa8cb4909a0fe844398cc7ed9bf94223dc7645c66c702"
        }
      ],
      "frameworkIntegrity": {
        "status": "pass",
        "finding": "No scene narration, slide or command mentions CONWAY_OBSERVATION_TTL_DAYS or the configuration page. The evidence labels and the observation window are unchanged, so every citing scene stays true."
      },
      "audienceReadability": {
        "status": "pass",
        "finding": "No narration or visual changes; the change is a link target that the film does not show."
      },
      "result": "Source-only review. Narration, slides, captions, timeline, encoded media and existing delivery evidence remain unchanged.",
      "preserved": {
        "contentSha256": "9e556876a1f2d696fc571eec2d7c8678c130c85056e675c854fadc3c600695b8",
        "mp4Sha256": "635b0d0b40adb67fd0150902cb2ba7f32f20e00843a25846446255ab7e13d5b0",
        "buildUnchanged": true
      },
      "limits": [
        "No new encoding, playback or human voice listening. Existing unchanged media evidence is retained."
      ]
    },
    {
      "reviewed": "2026-10-23",
      "sourceSnapshot": "evidence-ladder.mdx: the observation-window sentence now links to setup's advanced settings and names CONWAY_OBSERVATION_TTL_DAYS as the saved line, because #135 makes the window a setup answer. The 30-day default is unchanged. Exact reviewed source hashes below. Exact reviewed source hashes below.",
      "checkedSceneIds": [
        "s02"
      ],
      "sources": [
        {
          "path": "apps/docs/content/concepts/evidence-ladder.mdx",
          "sha256": "4213a601a61c2ca7b753b2887e69e080cd00e69ac5e488ae9611d443c515a2df",
          "scenes": [
            "s02"
          ],
          "previousSha256": "c5a9ac2aa4211356d71afae2aaaca03e71ffb1ac2e8ddeff318c714785963489"
        }
      ],
      "frameworkIntegrity": {
        "status": "pass",
        "finding": "No citing scene mentions the observation window, a setting or CONWAY_OBSERVATION_TTL_DAYS. The evidence labels and the 30-day default are unchanged, so every citing scene stays true."
      },
      "audienceReadability": {
        "status": "pass",
        "finding": "No narration or visual changes; the change is a link target that the film does not show."
      },
      "result": "Source-only review. Narration, slides, captions, timeline, encoded media and existing delivery evidence remain unchanged.",
      "preserved": {
        "contentSha256": "9e556876a1f2d696fc571eec2d7c8678c130c85056e675c854fadc3c600695b8",
        "mp4Sha256": "635b0d0b40adb67fd0150902cb2ba7f32f20e00843a25846446255ab7e13d5b0",
        "buildUnchanged": true
      },
      "limits": [
        "No new encoding, playback or human voice listening. Existing unchanged media evidence is retained."
      ]
    }
  ]
}