@hraness/slopcamera 3.6.0 → 3.8.0

package/README.md

@@ -1,22 +1,22 @@
-# Slopcamera
+# SlopCamera
 
-[![Slopcamera: Visual work your agent can keep revising.](https://slopcamera.com/og.png)](https://slopcamera.com)
+[![SlopCamera: Images, diagrams, animation, 3D and video your coding agent can keep revising.](https://slopcamera.com/og.png)](https://slopcamera.com)
 
-**Slopcamera is a media studio for coding agents. Codex, Claude Code, and other
+**SlopCamera is a media studio for coding agents. Codex, Claude Code, and other
 agents make images, diagrams, animation, 3D scenes, and edited video from source
 files they can keep revising.**
 
 Describe the result you want to Codex, Claude Code, or another coding agent.
-Slopcamera gives the agent a Bun CLI, a TypeScript SDK, and an Agent Skill matched
+SlopCamera gives the agent a Bun CLI, a TypeScript SDK, and an Agent Skill matched
 to the CLI version, so it can inspect sources, set up cameras, edit a composition,
 and render. `slopcamera mcp` runs an MCP server with a smaller, fixed set of diagram,
-image, and scene tools. Projects stay in local files, and there is no Slopcamera
+image, and scene tools. Projects stay in local files, and there is no SlopCamera
 account. Generation uses your own Vercel AI Gateway account or, for prompt-only
 images, prepaid Hraness Credits.
 
 [Install](#install-slopcamera) · [Make a first diagram](#make-your-first-diagram) · [Capabilities](#what-slopcamera-does) · [Documentation](https://slopcamera.com/docs) · [slopcamera.com](https://slopcamera.com)
 
-## Made with Slopcamera
+## Made with SlopCamera
 
 [![An original brass optical instrument rendered in Blender](apps/web/media/native-product-poster-51b1658c46d3.webp)](https://slopcamera.com/docs/tutorials/first-native-film#inspect-the-finished-example)
 
@@ -27,7 +27,7 @@ The [portrait geometry lesson](https://slopcamera.com/docs/how-to/educational-vi
 adds mathematical typesetting, a presenter and authored captions. Each guide pairs
 the rendered output with source, runtime requirements and reproduction steps.
 
-## Why Slopcamera
+## Why SlopCamera
 
 - **Keep creative work editable.** Native scenes, portable scenes, diagrams,
   and video projects retain their own sources and settings. Rendered frames
@@ -45,16 +45,29 @@ the rendered output with source, runtime requirements and reproduction steps.
   instead run on the hosted API with prepaid Hraness Credits. Native Python
   authoring requires separate trust because it runs as your current user.
 
-## Install Slopcamera
+## Compared with other tools
 
-Slopcamera v3.5.0 includes 17 reusable film and animation direction profiles, deterministic exposure helpers, and a sample renderer that defaults to native 4K. Use the [style direction guide](docs/how-to/direct-visual-styles.md) to author cel animation, pixel art, mathematical explanations, and historical film treatments from retained sources. On macOS, `slopcamera menubar` puts Slopcamera in the menu bar and explains each macOS notice before it appears.
+- [Remotion](https://www.remotion.dev/) renders React components to video and can
+  render on AWS Lambda. It is source-available and needs a paid license for
+  companies of four or more people.
+- [HyperFrames](https://github.com/heygen-com/hyperframes) renders HTML to MP4
+  under Apache 2.0, with optional HeyGen-hosted rendering.
+- [MCP for Blender](https://github.com/ahujasid/mcp-for-blender), formerly Blender
+  MCP, lets an agent drive a running Blender interactively.
+
+SlopCamera renders HTML motion too, and adds diagrams, Three.js scenes, headless
+Blender, CadQuery, and Manim renders, and edits of your own footage in one local
+project. It has no cloud rendering and a much smaller community. See
+[the full comparison](https://slopcamera.com/docs/explanation/why-slopcamera#compared-with-other-tools).
+
+## Install SlopCamera
 
 Install [Bun 1.3.14 or newer](https://bun.sh), then install the verified
-[Slopcamera v3.5.0 release](https://github.com/hraness/slopcamera/releases/tag/v3.5.0)
+[SlopCamera v3.6.0 release](https://github.com/hraness/slopcamera/releases/tag/v3.6.0)
 from its canonical archive:
 
 ```sh
-bun add --global https://github.com/hraness/slopcamera/releases/download/v3.5.0/hraness-slopcamera-3.5.0.tgz
+bun add --global https://github.com/hraness/slopcamera/releases/download/v3.6.0/hraness-slopcamera-3.6.0.tgz
 slopcamera skill install --target agents
 ```
 
@@ -90,15 +103,16 @@ Native engines install separately. The [source-install guide](docs/how-to/use-cu
 explains workspace placement and durable-run identity; the
 [capability reference](docs/reference/capabilities.md) names runtime requirements.
 
-Slopcamera is a CLI. On macOS, an optional unbundled menu-bar companion shows
-what Slopcamera is rendering, how the last job ended, your last known credits
-balance and the newest files in the agent outputs directory; `slopcamera menubar` runs a prebuilt
-companion directly and does not install or launch an application bundle. The
-companion is a thin product binary over the shared
-[desktop-foundation](https://github.com/hraness/desktop-foundation) crate, pinned
-by immutable tag. Build it explicitly with
-`cargo build --release --manifest-path desktop/menubar/Cargo.toml`
-when working from source.
+SlopCamera is a CLI with no menu-bar app or background process.
+`slopcamera status` shows what is running, how the last job ended, your last
+known credits balance, the newest outputs and whether the retired menu-bar
+companion still opens at login. `slopcamera tui` keeps
+that screen open and refreshes it; `slopcamera tui --snapshot` prints it once
+and `--json` returns the data. `slopcamera outputs list|open|reveal` lists the
+newest outputs or opens one on this Mac, `slopcamera commands --json` lists
+every command with what it may change, and `slopcamera legacy retire` stops
+the retired menu-bar companion opening at login by moving its LaunchAgent aside; it
+deletes nothing, and `slopcamera doctor` prints the command that restores it.
 
 <details>
 <summary>Historical Atet release evidence</summary>
@@ -106,14 +120,14 @@ when working from source.
 [Atet v3.2.3](https://github.com/hraness/atet/releases/tag/v3.2.3) and its
 [original archive](https://github.com/hraness/atet/releases/download/v3.2.3/hraness-atet-3.2.3.tgz)
 remain historical publication evidence. Those immutable bytes install Atet,
-not Slopcamera. Renaming the repository does not create a renamed package or
+not SlopCamera. Renaming the repository does not create a renamed package or
 change an existing release.
 
 </details>
 
 ## Make your first diagram
 
-After installing Slopcamera, this local task needs no model account. In a new directory,
+After installing SlopCamera, this local task needs no model account. In a new directory,
 create the included diagram, check it, and render it:
 
 ```sh
@@ -136,10 +150,12 @@ For detailed native 3D, follow
 [Your first native film](docs/tutorials/first-native-film.md). To generate editable
 architecture from dimensions, [build a parametric design](https://slopcamera.com/docs/how-to/parametric-design).
 
-## What Slopcamera does
+## What SlopCamera does
 
-Slopcamera lets your coding agent make images, diagrams, animation, 3D scenes,
+SlopCamera lets your coding agent make images, diagrams, animation, 3D scenes,
 and video from source files it can keep revising.
+Direct cel animation, pixel art, math explainers, and period film looks with the
+[style direction guide](docs/how-to/direct-visual-styles.md).
 
 ### Author scenes and direct cameras
 
@@ -158,7 +174,7 @@ rigged/morph profile in v3.3.1 admits bounded skins and morph targets. Saved spl
 capture appearance; they do not establish collision geometry or editable native
 meshes. See [Directed scenes](docs/spatial-scenes.md).
 
-Slopcamera v3.3.1 introduced the cinematic planning loop: a `slopcamera.spatial-direction`
+SlopCamera v3.3.1 introduced the cinematic planning loop: a `slopcamera.spatial-direction`
 document describes beats, actions, camera coverage, and look intents, compiles
 into proposed performance/camera/cinema/material-lighting/shot documents, and
 fans out into bounded galleries per axis. Declared effects bind into renders,
@@ -174,12 +190,12 @@ slopcamera workflows plan cinematic-world --input pack-input.json --json
 The `cinematic-world` workflow consumes one inert recipe pack — a bounded,
 content-addressed JSON document an agent can author — and stops before
 selection. Registration and selection stay explicit `scene project` operations.
-See [Direct a cinematic world](docs/how-to/direct-cinematic-worlds.md) and the
+See [Plan camera moves, lighting, and effects for a 3D scene](docs/how-to/direct-cinematic-worlds.md) and the
 [extension architecture](docs/extension-architecture.md).
 
 ### Film native worlds and educational animation
 
-Slopcamera can direct Blender for detailed sets, materials,
+SlopCamera can direct Blender for detailed sets, materials,
 lighting, skinned characters, cloth and liquid caches; CadQuery for parametric
 solids and STEP; and Manim Community for mathematical animation. Seven editable
 starters include a product, character, shaded street, cloth, liquid, CAD bracket,
@@ -195,7 +211,7 @@ camera clock for reuse. Supported GLB derivatives and calibrated cameras can
 cross between native and portable scenes; rigs, solvers, and procedural materials
 remain native. Blender and Python environments are installed separately, and
 source execution requires explicit current-user trust. See [Native film studio](docs/studio.md)
-and [Make an educational video](docs/how-to/educational-video.md).
+and [Make a math explainer video with Manim](docs/how-to/educational-video.md).
 
 ### Build diagrams and motion graphics
 
@@ -269,12 +285,12 @@ slopcamera workflows list --json
 slopcamera workflows show social-variants --json
 ```
 
-## How Slopcamera works
+## How SlopCamera works
 
 Keep the source that owns each creative decision. A native scene owns a rig or
 simulation; a portable scene owns supported geometry, cameras, and media surfaces;
 a diagram owns its objects and labels; a video project owns cuts and delivery.
-Slopcamera connects these through explicit assets and rendered derivatives.
+SlopCamera connects these through explicit assets and rendered derivatives.
 
 1. **Prepare the sources.** Import footage and assets or author a scene, diagram,
    or native program. Inspect available tools before choosing an engine.
@@ -318,7 +334,7 @@ declarative graphs, approvals, and resuming work.
 
 ## Design and trust
 
-There is no Slopcamera account, hosted project database, or browser generation service.
+There is no SlopCamera account, hosted project database, or browser generation service.
 Ordinary editing and rendering remain local. Gateway generation and selected
 cloud analysis use credentials from the local process and request explicit
 acknowledgement before uploading named media. The optional hosted API runs each
@@ -349,7 +365,7 @@ vision](https://algal.computer/docs/vision/) states the bet behind it.
 ## Documentation
 
 - **Learn:** [Your first diagram](docs/tutorials/first-diagram.md) · [Your first native film](docs/tutorials/first-native-film.md).
-- **Make a result:** [Edit video](docs/how-to/edit-video.md) · [Generate media](docs/how-to/generate-media.md) · [Run workflows](docs/how-to/run-workflows.md) · [Educational video](docs/how-to/educational-video.md) · [Direct a cinematic world](docs/how-to/direct-cinematic-worlds.md).
+- **Make a result:** [Edit video](docs/how-to/edit-video.md) · [Generate media](docs/how-to/generate-media.md) · [Run workflows](docs/how-to/run-workflows.md) · [Educational video](docs/how-to/educational-video.md) · [Plan camera moves, lighting, and effects for a 3D scene](docs/how-to/direct-cinematic-worlds.md).
 - **Look up support:** [Capabilities and release availability](docs/reference/capabilities.md) · [SDK entrypoints](docs/reference/sdk.md) · [Creative tools](docs/html-overlay-creative-toolkit.md).
 - **Understand the system:** [Architecture](docs/architecture.md) · [Native studio](docs/studio.md) · [Directed scenes](docs/spatial-scenes.md) · [Extension architecture](docs/extension-architecture.md).
 
@@ -413,4 +429,4 @@ an acknowledgment; the unacknowledged offer expires after ten minutes and does n
 consume the weekly shown cooldown. `support dismiss` opts out across the local suite;
 `support snooze` pauses for 30 days. `HRANESS_SUPPORT_AUDIENCE=off` disables ambient
 notices and claimed offers. Payment is an explicit human choice on the shared support
-page; Slopcamera has no product-updates mailing list or account-status lookup.
+page; SlopCamera has no product-updates mailing list or account-status lookup.

package/apps/desktop/README.md

@@ -1,6 +1,6 @@
-# Slopcamera local host and CLI
+# SlopCamera local host and CLI
 
-Slopcamera reads finished recording bundles from repository-local directories, combines independent camera and audio takes on one typed project clock, then applies non-destructive edits through the `slopcamera` CLI. The CLI is the product surface for agents. An optional unbundled `slopcamera menubar` companion surfaces the agent outputs directory in the macOS menu bar; it carries no capture or editing authority.
+Slopcamera reads finished recording bundles from repository-local directories, combines independent camera and audio takes on one typed project clock, then applies non-destructive edits through the `slopcamera` CLI. The CLI is the product surface for agents. `slopcamera status` and `slopcamera tui` show what is running, credits and the newest agent outputs in the terminal.
 
 ## Recording bundles
 
@@ -819,13 +819,6 @@ bun run test:html-overlay
 bun run benchmark:code-concurrency
 ```
 
-The optional Rust menu-bar companion lives under `desktop/` at the repository root and builds with Cargo:
-
-```sh
-cargo build --manifest-path desktop/menubar/Cargo.toml
-slopcamera menubar
-```
-
 `test:html-overlay` is portable and leaves the real-browser tests registered as
 skipped. `test:html-overlay:browser:macos` runs the real Chrome frame suite,
 including a declared PNG. `test:html-overlay:libraries:macos` additionally
@@ -847,4 +840,4 @@ The compiled smoke copies the executable away from the checkout and proves
 diagram initialization/rendering plus PNG-to-SVG vectorization without
 `node_modules`.
 
-Screen recording, microphone, camera, Input Monitoring, and Accessibility are separate macOS permissions. A missing optional source becomes a typed diagnostic; strict-input mode fails before recording begins. Slopcamera ships as a CLI with an unbundled menu-bar companion; it does not produce, install, sign, or notarize a desktop application.
+Screen recording, microphone, camera, Input Monitoring, and Accessibility are separate macOS permissions. A missing optional source becomes a typed diagnostic; strict-input mode fails before recording begins. Slopcamera ships as a CLI; it does not produce, install, sign, or notarize a desktop application.

package/apps/desktop/application/html-overlay-renderer.ts

@@ -19,6 +19,12 @@ export interface HtmlOverlayFrameRenderRequest {
   readonly browserRuntime: HtmlOverlayBrowserRuntimeBinding;
   readonly outputDirectory: string;
   readonly resources: readonly BoundHtmlOverlayResource[];
+  /**
+   * Optional ascending subset of frame indexes to capture, for stills and
+   * previews. Omitted means every frame. Captured files keep their absolute
+   * frame index in the name, so `frame-%08d.png` stays addressable.
+   */
+  readonly frames?: readonly number[];
 }
 
 export interface HtmlOverlayFrameRenderResult {

package/apps/desktop/application/operation.ts

@@ -4,7 +4,7 @@ import type { z } from "zod";
 
 import type { ApplicationContext } from "./context";
 
-export const SLOPCAMERA_APPLICATION_TOOL_VERSION = "slopcamera-3.6.0" as const;
+export const SLOPCAMERA_APPLICATION_TOOL_VERSION = "slopcamera-3.8.0" as const;
 
 export const OPERATION_KINDS = [
   "scene.audit",

package/apps/desktop/application/spatial-assets.ts

@@ -459,7 +459,7 @@ export async function withPreparedSpatialAssets<Result>(
     }
     const decoded = await raster(bytes, interpretation.alpha === "opaque");
     if (decoded.width !== interpretation.width || decoded.height !== interpretation.height) throw new RangeError("Image dimensions differ from its interpretation.");
-    profiles.add("sdr-png-jpeg-sharp-0.35.3");
+    profiles.add("sdr-png-jpeg-sharp-0.35.4");
     return publishRaster(decoded);
   };
   const native = async (argv: readonly [string, ...string[]], maxOutputBytes = 16_384) => {

package/apps/desktop/cli/{menubar-status.ts → activity-status.ts}

@@ -5,18 +5,20 @@ import { join } from "node:path";
 import type { CliCommand } from "./args";
 
 /**
- * The small status file the menu bar reads: what Slopcamera is doing now,
+ * The small status file `slopcamera status` and `slopcamera tui` read: what Slopcamera is doing now,
  * how the last render ended, and the last credits balance a command saw.
  * It holds plain labels, times and fixed error codes only — never paths,
  * prompts, tokens or account identifiers. Writes are best effort: a status
  * that can't be saved never fails the command.
  */
-export const MENUBAR_STATUS_FILE = "menubar-status.json";
+// The on-disk name predates the menu bar's retirement and stays frozen, so a
+// rolled-back release and existing state keep reading the same file.
+export const ACTIVITY_STATUS_FILE = "menubar-status.json";
 const MAX_STATUS_BYTES = 16 * 1024;
 
 export type ActivityState = "running" | "done" | "failed";
 
-export interface MenubarActivity {
+export interface RecordedActivity {
   readonly state: ActivityState;
   readonly label: string;
   readonly startedAt: number;
@@ -24,16 +26,16 @@ export interface MenubarActivity {
   readonly error?: string;
 }
 
-export interface MenubarCredits {
+export interface RecordedCredits {
   readonly usd: string;
   readonly low: boolean;
   readonly checkedAt: number;
 }
 
-export interface MenubarStatus {
+export interface ActivityStatus {
   readonly schemaVersion: 1;
-  readonly activity?: MenubarActivity;
-  readonly credits?: MenubarCredits;
+  readonly activity?: RecordedActivity;
+  readonly credits?: RecordedCredits;
 }
 
 /** Plain labels for the commands that make media. Everything else leaves the status alone. */
@@ -43,6 +45,7 @@ export function activityLabel(command: CliCommand): string | undefined {
     case "project-render": return command.action === "run" && !command.dryRun ? "Rendering a project" : undefined;
     case "project-cinema": return "Rendering a project";
     case "html-render": return "Rendering an HTML scene";
+    case "html-film": return command.action === "deliver" ? "Encoding a film" : "Rendering film stills";
     case "diagram-render": return "Rendering a diagram";
     case "image-vectorize": return "Vectorizing an image";
     case "ai-image-generate": return "Generating an image";
@@ -57,13 +60,13 @@ export function activityLabel(command: CliCommand): string | undefined {
   }
 }
 
-function parse(text: string): MenubarStatus {
+function parse(text: string): ActivityStatus {
   try {
     const value: unknown = JSON.parse(text);
     if (typeof value !== "object" || value === null || (value as { schemaVersion?: unknown }).schemaVersion !== 1) return { schemaVersion: 1 };
     const record = value as Record<string, unknown>;
-    const activity = record.activity as MenubarActivity | undefined;
-    const credits = record.credits as MenubarCredits | undefined;
+    const activity = record.activity as RecordedActivity | undefined;
+    const credits = record.credits as RecordedCredits | undefined;
     return {
       schemaVersion: 1,
       ...(activity !== undefined && typeof activity === "object" && typeof activity.label === "string" ? { activity } : {}),
@@ -74,8 +77,8 @@ function parse(text: string): MenubarStatus {
   }
 }
 
-export function readMenubarStatus(stateRoot: string): MenubarStatus {
-  const path = join(stateRoot, MENUBAR_STATUS_FILE);
+export function readActivityStatus(stateRoot: string): ActivityStatus {
+  const path = join(stateRoot, ACTIVITY_STATUS_FILE);
   try {
     const info = lstatSync(path);
     if (!info.isFile() || info.size > MAX_STATUS_BYTES) return { schemaVersion: 1 };
@@ -85,7 +88,7 @@ export function readMenubarStatus(stateRoot: string): MenubarStatus {
   }
 }
 
-const LOCK_FILE = `.${MENUBAR_STATUS_FILE}.lock`;
+const LOCK_FILE = `.${ACTIVITY_STATUS_FILE}.lock`;
 /** A held lock blocks a write for this long before it is skipped. */
 const LOCK_BUDGET_MS = 250;
 /** A lock older than this is a crashed writer's and is reclaimed. */
@@ -127,14 +130,14 @@ function withStatusLock<T>(stateRoot: string, update: () => T): T | undefined {
 }
 
 /** Replaces the status file atomically with an owner-only file. Never throws. */
-export function writeMenubarStatus(stateRoot: string, update: (current: MenubarStatus) => MenubarStatus): void {
+export function writeActivityStatus(stateRoot: string, update: (current: ActivityStatus) => ActivityStatus): void {
   withStatusLock(stateRoot, () => {
-    const path = join(stateRoot, MENUBAR_STATUS_FILE);
-    const staged = join(stateRoot, `.${MENUBAR_STATUS_FILE}.${randomUUID()}.tmp`);
+    const path = join(stateRoot, ACTIVITY_STATUS_FILE);
+    const staged = join(stateRoot, `.${ACTIVITY_STATUS_FILE}.${randomUUID()}.tmp`);
     try {
       const root = lstatSync(stateRoot);
       if (!root.isDirectory()) return;
-      const text = `${JSON.stringify(update(readMenubarStatus(stateRoot)))}\n`;
+      const text = `${JSON.stringify(update(readActivityStatus(stateRoot)))}\n`;
       if (Buffer.byteLength(text) > MAX_STATUS_BYTES) return;
       const fd = openSync(staged, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
       try { writeSync(fd, text); } finally { closeSync(fd); }
@@ -146,10 +149,10 @@ export function writeMenubarStatus(stateRoot: string, update: (current: MenubarS
   });
 }
 
-export function recordActivity(stateRoot: string, activity: MenubarActivity): void {
-  writeMenubarStatus(stateRoot, (current) => ({ ...current, activity }));
+export function recordActivity(stateRoot: string, activity: RecordedActivity): void {
+  writeActivityStatus(stateRoot, (current) => ({ ...current, activity }));
 }
 
-export function recordCredits(stateRoot: string, credits: MenubarCredits): void {
-  writeMenubarStatus(stateRoot, (current) => ({ ...current, credits }));
+export function recordCredits(stateRoot: string, credits: RecordedCredits): void {
+  writeActivityStatus(stateRoot, (current) => ({ ...current, credits }));
 }

package/apps/desktop/cli/args.ts

@@ -1,5 +1,6 @@
 import { CliError } from "./errors";
 import { MAX_EVENT_QUERY_LIMIT } from "./query-limits";
+import { HTML_FILM_CUTS, type HtmlFilmCommand, type HtmlFilmCut } from "./html-film-names";
 import { STUDIO_TEMPLATES, type StudioTemplate } from "./studio-template-names";
 import {
   slopcameraGalleryKinds,
@@ -121,6 +122,7 @@ export type SpatialProjectCommand = JsonOption & {
 
 export type CliCommand =
   | { readonly kind: "html-render"; readonly input: string; readonly dryRun: boolean; readonly json: boolean }
+  | HtmlFilmCommand
   | StudioCommand
   | DirectingCommand
   | SpatialWorldCommand
@@ -333,7 +335,6 @@ export type CliCommand =
       readonly tint: number | undefined;
       readonly videoStreamIndex: number;
     } & JsonOption)
-  | ({ readonly kind: "menubar"; readonly action: "run" | "install" | "uninstall" | "status"; readonly mode: "foreground" | "background" } & JsonOption)
   | ({ readonly kind: "outputs" } & JsonOption)
   | ({ readonly kind: "credits-status" } & JsonOption)
   | ({
@@ -731,6 +732,63 @@ function fail(message: string): never {
   throw new CliError("usage", message);
 }
 
+const HTML_STILL_USAGE = "Use html still --input <scene.json> --at <seconds>[,<seconds>...] --output <dir> [--json].";
+const HTML_PREVIEW_USAGE = "Use html preview --input <scene.json> --output <dir> [--every <seconds>] [--json].";
+const HTML_DELIVER_USAGE = "Use html deliver <export.json> --basename <name> --poster-at <seconds> --social-at <seconds> [--cuts 1:1,9:16] [--per-beat-clips] [--beats <beats.json>] [--output <dir>] [--json].";
+
+function secondsList(value: string | undefined, usage: string): readonly number[] {
+  if (value === undefined) fail(usage);
+  return value.split(",").map(part => {
+    if (!/^(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$/u.test(part.trim())) fail(`Times must be seconds such as 3 or 12.5; got ${part}.`);
+    return Number(part.trim());
+  });
+}
+
+function parseHtmlFilmArgs(action: "still" | "preview" | "deliver", argv: readonly string[]): HtmlFilmCommand {
+  if (action === "still") {
+    const parsed = parseOptions(argv, { "--input": "value", "--at": "value", "--output": "value", "--json": "flag" });
+    const input = optionString(parsed, "--input");
+    const output = optionString(parsed, "--output");
+    if (input === undefined || output === undefined || parsed.positionals.length !== 0) fail(HTML_STILL_USAGE);
+    return { kind: "html-film", action, input, output, at: secondsList(optionString(parsed, "--at"), HTML_STILL_USAGE), json: optionFlag(parsed, "--json") };
+  }
+  if (action === "preview") {
+    const parsed = parseOptions(argv, { "--input": "value", "--every": "value", "--output": "value", "--json": "flag" });
+    const input = optionString(parsed, "--input");
+    const output = optionString(parsed, "--output");
+    if (input === undefined || output === undefined || parsed.positionals.length !== 0) fail(HTML_PREVIEW_USAGE);
+    const every = optionString(parsed, "--every");
+    const [seconds] = every === undefined ? [2] : secondsList(every, HTML_PREVIEW_USAGE);
+    if (seconds === undefined || seconds <= 0) fail("--every must be more than 0 seconds.");
+    return { kind: "html-film", action, input, output, every: seconds, json: optionFlag(parsed, "--json") };
+  }
+  const parsed = parseOptions(argv, {
+    "--basename": "value", "--poster-at": "value", "--social-at": "value", "--cuts": "value",
+    "--per-beat-clips": "flag", "--beats": "value", "--output": "value", "--json": "flag",
+  });
+  const basename = optionString(parsed, "--basename");
+  if (parsed.positionals.length !== 1 || basename === undefined) fail(HTML_DELIVER_USAGE);
+  const single = (name: string) => {
+    const values = secondsList(optionString(parsed, name), HTML_DELIVER_USAGE);
+    if (values.length !== 1) fail(`${name} takes one time in seconds.`);
+    return values[0]!;
+  };
+  const cutsInput = optionString(parsed, "--cuts");
+  const cuts = cutsInput === undefined ? [] : cutsInput.split(",").map(cut => {
+    if (!(HTML_FILM_CUTS as readonly string[]).includes(cut)) fail(`--cuts takes ${HTML_FILM_CUTS.join(", ")}; got ${cut}.`);
+    return cut as HtmlFilmCut;
+  });
+  const beats = optionString(parsed, "--beats");
+  const output = optionString(parsed, "--output");
+  return {
+    kind: "html-film", action, exportPath: parsed.positionals[0]!, basename,
+    posterAt: single("--poster-at"), socialAt: single("--social-at"), cuts,
+    perBeatClips: optionFlag(parsed, "--per-beat-clips"),
+    ...(beats === undefined ? {} : { beats }), ...(output === undefined ? {} : { output }),
+    json: optionFlag(parsed, "--json"),
+  };
+}
+
 function parseOptions(argv: readonly string[], spec: OptionSpec): ParsedOptions {
   const options: Record<string, OptionValue> = {};
   const positionals: string[] = [];
@@ -3631,6 +3689,7 @@ export function parseCliArgs(argv: readonly string[]): CliCommand {
   const command = argv[0]!;
   switch (command) {
     case "html": {
+      if (argv[1] === "still" || argv[1] === "preview" || argv[1] === "deliver") return parseHtmlFilmArgs(argv[1], argv.slice(2));
       if (argv[1] !== "render") fail("Use html render --input <scene.json> [--dry-run] [--json].");
       const parsed = parseOptions(argv.slice(2), { "--input": "value", "--dry-run": "flag", "--json": "flag" });
       const input = optionString(parsed, "--input");
@@ -3656,15 +3715,8 @@ export function parseCliArgs(argv: readonly string[]): CliCommand {
     case "project": return parseProject(argv.slice(1));
     case "inspect": return parseInspect(argv.slice(1));
     case "events": return parseEvents(argv.slice(1));
-    case "menubar": {
-      const parsed = parseOptions(argv.slice(1), { ...JSON_SPEC, "--foreground": "flag", "--background": "flag" });
-      const positionals = parsed.positionals;
-      if (positionals.length > 1 || (positionals[0] !== undefined && !["install", "uninstall", "status", "start"].includes(positionals[0]))) throw new CliError("usage", "Use slopcamera menubar [--foreground|--background] or slopcamera menubar install|uninstall|status|start. See slopcamera help menubar.");
-      if (positionals[0] !== undefined && (optionFlag(parsed, "--foreground") || optionFlag(parsed, "--background"))) throw new CliError("usage", "Choose a menu-bar action or a run mode, not both.");
-      // `start` opens it now and returns, like --background; the login item's hints use it.
-      if (positionals[0] === "start") return { kind: "menubar", action: "run", mode: "background", json: optionFlag(parsed, "--json") };
-      return { kind: "menubar", action: (positionals[0] as "install" | "uninstall" | "status" | undefined) ?? "run", mode: optionFlag(parsed, "--background") ? "background" : "foreground", json: optionFlag(parsed, "--json") };
-    }
+    // Retired with the menu-bar companion; the old command name explains where it went.
+    case "menubar": throw new CliError("usage", "The menu bar was retired. Use slopcamera status or slopcamera tui to see what Slopcamera is doing, and slopcamera legacy retire to stop an old copy opening at login.");
     case "outputs": {
       const parsed = parseOptions(argv.slice(1), JSON_SPEC);
       exactPositionals(parsed, 0, "slopcamera outputs [--json]");

package/apps/desktop/cli/command-host-resources.ts

@@ -125,6 +125,11 @@ export function commandHostResourceClaims(
   coordinator: HostResourceCoordinator,
 ): readonly HostResourceClaim[] {
   switch (command.kind) {
+    case "html-film": return command.action === "deliver"
+      ? claims(coordinator, ["cpu", "ffmpeg", "local-io"])
+      : claims(coordinator, command.action === "preview"
+        ? ["cpu", "local-io", "browser", "ffmpeg"]
+        : ["cpu", "local-io", "browser"]);
     case "html-render": return command.dryRun
       ? claims(coordinator, ["cpu", "local-io"])
       : claims(coordinator, ["cpu", "local-io", "browser", "ffmpeg", "output-publication", "project-render"]);
@@ -261,7 +266,6 @@ export function commandHostResourceClaims(
     case "help":
     case "capabilities":
     case "inspect":
-    case "menubar":
     case "operations-list":
     case "operations-show":
     case "outputs":

package/apps/desktop/cli/commands.ts

@@ -1,4 +1,4 @@
-import { activityLabel, recordActivity, recordCredits } from "./menubar-status";
+import { activityLabel, recordActivity, recordCredits } from "./activity-status";
 import { reportUsefulResult, type UsefulResultObserver } from "../../../src/support-completion";
 import { SlopcameraCloudError } from "../../../src/cloud-errors";
 import {
@@ -188,8 +188,10 @@ import { commandHelp, completions } from "./help";
 import { createLocalSlopcameraCapabilityManifest } from "./capability-manifest";
 import { PlaywrightHtmlOverlayRenderer } from "./html-overlay-renderer";
 import { executeHtmlSceneCommand } from "./html-scene";
+import { executeHtmlFilmCommand, formatHtmlFilmResult } from "./html-film";
 import { BunProcessRunner, processIo, writeJson, writeLine, type CliIo, type ProcessRunner } from "./io";
-import { launchMenubar, manageMenubar, reportOutputsRoot } from "./menubar";
+import { reportOutputsRoot } from "./outputs";
+import { inspectLegacyLogin, retiredLegacyLogins } from "./legacy-login";
 import {
   codePreparationHostResourceClaims,
   combineHostResourceClaims,
@@ -363,7 +365,7 @@ import {
   workflowRunStore,
 } from "./workflow-runs";
 
-export const SLOPCAMERA_VERSION = "3.6.0";
+export const SLOPCAMERA_VERSION = "3.8.0";
 
 // Legacy direct renders predate per-target output contracts. Keep them
 // bounded generously enough for long-form production while preventing one
@@ -7450,6 +7452,16 @@ async function dispatch(context: CommandContext, command: CliCommand): Promise<v
       writeValue(context.io, command.json, output, () => JSON.stringify(output, null, 2));
       return;
     }
+    case "html-film": {
+      const output = await executeHtmlFilmCommand(applicationContext(context), command,
+        context.abortSignal ?? new AbortController().signal,
+        { progress: stage => context.io.stderr(`HTML film: ${stage}\n`) });
+      writeValue(context.io, command.json, output, () => formatHtmlFilmResult(output));
+      if (output.kind === "slopcamera.html-film-delivery" && !output.withinBudget) {
+        throw new CliError("invalid-data", "One or more delivered files are over budget.");
+      }
+      return;
+    }
     case "studio": {
       const output = await executeStudioCommand(applicationContext(context), command, context.abortSignal ?? new AbortController().signal);
       writeValue(context.io, command.json, output, () => JSON.stringify(output, null, 2));
@@ -7973,6 +7985,10 @@ async function dispatch(context: CommandContext, command: CliCommand): Promise<v
         platform: { architecture: process.arch, macOSVersion: macVersion.stdout.trim(), name: context.io.platform },
         repositoryRoot: context.paths.repositoryRoot,
         tools: Object.fromEntries(capabilities.map((capability) => [capability.name, capability])),
+        legacyLoginItem: {
+          ...inspectLegacyLogin(context.io.env.HOME),
+          retired: retiredLegacyLogins(context.io.env.HOME),
+        },
         version: context.version,
       };
       writeValue(context.io, command.json, output, () => [
@@ -7981,6 +7997,12 @@ async function dispatch(context: CommandContext, command: CliCommand): Promise<v
         `platform ${output.platform.name} ${output.platform.macOSVersion}`,
         ...capabilities.map((item) => `${item.name} ${item.available ? item.version ?? item.command : "unavailable"}`),
         `emoji ${emoji.provenance} ${emoji.installedCount}/${emoji.catalogCount}; generate: ${emoji.generationCommand}`,
+        output.legacyLoginItem.state === "found"
+          ? "login the old menu bar still opens at login; run: slopcamera legacy retire"
+          : output.legacyLoginItem.state === "not-ours"
+            ? `login ${output.legacyLoginItem.label ?? "an item"} was changed outside Slopcamera and is left alone`
+            : "login nothing starts at login",
+        ...output.legacyLoginItem.retired.map((item) => `retired ${item.path}; restore: ${item.restore}`),
       ].join("\n"));
       return;
     }
@@ -8021,11 +8043,6 @@ async function dispatch(context: CommandContext, command: CliCommand): Promise<v
     case "credits-forget": await handleCreditsForget(context, command); return;
     case "media-audio": await handleMediaAudio(context, command); return;
     case "media-color": await handleMediaColor(context, command); return;
-    case "menubar": {
-      if (command.action === "run") await launchMenubar(context.io, context.paths.repositoryRoot, command.json, command.mode);
-      else await manageMenubar(context.io, context.paths.repositoryRoot, command.action, command.json);
-      return;
-    }
     case "outputs": {
       await reportOutputsRoot(context.io, context.stateRoot, command.json);
       return;
@@ -8269,6 +8286,7 @@ type MutationReference =
 function commandMutationReference(command: CliCommand): MutationReference | undefined {
   switch (command.kind) {
     case "html-render": return undefined; // A fresh retained attempt owns its publication lease.
+    case "html-film": return undefined; // Fresh private job directories; outputs are plain caller files.
     case "studio": return undefined; // Native jobs and the machine custody marker own explicit leases.
     case "directing": return undefined; // The directing store owns its explicit lease.
     case "spatial-world": return undefined; // Immutable world attempts and imports own their publication custody.
@@ -8353,7 +8371,6 @@ function commandMutationReference(command: CliCommand): MutationReference | unde
     case "fillers-list":
     case "emoji-search":
     case "emoji-resolve":
-    case "menubar":
     case "outputs":
     case "complete": return undefined;
     // Fresh projects write outside an existing mutable bundle and publish by