{
  "schemaVersion": 1,
  "id": "user-guide",
  "title": "Using NovusLens",
  "audience": "People reading organisational records and taking evidence to a management discussion",
  "maxDurationSeconds": 1800,
  "sourceRevision": "fa10e3244fc708b82d6d60a407a41dae14b3ef24",
  "contentSha256": "7597bf1aa070a937d45e718d5b37050b61cda171cfd2be59515823b73899acab",
  "sourcePages": [
    {
      "path": "apps/docs/content/manuals/user-manual.mdx",
      "sha256": "6a382d3de554d04cc0bc2d16b21b46b6cc6ebd301a77e9fb6f63f61e32e252b8",
      "scenes": [
        "s00",
        "s01",
        "s02",
        "s03",
        "s04",
        "s05",
        "s06",
        "s07",
        "s08",
        "s09",
        "s10",
        "s11",
        "s12",
        "s13",
        "s14",
        "s15",
        "s16",
        "s17"
      ]
    },
    {
      "path": "apps/docs/content/using/accountability.mdx",
      "sha256": "d98e4d8e1667da5346d22ffc3a7376b0a6bf82c707154e9d62ae84f02709889a",
      "scenes": [
        "s10"
      ]
    },
    {
      "path": "apps/docs/content/using/activity-log.mdx",
      "sha256": "b85e8aab061effd3aa16b429ffc1c73581c1d96b582692a80f28414baf2f828b",
      "scenes": [
        "s16"
      ]
    },
    {
      "path": "apps/docs/content/using/ai-agents.mdx",
      "sha256": "c229b1ff19598730d14dcf1a01b881678b66b84ee2d4f76ca3a3d7c76de66f2e",
      "scenes": [
        "s11",
        "s12"
      ]
    },
    {
      "path": "apps/docs/content/using/ask-and-answers.mdx",
      "sha256": "5f5d44b6e14f09a79859d09d36ed9796c6ce34dee8457ce59bd43ab69fdf68ac",
      "scenes": [
        "s14",
        "s15"
      ]
    },
    {
      "path": "apps/docs/content/using/brief.mdx",
      "sha256": "cd1a63ed78fec268683987a52ef9c079ea6d491fb18cbe0bc1090516999b8663",
      "scenes": [
        "s17"
      ]
    },
    {
      "path": "apps/docs/content/using/car.mdx",
      "sha256": "e7cc17c328a0612dea71ce9edfbc27a61e39637ae025e0a4ebdaae368712d7c1",
      "scenes": [
        "s05",
        "s06"
      ]
    },
    {
      "path": "apps/docs/content/using/evidence-and-proof.mdx",
      "sha256": "fb7fa409123ef99d15e21e038e7e397dc058eccf923dfe9b7b45c168230c3a01",
      "scenes": [
        "s03",
        "s04",
        "s05"
      ]
    },
    {
      "path": "apps/docs/content/using/guide-and-help.mdx",
      "sha256": "b010a814d23cad5126bd87a8fcc37f449ebf2d7fa71f068625562edef2c6576c",
      "scenes": [
        "s13"
      ]
    },
    {
      "path": "apps/docs/content/using/index.mdx",
      "sha256": "f66b87290c836862d92dbd3190cca3d95600957a1c1dfb7e20b7f05eb931c2a6",
      "scenes": [
        "s01"
      ]
    },
    {
      "path": "apps/docs/content/using/knowledge.mdx",
      "sha256": "738ac9c2319ebe14942ca2369e9b7ccd89be2d89403306bcad12f8c669c7489a",
      "scenes": [
        "s16"
      ]
    },
    {
      "path": "apps/docs/content/using/map.mdx",
      "sha256": "4cec65c29fbb502191350700cb1f487c82f97ef3c7f0bebab015f7635b310056",
      "scenes": [
        "s04",
        "s07",
        "s08",
        "s09"
      ]
    },
    {
      "path": "apps/docs/content/using/overview.mdx",
      "sha256": "577b296785b35bc1857942ef6c1bf3c74562cc81661c01db99668080109262e1",
      "scenes": [
        "s01",
        "s02"
      ]
    },
    {
      "path": "apps/docs/content/using/sign-in-and-twins.mdx",
      "sha256": "a0212aa4b5ec76be28ebfc1d70b356459e0d8a79e0863ad39e6d92a1dc56f66f",
      "scenes": [
        "s00",
        "s17"
      ]
    },
    {
      "path": "apps/docs/content/using/status-and-states.mdx",
      "sha256": "e692251f46ee1f4bae2bc8185b73c88ec5ff953f37ee1c2bb43163b43b931b38",
      "scenes": [
        "s08"
      ]
    }
  ],
  "diagrams": [],
  "screenshots": [
    {
      "path": "apps/docs/public/manuals/screenshots/accountability.png",
      "sha256": "226e34450c8a65f5ce2a642597b23ac9b54974c93079bd78e000cfbe4110216b",
      "scenes": [
        "s10"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/ai-agents.png",
      "sha256": "52a75f5bb9398eef267a4d42ec5604b40745d6db467fd2da56ec21a0d56c3ccf",
      "scenes": [
        "s11"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/ask-answer.png",
      "sha256": "336d0332f992ed1f797f660068e4e737d163455a9f6c1428ace94a73916c7aff",
      "scenes": [
        "s14"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/brief.png",
      "sha256": "17bb6fd8932dac962dbae6b3d99498e8824842d425167564303101e437146f3a",
      "scenes": [
        "s17"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/car.png",
      "sha256": "11a391d3cb818710886b95b65e968d8a6f0724489c4ebc4ef44b197aa964b359",
      "scenes": [
        "s06"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/help-drawer.png",
      "sha256": "b96eed68c62c5cd27c60ed401a53539f968dbacb21cadea04221367c6193e071",
      "scenes": [
        "s13"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/knowledge.png",
      "sha256": "b7faaecb853335d21786869696ff02d8fde54299de3f9215892a1876a4a75f48",
      "scenes": [
        "s16"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/login.png",
      "sha256": "14cb1a29a25a7d202c47838ec69c93e5f687dd7178aeee600f62281cfeb023fd",
      "scenes": [
        "s00"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/map-organisation.png",
      "sha256": "fe29aaf4ce08fc08986e1f2c1c3a1d81d2dad27a73f194bae7c0c5be58cb9b73",
      "scenes": [
        "s07",
        "s09"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/map-team-evidence.png",
      "sha256": "dbc2441de42e0985ee614a0ea76c1df3d001f5354173129bb1bba23d00a825dd",
      "scenes": [
        "s03",
        "s04"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/map-team-findings.png",
      "sha256": "4feefbe34f156da6193f3ffae703548a264281b5fdc4ddddd4d6333e25226398",
      "scenes": [
        "s08"
      ]
    },
    {
      "path": "apps/docs/public/manuals/screenshots/overview.png",
      "sha256": "f017a4233933de06feee68ff38195f25c1a2014c1fcb9014132b2fbbd80e660a",
      "scenes": [
        "s01",
        "s02"
      ]
    },
    {
      "path": "apps/docs/public/screenshots/ai-agents-remit.png",
      "sha256": "5896230e23031a417c08868520119797926bb9a49139e8c0cd7dad45152f5846",
      "scenes": [
        "s12"
      ]
    },
    {
      "path": "apps/docs/public/screenshots/ask-change.png",
      "sha256": "d93063ae8c0bb4c521273ff52ab430a11ece52cf0b47da1da7840c1f4f164f07",
      "scenes": [
        "s15"
      ]
    },
    {
      "path": "apps/docs/public/screenshots/map-team-summary.png",
      "sha256": "f0cb42b28fda2e7b80d05c2bbd815394cc9609b8c0fbcb5062ee8bf887cc1836",
      "scenes": [
        "s05"
      ]
    }
  ],
  "scenes": [
    {
      "id": "s00",
      "chapter": "Start with one issue",
      "sourcePages": [
        "apps/docs/content/using/sign-in-and-twins.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s01",
      "chapter": "Start with one issue",
      "sourcePages": [
        "apps/docs/content/using/index.mdx",
        "apps/docs/content/using/overview.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s02",
      "chapter": "Start with one issue",
      "sourcePages": [
        "apps/docs/content/using/overview.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s03",
      "chapter": "Check evidence and scores",
      "sourcePages": [
        "apps/docs/content/using/evidence-and-proof.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s04",
      "chapter": "Check evidence and scores",
      "sourcePages": [
        "apps/docs/content/using/evidence-and-proof.mdx",
        "apps/docs/content/using/map.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s05",
      "chapter": "Check evidence and scores",
      "sourcePages": [
        "apps/docs/content/using/car.mdx",
        "apps/docs/content/using/evidence-and-proof.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s06",
      "chapter": "Check evidence and scores",
      "sourcePages": [
        "apps/docs/content/using/car.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s07",
      "chapter": "Explore the organisation map",
      "sourcePages": [
        "apps/docs/content/using/map.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s08",
      "chapter": "Explore the organisation map",
      "sourcePages": [
        "apps/docs/content/using/map.mdx",
        "apps/docs/content/using/status-and-states.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s09",
      "chapter": "Explore the organisation map",
      "sourcePages": [
        "apps/docs/content/using/map.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s10",
      "chapter": "Find accountability",
      "sourcePages": [
        "apps/docs/content/using/accountability.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s11",
      "chapter": "Find accountability",
      "sourcePages": [
        "apps/docs/content/using/ai-agents.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s12",
      "chapter": "Find accountability",
      "sourcePages": [
        "apps/docs/content/using/ai-agents.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s13",
      "chapter": "Ask and explore a change",
      "sourcePages": [
        "apps/docs/content/using/guide-and-help.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s14",
      "chapter": "Ask and explore a change",
      "sourcePages": [
        "apps/docs/content/using/ask-and-answers.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s15",
      "chapter": "Ask and explore a change",
      "sourcePages": [
        "apps/docs/content/using/ask-and-answers.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s16",
      "chapter": "Records and a management brief",
      "sourcePages": [
        "apps/docs/content/using/knowledge.mdx",
        "apps/docs/content/using/activity-log.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    },
    {
      "id": "s17",
      "chapter": "Records and a management brief",
      "sourcePages": [
        "apps/docs/content/using/brief.mdx",
        "apps/docs/content/using/sign-in-and-twins.mdx",
        "apps/docs/content/manuals/user-manual.mdx"
      ],
      "diagram": null
    }
  ],
  "visualAssets": {
    "style": "Novus navy, paper and blue; product screenshots with authored action lines; Docker command screens",
    "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/tutorial.mjs + screenshot-slides.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/tutorial.mjs manifest user-guide --provider openrouter",
      "regenerate": "node scripts/docs-videos/tutorial.mjs voice user-guide --provider openrouter; node scripts/docs-videos/tutorial.mjs timeline user-guide; node scripts/docs-videos/tutorial.mjs stills user-guide; node scripts/docs-videos/tutorial.mjs render user-guide"
    }
  },
  "sourceReviews": [
    {
      "reviewedAt": "2026-10-15T14:37:24.049Z",
      "reviewRevision": "ded32e5bbac17f4558ccd78c849f3888fc04a479",
      "mergedRevision": "0c36e3ca9ff59b5a0eb5880aa8a3279accf119b0",
      "contentSha256": "115250e6988ccf7ad7c60061afda7cfb40ffaf10938b18545cc087605dba04c3",
      "checkedSceneIds": [],
      "sourcePages": [],
      "reviewedDocumentation": [
        {
          "path": "apps/docs/content/architecture/operations/docker-demo.mdx",
          "sha256": "2b7726a1c1b7b9022e8ad0839b87fcaaba3e2b8f15ab0f28ad02e59a6c5ebcfe"
        },
        {
          "path": "apps/docs/content/operating/docker-demo.mdx",
          "sha256": "2f185bc106d2d5a78fa537f2030f94b1f0dd6022e2f840717826099ae93abc1c"
        }
      ],
      "frameworkIntegrity": {
        "status": "pass",
        "conclusion": "No scenes cite either changed page; this merge introduces no film claim requiring framework correction."
      },
      "audienceReadability": {
        "status": "pass",
        "conclusion": "Neither merged Docker page is cited by this film. The source mapping and text search found no Ollama version or HTTP 412 remedy. No scene requires a source correction for this merge."
      },
      "mediaUnchanged": true,
      "mp4Sha256": "d20b9e82312e62883069bca26a8a5f22fe3c06061c55594be51173fcb37f3024",
      "scriptSha256": "3aaba76d3551e869733253960bfd6993aedb619f7290757598a4a461955c387b",
      "limitations": [
        "Source-meaning review of the two merged Docker pages and their mapped scenes only; unmapped films were checked for source references and conflicting recovery/version claims.",
        "No new rendering, speech, listening, visual playback assessment, model inference or Docker deployment was performed. Existing delivery and media reviews remain tied to the unchanged film bytes.",
        "Dependency hashes include the merged working-tree documentation bytes. reviewRevision is the pre-merge Git HEAD; mergedRevision identifies the incoming history."
      ]
    },
    {
      "reviewed": "2026-10-15",
      "sourceSnapshot": "2400db89ab09187bd86747870337d800503bcb8e",
      "checkedSceneIds": [
        "s00",
        "s01",
        "s04",
        "s17"
      ],
      "result": "Completed approved Tabitha speech/Whisper regeneration for exactly s00,s01,s04,s17, reused14other clips, rebuilt timeline/captions/all 18 stills/finalencoded media, and passed current format, audio and browser checks. All18stills and required encoded samples reviewed. Human listening remains unassessed."
    },
    {
      "reviewed": "2026-10-23",
      "sourceSnapshot": "#126 renamed the troubleshooting link 'Docker demo diagnostics' to 'Installation diagnostics' in the analysis-incomplete row. Exact reviewed source hashes below.",
      "checkedSceneIds": [
        "s08"
      ],
      "sources": [
        {
          "path": "apps/docs/content/using/status-and-states.mdx",
          "sha256": "e692251f46ee1f4bae2bc8185b73c88ec5ff953f37ee1c2bb43163b43b931b38",
          "scenes": [
            "s08"
          ],
          "previousSha256": "949c80f2f9b8ad31f6bf201966fdee327022ccda2154ee915ba8549a5159c4f9"
        }
      ],
      "frameworkIntegrity": {
        "status": "pass",
        "finding": "s08 covers dependency classes, findings and sources on the map; it does not cite the changed row."
      },
      "audienceReadability": {
        "status": "pass",
        "finding": "Link text change only; the scene's narration and slide remain accurate."
      },
      "result": "Source-only review. Narration, slides, captions, timeline, encoded media and existing delivery evidence remain unchanged.",
      "preserved": {
        "contentSha256": "7597bf1aa070a937d45e718d5b37050b61cda171cfd2be59515823b73899acab",
        "mp4Sha256": "7662c6b971fff03136ae6aaedb5ffc71dc02d1f27cbda0e33d7e2b788e4a9c02",
        "buildUnchanged": true
      },
      "limits": [
        "No new encoding, playback or human voice listening. Existing unchanged media evidence is retained."
      ]
    },
    {
      "reviewed": "2026-10-27",
      "sourceSnapshot": "#219 added a Start here panel (tutorial film and User Manual link) to the organisations page description Exact reviewed source hashes below.",
      "checkedSceneIds": [
        "s00",
        "s17"
      ],
      "sources": [
        {
          "path": "apps/docs/content/using/sign-in-and-twins.mdx",
          "sha256": "a0212aa4b5ec76be28ebfc1d70b356459e0d8a79e0863ad39e6d92a1dc56f66f",
          "scenes": [
            "s00",
            "s17"
          ],
          "previousSha256": "2af1d9fa72ea1ea4c139b4a000913b347ccaa958ea48257c935df30832b52413"
        }
      ],
      "frameworkIntegrity": {
        "status": "pass",
        "finding": "s00 and s17 narration (sign in, choose an organisation, brief, sign out) remains true; their visuals are login.png and brief.png, which do not show the organisations list"
      },
      "audienceReadability": {
        "status": "pass",
        "finding": "No narration change; the page change adds two plain sentences"
      },
      "result": "Source-only review. Narration, slides, captions, timeline, encoded media and existing delivery evidence remain unchanged.",
      "preserved": {
        "contentSha256": "7597bf1aa070a937d45e718d5b37050b61cda171cfd2be59515823b73899acab",
        "mp4Sha256": "7662c6b971fff03136ae6aaedb5ffc71dc02d1f27cbda0e33d7e2b788e4a9c02",
        "buildUnchanged": true
      },
      "limits": [
        "No new encoding, playback or human voice listening. Existing unchanged media evidence is retained."
      ]
    }
  ],
  "build": {
    "durationSeconds": 485.734,
    "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/user-guide.mp4",
    "mp4Sha256": "7662c6b971fff03136ae6aaedb5ffc71dc02d1f27cbda0e33d7e2b788e4a9c02",
    "timelineSha256": "24aada141d0f6db7c7a9fbccad32d7af430d8eafb4a65c4f5c80ece98ffb4bfb",
    "rendererSha256": "86f3325730c15a4f0950fa7d3df5b79f2595e600f939d1ac83bf373a498b0fff",
    "slidesSha256": "b5ea851b6d5e3426029873ec8db3a0ea025e790e1fb7881720d45f7e12a5cd2e",
    "filmSha256": "12816c4f493a8ce0b2f17ec8c1fb8168b25e76f5ea70a1dd0667dc0d9ad12972",
    "mastering": {
      "profile": "aac-final-headroom-v1",
      "gainDb": -1.5,
      "inputSha256": "9eceb50dc2f98b69908f9ecfb0400f76dc363697e34826475eaae7765b364e84",
      "outputSha256": "3d5fc0314a6de1ef4d2f3e621d0adab264086ffa3707eec2ca97df2554b23e93",
      "helperSha256": "0d4eb99d43aff2dd3eab7209d646c494dfb0df424c55257b27c55bc06d2a39d4"
    },
    "brandFront": {
      "profile": "novus-photo-front-v1",
      "title": "Using NovusLens",
      "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": "3d5fc0314a6de1ef4d2f3e621d0adab264086ffa3707eec2ca97df2554b23e93",
      "outputSha256": "7662c6b971fff03136ae6aaedb5ffc71dc02d1f27cbda0e33d7e2b788e4a9c02",
      "audioSha256": "SHA256=2086dd9ee3c2484c4bb829025171c9f81043e02483fbd07c5a20ae6814e99065",
      "outputAudioSha256": "SHA256=2086dd9ee3c2484c4bb829025171c9f81043e02483fbd07c5a20ae6814e99065",
      "poster": {
        "path": "apps/docs/videos/user-guide/out/brand-poster.png",
        "sha256": "ceb7be67e70bafeca68f6e5a23f6f36fb74b70660b4dc4f2cf3582ff9dc36e64",
        "time": 0.5
      }
    }
  }
}