smartpipe-cli 1.4.0rc2__tar.gz → 1.4.0rc3__tar.gz

{smartpipe_cli-1.4.0rc2 → smartpipe_cli-1.4.0rc3}/CHANGELOG.md

@@ -5,11 +5,20 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) · Versioning:
 
 ## [Unreleased]
 
+
 ## [1.4.0] — 2026-07-08
 
 The identity release.
 
 ### Knowledge graphs (the highlight)
+- **The showcase**: a full verb page with the modality matrix and a
+  live-rendering Mermaid sample, a cookbook chapter written from real
+  runs against the downloadable playground corpus, the README highlight
+  with a screenshot of the case graph, agent SKILL recipes, and `graph`
+  on the welcome screen. Found en route: the playground download in the
+  docs pointed at the source tarball (no media inside) - all three
+  sites now fetch the actual 26 MB release asset.
+
 - **`smartpipe graph --fast` turns a corpus into a knowledge graph for
   exactly $0.** A local zero-shot NER model (GLiNER-small over ONNX -
   no new dependencies, no torch, a one-time ~190 MB download like the
@@ -256,6 +265,42 @@ The identity release.
   media-embedding capability.
 
 ### Setup that reads the room
+- **Rich now backs `config show` and `doctor`.** It is a deliberate core
+  dependency under the no-extras policy, imported only while those human-facing
+  screens render so `--help`, pipes, and `NO_COLOR` keep their existing contracts.
+- **The interactive config wizard can go backward.** Model, embedding, OCR, and
+  final review screens expose explicit Back rows; returning to a stage restores
+  its pre-stage checkpoint, and typed model prompts accept `back`, `b`, `no`, or
+  `n` instead of accidentally saving `ollama/n`.
+
+
+- **Discarding config is terminal and interruption is ordinary.** Choosing
+  discard no longer opens the shell-completion prompt after saying "Not saved";
+  Ctrl-C or EOF at any Click prompt exits 130 instead of showing the internal-bug
+  screen.
+
+- **`auth login` now connects every provider, not just ChatGPT.** Pick
+  from the full list - OpenAI appears twice because it really is two
+  wires (API key vs ChatGPT login, and the login wire has no
+  embeddings) - paste your key at a masked prompt after the create-a-key
+  URL, and it validates live before storing (with an honest
+  "store anyway - the provider may be having a bad minute" escape).
+  Keys live at `~/.local/share/smartpipe/auth.json`, owner-only
+  permissions from the first byte, masked everywhere they surface, and
+  the environment variable always wins. `auth list` shows what's
+  connected and which source is live; `auth logout` removes.
+- **Setup walks three questions in order: text model, embeddings,
+  document OCR.** Every stage shows every provider - connected ones
+  badged, unconnected ones connectable inline without leaving the flow.
+  The embedding stage only lists wires that embed; OCR is optional and
+  skippable in one keypress. At the end, one consented verification
+  pass (~5 tiny requests) probes what your models can actually do -
+  and if the basic text check fails, smartpipe reports a setup fault
+  instead of pretending your model lacks modalities. Results feed the
+  capability chips you see in every picker from then on, alongside a
+  public model registry and your own declarations for self-hosted
+  models.
+
 - **The schema workshop.** `smartpipe schema` with no arguments at a
   terminal opens a small interactive draft loop - your schema pinned up
   top as colored braces, commands scrolling below: `/add name type`,

{smartpipe_cli-1.4.0rc2 → smartpipe_cli-1.4.0rc3}/CITATION.cff

@@ -7,5 +7,5 @@ authors:
     given-names: Prabal
 repository-code: "https://github.com/prabal-rje/smartpipe"
 license: Apache-2.0
-version: 1.4.0rc2
+version: 1.4.0rc3
 date-released: '2026-07-08'

{smartpipe_cli-1.4.0rc2 → smartpipe_cli-1.4.0rc3}/CONTRIBUTING.md

@@ -9,7 +9,7 @@ Requires [uv](https://docs.astral.sh/uv/) and Python ≥ 3.11 (uv can fetch one
 
 ```console
 $ git clone https://github.com/prabal-rje/smartpipe && cd smartpipe
-$ uv sync --all-extras          # creates .venv with dev + optional deps
+$ uv sync --all-extras          # creates .venv with the project and dev tools
 $ uv run smartpipe                # welcome screen = working install
 ```
 
@@ -64,12 +64,13 @@ Reverting to built-in search is emptying the three values again.
 
 ## New dependencies
 
-Core install weight is a feature: the runtime dependency list is `click`, `httpx`,
-`jsonschema`, `tomli-w` — a snapshot test guards it. Anything heavier goes behind an
-optional extra, and heavy imports stay function-local (startup time is budgeted).
+Core install weight is a feature, but D46 deliberately ships the complete
+multimodal surface in core: there are no optional extras. The frozen dependency
+snapshot makes every direct or transitive addition an explicit review decision.
+Heavy imports stay function-local so startup remains budgeted.
 
 **New heavy import? Function-local or justify.** `--help` must never import
-`httpx`, `jsonschema`, `anthropic`, or `markitdown` —
+`httpx`, `jsonschema`, `anthropic`, `markitdown`, or `rich` —
 `tests/test_startup_imports.py` is the enforcement (it runs `-X importtime` and
 fails on any banned module). `make startup` gives an advisory wall-clock number;
 the import test is the deterministic gate.

{smartpipe_cli-1.4.0rc2 → smartpipe_cli-1.4.0rc3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: smartpipe-cli
-Version: 1.4.0rc2
+Version: 1.4.0rc3
 Summary: Semantic pipes and queries for your terminal - PDFs, images, audio, video, and text through Unix verbs that understand.
 Project-URL: Homepage, https://github.com/prabal-rje/smartpipe
 Project-URL: Changelog, https://github.com/prabal-rje/smartpipe/blob/main/CHANGELOG.md
@@ -32,6 +32,7 @@ Requires-Dist: matplotlib>=3.8
 Requires-Dist: pdfminer-six>=20231228
 Requires-Dist: plotext>=5
 Requires-Dist: pypdf>=5.0
+Requires-Dist: rich>=13.9
 Requires-Dist: tomli-w>=1.0
 Description-Content-Type: text/markdown
 
@@ -48,9 +49,9 @@ Description-Content-Type: text/markdown
 Run PDFs, images, audio, video, and text through Unix verbs that understand
 their input.
 
-[![smartpipe demo - click to play with sound and controls](https://github.com/prabal-rje/smartpipe/releases/download/demo-assets/smartpipe-teaser-v3.gif)](https://prabal-rje.github.io/smartpipe/demo/)
+[![smartpipe demo - click to play with sound and controls](https://github.com/prabal-rje/smartpipe/releases/download/demo-assets/smartpipe-teaser-v4.gif)](https://prabal-rje.github.io/smartpipe/demo/)
 
-*[▶ Watch the full 70-second demo](https://prabal-rje.github.io/smartpipe/demo/) - sound, controls, no download.*
+*[▶ Watch the full 86-second demo](https://prabal-rje.github.io/smartpipe/demo/) - sound, controls, no download.*
 
 ## Install
 
@@ -139,6 +140,7 @@ into ordinary Unix tools. Every verb is documented at
 | [`distinct`][distinct] | fold near-duplicates; `--exact` is free | `sort -u`, by meaning |
 | [`diff`][diff] | what distinguishes two sets | the post-incident answer |
 | [`outliers`][outliers] | the items least like the rest | novelty, surfaced |
+| [`graph`][graph] | corpus → entity/relationship graph; `--fast` is free | the case wall, with citations |
 
 **Free verbs** never call a model. Run them first to cut the corpus before any
 paid stage:
@@ -154,9 +156,10 @@ paid stage:
 | [`chart`][cli] | terminal bars, SVG, facets, time series | quick plots |
 
 Some semantic verbs have a **conditionally free mode**: `join --on` (key
-equality, no prompt), `distinct --exact` (hash-only folding), `map`/`extend`
-`--dry-run` (compose without sending), and `smartpipe schema` with a
-braces/DSL expression. Each stays at zero model calls by construction.
+equality, no prompt), `distinct --exact` (hash-only folding), `graph --fast`
+(local NER, on-device), `map`/`extend` `--dry-run` (compose without sending),
+and `smartpipe schema` with a braces/DSL expression. Each stays at zero model
+calls by construction.
 
 ## A one-minute tour
 
@@ -192,6 +195,9 @@ smartpipe map "Extract {vendor string, invoice_number string, total number}" 'in
 # 8. video RAG, no vector database: index a folder of recordings once, ask any day
 smartpipe embed 'sessions/**/*.mp4' > sessions.embeddings
 smartpipe top_k 3 --near "user gives up after the coupon fails" < sessions.embeddings
+
+# 9. the corpus as a knowledge graph - $0: local NER, zero model calls
+smartpipe graph --fast 'case-files/*.md' --save case.html
 ```
 
 A `.txt` on a pipe arrives one item per line; `--as file` treats the whole
@@ -206,6 +212,18 @@ Numbers 7 and 8 are full recipes -
 New to this? The [Learn track][quickstart] starts at zero and assumes nothing, including
 what a "model" is.
 
+### Highlight: the knowledge graph
+
+Number 9 is new: `graph --fast` turns a folder of mixed files into an
+interactive, **cited** knowledge graph without a single model call - a local
+NER model finds the entities you name, co-occurrence weights the edges, and
+hovering any edge shows the files behind it. A focus prompt upgrades the
+strongest edges to model-read relations. Full story:
+[the `graph` page](https://prabal-rje.github.io/smartpipe/verbs/graph/) and
+[the cookbook recipe](docs/cookbook/knowledge-graph.md).
+
+![smartpipe graph --save case.html: an interactive knowledge graph with per-edge source citations](docs/assets/graph-hero.png)
+
 ## Try it on real files
 
 No corpus handy? [smartpipe-playground][playground] ships 26 MB of CC0 /
@@ -213,8 +231,8 @@ public-domain practice files - invoices, reports, photos, recordings, screen
 sessions, and JSONL data:
 
 ```bash
-curl -L https://github.com/prabal-rje/smartpipe-playground/archive/refs/tags/v1.tar.gz | tar xz
-cd smartpipe-playground-1
+curl -L https://github.com/prabal-rje/smartpipe-playground/releases/download/v1/smartpipe-playground-v1.tar.gz | tar xz
+cd smartpipe-playground
 
 smartpipe map "Extract {vendor, invoice_number, total number}" 'invoices/*.pdf'
 smartpipe filter "the customer sounds frustrated" 'recordings/*.mp3'
@@ -236,9 +254,11 @@ For chat, [Ollama][ollama] runs models on your machine. Any cloud model sends
 that run's data to its provider - `gpt-5.4-mini`, `claude-opus-4-8`,
 `gemini-3.1-flash-lite`, `mistral-large-latest`, `openrouter/…`.
 
-API keys come from environment variables and are never stored. ChatGPT
-subscribers can run `smartpipe auth login` instead. `smartpipe usage` keeps
-local run and token totals; see [Privacy & security][privacy] for the details.
+API keys come from environment variables, or `smartpipe auth login` stores
+one securely for you. ChatGPT subscribers can log in instead of using a key.
+`smartpipe usage` keeps local run and token totals; see
+[Privacy & security][privacy] for where credentials live and how to remove
+them.
 
 ## Unix behavior
 
@@ -303,6 +323,7 @@ lives in [`qa/`](qa/README.md). The CLI surface is a SemVer contract.
 [distinct]: https://prabal-rje.github.io/smartpipe/verbs/distinct/
 [diff]: https://prabal-rje.github.io/smartpipe/verbs/diff/
 [outliers]: https://prabal-rje.github.io/smartpipe/verbs/outliers/
+[graph]: https://prabal-rje.github.io/smartpipe/verbs/graph/
 [where]: https://prabal-rje.github.io/smartpipe/verbs/where/
 [summarize]: https://prabal-rje.github.io/smartpipe/verbs/summarize/
 [sort]: https://prabal-rje.github.io/smartpipe/verbs/sort/

{smartpipe_cli-1.4.0rc2 → smartpipe_cli-1.4.0rc3}/README.md

@@ -11,9 +11,9 @@
 Run PDFs, images, audio, video, and text through Unix verbs that understand
 their input.
 
-[![smartpipe demo - click to play with sound and controls](https://github.com/prabal-rje/smartpipe/releases/download/demo-assets/smartpipe-teaser-v3.gif)](https://prabal-rje.github.io/smartpipe/demo/)
+[![smartpipe demo - click to play with sound and controls](https://github.com/prabal-rje/smartpipe/releases/download/demo-assets/smartpipe-teaser-v4.gif)](https://prabal-rje.github.io/smartpipe/demo/)
 
-*[▶ Watch the full 70-second demo](https://prabal-rje.github.io/smartpipe/demo/) - sound, controls, no download.*
+*[▶ Watch the full 86-second demo](https://prabal-rje.github.io/smartpipe/demo/) - sound, controls, no download.*
 
 ## Install
 
@@ -102,6 +102,7 @@ into ordinary Unix tools. Every verb is documented at
 | [`distinct`][distinct] | fold near-duplicates; `--exact` is free | `sort -u`, by meaning |
 | [`diff`][diff] | what distinguishes two sets | the post-incident answer |
 | [`outliers`][outliers] | the items least like the rest | novelty, surfaced |
+| [`graph`][graph] | corpus → entity/relationship graph; `--fast` is free | the case wall, with citations |
 
 **Free verbs** never call a model. Run them first to cut the corpus before any
 paid stage:
@@ -117,9 +118,10 @@ paid stage:
 | [`chart`][cli] | terminal bars, SVG, facets, time series | quick plots |
 
 Some semantic verbs have a **conditionally free mode**: `join --on` (key
-equality, no prompt), `distinct --exact` (hash-only folding), `map`/`extend`
-`--dry-run` (compose without sending), and `smartpipe schema` with a
-braces/DSL expression. Each stays at zero model calls by construction.
+equality, no prompt), `distinct --exact` (hash-only folding), `graph --fast`
+(local NER, on-device), `map`/`extend` `--dry-run` (compose without sending),
+and `smartpipe schema` with a braces/DSL expression. Each stays at zero model
+calls by construction.
 
 ## A one-minute tour
 
@@ -155,6 +157,9 @@ smartpipe map "Extract {vendor string, invoice_number string, total number}" 'in
 # 8. video RAG, no vector database: index a folder of recordings once, ask any day
 smartpipe embed 'sessions/**/*.mp4' > sessions.embeddings
 smartpipe top_k 3 --near "user gives up after the coupon fails" < sessions.embeddings
+
+# 9. the corpus as a knowledge graph - $0: local NER, zero model calls
+smartpipe graph --fast 'case-files/*.md' --save case.html
 ```
 
 A `.txt` on a pipe arrives one item per line; `--as file` treats the whole
@@ -169,6 +174,18 @@ Numbers 7 and 8 are full recipes -
 New to this? The [Learn track][quickstart] starts at zero and assumes nothing, including
 what a "model" is.
 
+### Highlight: the knowledge graph
+
+Number 9 is new: `graph --fast` turns a folder of mixed files into an
+interactive, **cited** knowledge graph without a single model call - a local
+NER model finds the entities you name, co-occurrence weights the edges, and
+hovering any edge shows the files behind it. A focus prompt upgrades the
+strongest edges to model-read relations. Full story:
+[the `graph` page](https://prabal-rje.github.io/smartpipe/verbs/graph/) and
+[the cookbook recipe](docs/cookbook/knowledge-graph.md).
+
+![smartpipe graph --save case.html: an interactive knowledge graph with per-edge source citations](docs/assets/graph-hero.png)
+
 ## Try it on real files
 
 No corpus handy? [smartpipe-playground][playground] ships 26 MB of CC0 /
@@ -176,8 +193,8 @@ public-domain practice files - invoices, reports, photos, recordings, screen
 sessions, and JSONL data:
 
 ```bash
-curl -L https://github.com/prabal-rje/smartpipe-playground/archive/refs/tags/v1.tar.gz | tar xz
-cd smartpipe-playground-1
+curl -L https://github.com/prabal-rje/smartpipe-playground/releases/download/v1/smartpipe-playground-v1.tar.gz | tar xz
+cd smartpipe-playground
 
 smartpipe map "Extract {vendor, invoice_number, total number}" 'invoices/*.pdf'
 smartpipe filter "the customer sounds frustrated" 'recordings/*.mp3'
@@ -199,9 +216,11 @@ For chat, [Ollama][ollama] runs models on your machine. Any cloud model sends
 that run's data to its provider - `gpt-5.4-mini`, `claude-opus-4-8`,
 `gemini-3.1-flash-lite`, `mistral-large-latest`, `openrouter/…`.
 
-API keys come from environment variables and are never stored. ChatGPT
-subscribers can run `smartpipe auth login` instead. `smartpipe usage` keeps
-local run and token totals; see [Privacy & security][privacy] for the details.
+API keys come from environment variables, or `smartpipe auth login` stores
+one securely for you. ChatGPT subscribers can log in instead of using a key.
+`smartpipe usage` keeps local run and token totals; see
+[Privacy & security][privacy] for where credentials live and how to remove
+them.
 
 ## Unix behavior
 
@@ -266,6 +285,7 @@ lives in [`qa/`](qa/README.md). The CLI surface is a SemVer contract.
 [distinct]: https://prabal-rje.github.io/smartpipe/verbs/distinct/
 [diff]: https://prabal-rje.github.io/smartpipe/verbs/diff/
 [outliers]: https://prabal-rje.github.io/smartpipe/verbs/outliers/
+[graph]: https://prabal-rje.github.io/smartpipe/verbs/graph/
 [where]: https://prabal-rje.github.io/smartpipe/verbs/where/
 [summarize]: https://prabal-rje.github.io/smartpipe/verbs/summarize/
 [sort]: https://prabal-rje.github.io/smartpipe/verbs/sort/

smartpipe_cli-1.4.0rc3/demo/video/README.md

@@ -0,0 +1,23 @@
+# smartpipe demo video
+
+A self-contained [Remotion](https://remotion.dev) project that renders the
+86-second smartpipe demo (1920x1080, 30 fps): eight scenes - cold open, the
+hook, multimodal, cost honesty, index, search, graph, close - all driven by
+one reusable `<Terminal>` component and the frame-math constants in
+`src/config.ts` (tune scene lengths there). Run `npm install` once, then
+`npm run studio` to preview in the browser or `npm run render` to produce
+`out/smartpipe-demo.mp4`; each scene is also registered as its own
+composition (`ColdOpen`, `Hook`, `Multimodal`, `CostHonesty`, `ScaleA`,
+`ScaleB`, `Graph`, `Close`), so `npx remotion render Hook out/hook.mp4`
+re-renders one scene independently. The narrated cut is the `MainNarrated`
+composition: the script text lives in `src/narration/lines.json`, and
+`RIME_API_KEY=... node scripts/fetch-narration.mjs` synthesizes the
+voiceover wavs (Rime.AI, speaker cupola) into the gitignored
+`public/narration/` and refreshes `src/narration/durations.json` - fetch
+before rendering `MainNarrated`. The music bed is
+`public/silicon-prism-waltz.m4a` (60 s, looped over the 86 s cut with a
+fade-out, held far below the voice); if you ever need a
+no-strings-attached replacement, `node scripts/make-music.mjs` (ffmpeg
+required) synthesizes an original ambient track from scratch into
+`public/music.m4a` - royalty-free by construction - and you can point the
+`<Audio>` element in `src/Main.tsx` at it.

{smartpipe_cli-1.4.0rc2 → smartpipe_cli-1.4.0rc3}/demo/video/src/Main.tsx

@@ -5,22 +5,34 @@ import { Background } from "./components/Background";
 import { Close } from "./scenes/Close";
 import { ColdOpen } from "./scenes/ColdOpen";
 import { CostHonesty } from "./scenes/CostHonesty";
+import { Graph } from "./scenes/Graph";
 import { Hook } from "./scenes/Hook";
 import { Multimodal } from "./scenes/Multimodal";
-import { Scale } from "./scenes/Scale";
+import { ScaleA } from "./scenes/ScaleA";
+import { ScaleB } from "./scenes/ScaleB";
+import { duckFactor, Narration } from "./Narration";
 
-/** The full ~70s cut: one persistent background, six scenes in series. */
-export const Main: React.FC = () => {
+/** Music bed base gain. Owner order (2026-07-09): "lower BG volume much
+ *  more" — 0.55 → 0.14, about −12 dB. Texture, never presence. */
+const MUSIC_BASE = 0.14;
+
+export type MainProps = { narrated?: boolean };
+
+/** The full 86s cut: one persistent background, eight scenes in series.
+ *  With `narrated`, the Rime voiceover plays on top, a subtitle band shows
+ *  the spoken words, and the music ducks a further few dB under speech. */
+export const Main: React.FC<MainProps> = ({ narrated = false }) => {
   return (
     <AbsoluteFill>
-      {/* Music bed: Silicon Prism Waltz (60s, looped to cover the 70s cut).
+      {/* Music bed: Silicon Prism Waltz (60s, looped to cover the 86s cut).
           Volume envelope: quick fade-in, steady bed, fade-out over the close.
           A fully synthesized fallback lives at scripts/make-music.mjs. */}
       <Audio
         loop
         src={staticFile("silicon-prism-waltz.m4a")}
         volume={(f) =>
-          0.55 *
+          MUSIC_BASE *
+          (narrated ? duckFactor(f) : 1) *
           interpolate(
             f,
             [0, 36, TOTAL_FRAMES - 96, TOTAL_FRAMES - 8],
@@ -43,13 +55,20 @@ export const Main: React.FC = () => {
         <Series.Sequence durationInFrames={SCENE.cost}>
           <CostHonesty />
         </Series.Sequence>
-        <Series.Sequence durationInFrames={SCENE.scale}>
-          <Scale />
+        <Series.Sequence durationInFrames={SCENE.scaleA}>
+          <ScaleA />
+        </Series.Sequence>
+        <Series.Sequence durationInFrames={SCENE.scaleB}>
+          <ScaleB />
+        </Series.Sequence>
+        <Series.Sequence durationInFrames={SCENE.graph}>
+          <Graph />
         </Series.Sequence>
         <Series.Sequence durationInFrames={SCENE.close}>
           <Close />
         </Series.Sequence>
       </Series>
+      {narrated ? <Narration /> : null}
     </AbsoluteFill>
   );
 };

smartpipe_cli-1.4.0rc3/demo/video/src/Narration.tsx

@@ -0,0 +1,94 @@
+import React from "react";
+import {
+  AbsoluteFill,
+  Audio,
+  interpolate,
+  Sequence,
+  staticFile,
+  useCurrentFrame,
+} from "remotion";
+import { COLORS, FPS } from "./config";
+import { MONO } from "./font";
+import lines from "./narration/lines.json";
+import durations from "./narration/durations.json";
+
+/**
+ * The Rime.AI voiceover: one wav per line of the committed script
+ * (src/narration/lines.json), fetched by scripts/fetch-narration.mjs into
+ * public/narration/ (gitignored). Each line also renders as a subtitle band
+ * below the scene caption cards, and duckFactor() dips the music bed a few
+ * dB while anyone is speaking.
+ */
+
+type Line = { id: string; at: number; text: string };
+
+const LINES: readonly Line[] = lines;
+const DURATIONS: Record<string, number> = durations;
+
+/** Narration mix gain: the clips peak near −1 dBFS — leave a little headroom. */
+const NARRATION_GAIN = 0.85;
+
+/** Music multiplier while the voice speaks (≈ −4.4 dB on top of the bed). */
+const VOICE_DUCK = 0.6;
+
+const clamp = { extrapolateLeft: "clamp", extrapolateRight: "clamp" } as const;
+
+const clipFrames = (id: string): number => {
+  const seconds = DURATIONS[id];
+  if (seconds === undefined) {
+    throw new Error(`no duration for narration clip "${id}" — run scripts/fetch-narration.mjs`);
+  }
+  return Math.ceil(seconds * FPS);
+};
+
+/** 1 in silence, VOICE_DUCK under speech, with 12-frame ramps either side. */
+export const duckFactor = (frame: number): number => {
+  const coverage = Math.max(
+    ...LINES.map((line) => {
+      const end = line.at + clipFrames(line.id);
+      return interpolate(frame, [line.at - 12, line.at, end, end + 12], [0, 1, 1, 0], clamp);
+    }),
+    0,
+  );
+  return 1 - (1 - VOICE_DUCK) * coverage;
+};
+
+/** The spoken words, as a dim mono subtitle band under the caption cards. */
+const SubtitleLine: React.FC<{ text: string; duration: number }> = ({
+  text,
+  duration,
+}) => {
+  const frame = useCurrentFrame();
+  const opacity = interpolate(frame, [0, 6, duration - 8, duration], [0, 1, 1, 0], clamp);
+  return (
+    <AbsoluteFill style={{ justifyContent: "flex-end", alignItems: "center" }}>
+      <div
+        style={{
+          marginBottom: 18,
+          fontFamily: MONO,
+          fontSize: 24,
+          color: COLORS.dim,
+          letterSpacing: 0.3,
+          opacity: opacity * 0.9,
+          textShadow: "0 2px 12px rgba(0,0,0,0.85)",
+        }}
+      >
+        {text}
+      </div>
+    </AbsoluteFill>
+  );
+};
+
+export const Narration: React.FC = () => (
+  <AbsoluteFill>
+    {LINES.map((line) => {
+      const duration = clipFrames(line.id) + 10;
+      return (
+        <Sequence key={line.id} from={line.at} durationInFrames={duration}>
+          <Audio src={staticFile(`narration/${line.id}.wav`)} volume={NARRATION_GAIN} />
+          <SubtitleLine text={line.text} duration={duration} />
+        </Sequence>
+      );
+    })}
+  </AbsoluteFill>
+);

{smartpipe_cli-1.4.0rc2 → smartpipe_cli-1.4.0rc3}/demo/video/src/Root.tsx

@@ -6,9 +6,11 @@ import { Main } from "./Main";
 import { Close } from "./scenes/Close";
 import { ColdOpen } from "./scenes/ColdOpen";
 import { CostHonesty } from "./scenes/CostHonesty";
+import { Graph } from "./scenes/Graph";
 import { Hook } from "./scenes/Hook";
 import { Multimodal } from "./scenes/Multimodal";
-import { Scale } from "./scenes/Scale";
+import { ScaleA } from "./scenes/ScaleA";
+import { ScaleB } from "./scenes/ScaleB";
 
 /** Standalone scene = background + scene, so each renders on its own. */
 const standalone = (Scene: React.FC): React.FC => {
@@ -26,7 +28,9 @@ const SCENES: readonly { id: string; component: React.FC; duration: number }[] =
   { id: "Hook", component: standalone(Hook), duration: SCENE.hook },
   { id: "Multimodal", component: standalone(Multimodal), duration: SCENE.multimodal },
   { id: "CostHonesty", component: standalone(CostHonesty), duration: SCENE.cost },
-  { id: "Scale", component: standalone(Scale), duration: SCENE.scale },
+  { id: "ScaleA", component: standalone(ScaleA), duration: SCENE.scaleA },
+  { id: "ScaleB", component: standalone(ScaleB), duration: SCENE.scaleB },
+  { id: "Graph", component: standalone(Graph), duration: SCENE.graph },
   { id: "Close", component: standalone(Close), duration: SCENE.close },
 ];
 
@@ -41,6 +45,17 @@ export const RemotionRoot: React.FC = () => {
         width={WIDTH}
         height={HEIGHT}
       />
+      {/* The narrated cut: same timeline + Rime voiceover, subtitles, ducked
+          music. Needs public/narration/*.wav — run scripts/fetch-narration.mjs. */}
+      <Composition
+        id="MainNarrated"
+        component={Main}
+        durationInFrames={TOTAL_FRAMES}
+        fps={FPS}
+        width={WIDTH}
+        height={HEIGHT}
+        defaultProps={{ narrated: true }}
+      />
       {SCENES.map((s) => (
         <Composition
           key={s.id}

{smartpipe_cli-1.4.0rc2 → smartpipe_cli-1.4.0rc3}/demo/video/src/components/Background.tsx

@@ -3,8 +3,9 @@ import { AbsoluteFill } from "remotion";
 import { COLORS } from "../config";
 
 /**
- * The stage every scene plays on: near-black, a whisper of a dot grid,
- * two barely-there color glows, scanlines, and a vignette.
+ * The stage every scene plays on: a FLAT near-black ground (owner ruling,
+ * 2026-07-09: no glowy background gradient), a whisper of a dot grid,
+ * scanlines, and a vignette.
  */
 export const Background: React.FC = () => {
   return (
@@ -18,14 +19,6 @@ export const Background: React.FC = () => {
           backgroundPosition: "14px 14px",
         }}
       />
-      {/* ambient color glows */}
-      <AbsoluteFill
-        style={{
-          background:
-            "radial-gradient(820px 560px at 22% 18%, rgba(34,211,238,0.07), transparent 70%)," +
-            "radial-gradient(900px 620px at 82% 78%, rgba(52,211,153,0.055), transparent 70%)",
-        }}
-      />
       {/* scanlines */}
       <AbsoluteFill
         style={{

{smartpipe_cli-1.4.0rc2 → smartpipe_cli-1.4.0rc3}/demo/video/src/components/Terminal.tsx

@@ -8,14 +8,24 @@ import { MONO } from "../font";
  *
  * Lines are declared with a `kind` and a start frame (`at`, relative to the
  * enclosing <Sequence>):
- *   - "cmd"  → typed character-by-character behind a block caret
- *   - "out"  → stdout rows that cascade in with a small spring
- *   - "note" → dimmed stderr diagnostics in yellow (receipts, run notes)
+ *   - "cmd"   → typed character-by-character behind a block caret
+ *   - "out"   → stdout rows that cascade in with a small spring
+ *   - "note"  → dimmed stderr diagnostics in yellow (receipts, run notes)
+ *   - "ord"   → the cyan `#N` ordinal above a human block (io/writers.py)
+ *   - "field" → one `key: value` block line — key dim, value normal; with
+ *               `dim` the whole line is the dimmed `__` spine treatment
+ *   - "wave"  → a small audio peak-envelope garnish (io/preview.py's look)
+ *   - "pair"  → a text snippet plus a dim trailing glyph (embed-row picture)
+ * `gap` renders the blank-line separation between blocks.
  */
 export type TerminalLine =
   | { kind: "cmd"; text: string; at: number; cps?: number }
   | { kind: "out"; text: string; at: number }
-  | { kind: "note"; text: string; at: number };
+  | { kind: "note"; text: string; at: number; gap?: boolean }
+  | { kind: "ord"; text: string; at: number; gap?: boolean }
+  | { kind: "field"; k: string; v: string; at: number; dim?: boolean }
+  | { kind: "wave"; text: string; at: number }
+  | { kind: "pair"; left: string; right: string; at: number };
 
 type Span = { text: string; color: string; weight?: number };
 
@@ -238,12 +248,15 @@ export const Terminal: React.FC<TerminalProps> = ({
             extrapolateLeft: "clamp",
             extrapolateRight: "clamp",
           });
+          const gap =
+            (line.kind === "ord" || line.kind === "note") && line.gap === true;
           const style: React.CSSProperties = {
             fontSize,
             lineHeight: `${lineHeight}px`,
             transform: `translateY(${(1 - p) * 15}px)`,
             opacity,
             whiteSpace: "pre",
+            marginTop: gap ? Math.round(lineHeight * 0.5) : 0,
           };
           if (line.kind === "note") {
             return (
@@ -255,6 +268,58 @@ export const Terminal: React.FC<TerminalProps> = ({
               </div>
             );
           }
+          if (line.kind === "ord") {
+            return (
+              <div
+                key={i}
+                style={{ ...style, color: COLORS.cyan, fontWeight: 700 }}
+              >
+                {line.text}
+              </div>
+            );
+          }
+          if (line.kind === "field") {
+            // io/render.py `_line`: the key label dim, the value normal; a
+            // `dim` line is the `__` spine — dimmed whole, metadata-quiet.
+            return (
+              <div key={i} style={style}>
+                <span style={{ color: line.dim ? COLORS.ghost : COLORS.dim }}>
+                  {line.k}:{" "}
+                </span>
+                <span style={{ color: line.dim ? COLORS.faint : COLORS.text }}>
+                  {line.v}
+                </span>
+              </div>
+            );
+          }
+          if (line.kind === "pair") {
+            return (
+              <div key={i} style={style}>
+                <span style={{ color: COLORS.text }}>{line.left}</span>
+                <span style={{ color: COLORS.faint, opacity: 0.8 }}>
+                  {"   "}
+                  {line.right}
+                </span>
+              </div>
+            );
+          }
+          if (line.kind === "wave") {
+            // io/preview.py's audio garnish: a peak envelope, nested + quiet.
+            return (
+              <div
+                key={i}
+                style={{
+                  ...style,
+                  color: COLORS.cyanDim,
+                  opacity: opacity * 0.55,
+                  letterSpacing: 1,
+                }}
+              >
+                {"  "}
+                {line.text}
+              </div>
+            );
+          }
           return (
             <div key={i} style={style}>
               <Spans spans={colorizeOut(line.text)} />