@hraness/slopcamera 3.5.0 → 3.7.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.4.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.
+- [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.4.0 release](https://github.com/hraness/slopcamera/releases/tag/v3.4.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.4.0/hraness-slopcamera-3.4.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,8 +103,9 @@ 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 can show
-the files in the agent outputs directory; `slopcamera menubar` runs a prebuilt
+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
@@ -105,14 +119,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
@@ -135,10 +149,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
 
@@ -157,7 +173,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,
@@ -173,12 +189,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,
@@ -194,7 +210,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
 
@@ -268,12 +284,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.
@@ -317,7 +333,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
@@ -348,7 +364,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).
 
@@ -412,4 +428,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,4 +1,4 @@
-# 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.
 

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.5.0" as const;
+export const SLOPCAMERA_APPLICATION_TOOL_VERSION = "slopcamera-3.7.0" as const;
 
 export const OPERATION_KINDS = [
   "scene.audit",

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
@@ -731,6 +733,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 +3690,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");
@@ -3659,8 +3719,10 @@ export function parseCliArgs(argv: readonly string[]): CliCommand {
     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"].includes(positionals[0]))) throw new CliError("usage", "Use slopcamera menubar [--foreground|--background] or slopcamera menubar install|uninstall|status. See slopcamera help menubar.");
+      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") };
     }
     case "outputs": {

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"]);

package/apps/desktop/cli/commands.ts

@@ -1,3 +1,4 @@
+import { activityLabel, recordActivity, recordCredits } from "./menubar-status";
 import { reportUsefulResult, type UsefulResultObserver } from "../../../src/support-completion";
 import { SlopcameraCloudError } from "../../../src/cloud-errors";
 import {
@@ -187,6 +188,7 @@ 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 {
@@ -362,7 +364,7 @@ import {
   workflowRunStore,
 } from "./workflow-runs";
 
-export const SLOPCAMERA_VERSION = "3.5.0";
+export const SLOPCAMERA_VERSION = "3.7.0";
 
 // Legacy direct renders predate per-target output contracts. Keep them
 // bounded generously enough for long-form production while preventing one
@@ -5548,6 +5550,7 @@ async function handleCreditsStatus(
   } catch (error) {
     throw creditsErrorToCli(error);
   }
+  recordCredits(context.stateRoot, { usd: balance.balance.usd, low: balance.lowBalance, checkedAt: context.clock() });
   const view = {
     configured: true,
     tokenSource: loaded.source,
@@ -7448,6 +7451,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));
@@ -8267,6 +8280,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.
@@ -8419,6 +8433,7 @@ async function resolveMutationTarget(
 export async function runCli(argv: readonly string[], dependencies: CliDependencies = {}): Promise<number> {
   const io = dependencies.io ?? processIo;
   let jsonRequested = argv.includes("--json") || argv.includes("--jsonl");
+  let activity: { readonly stateRoot: string; readonly label: string; readonly startedAt: number } | undefined;
   try {
     const command = parseCliArgs(argv);
     jsonRequested = "json" in command ? command.json : command.kind === "events" && command.format !== "human";
@@ -8513,6 +8528,11 @@ export async function runCli(argv: readonly string[], dependencies: CliDependenc
         ? {}
         : { renderGalleryScene: dependencies.renderGalleryScene }),
     };
+    const label = activityLabel(command);
+    if (label !== undefined) {
+      activity = { stateRoot, label, startedAt: context.clock() };
+      recordActivity(stateRoot, { state: "running", label, startedAt: activity.startedAt });
+    }
     const mutationTarget = await resolveMutationTarget(paths, stateRoot, command);
     await withCommandHostResources(context, command, async admittedContext => {
       if (mutationTarget === undefined) {
@@ -8535,9 +8555,15 @@ export async function runCli(argv: readonly string[], dependencies: CliDependenc
       || command.kind === "project-render" && command.action === "run" && !command.dryRun) {
       reportUsefulResult(dependencies.onUsefulResult);
     }
+    if (activity !== undefined) {
+      recordActivity(activity.stateRoot, { state: "done", label: activity.label, startedAt: activity.startedAt, finishedAt: io.now().getTime() });
+    }
     return 0;
   } catch (error) {
     const failure = asCliError(error);
+    if (activity !== undefined) {
+      recordActivity(activity.stateRoot, { state: "failed", label: activity.label, startedAt: activity.startedAt, finishedAt: io.now().getTime(), error: failure.code });
+    }
     const payload = {
       error: {
         code: failure.code,

package/apps/desktop/cli/help.ts

@@ -1,9 +1,11 @@
+import { slopcameraSupportAdvancedHelp, slopcameraSupportHelpLine } from "../../../src/support";
+
 import { HTML_OVERLAY_SCAFFOLD_KINDS } from "../html-overlay";
 
 const HTML_OVERLAY_SCAFFOLD_KIND_HELP =
   HTML_OVERLAY_SCAFFOLD_KINDS.join("|");
 
-const GLOBAL_HELP = `slopcamera: a media studio for coding agents
+const globalHelp = () => `slopcamera: a media studio for coding agents
 
 Usage: slopcamera <command> [options]
 
@@ -23,7 +25,8 @@ Commands:
                                  Author and render retained Blender, CAD and Manim productions
   image vectorize|generate|gallery|icon
                                  Create local SVGs, generated images, or review galleries
-  html catalog|scaffold|render   Author HTML scenes and export video with local audio
+  html catalog|scaffold|init|render|still|preview|deliver
+                                 Author HTML scenes and launch films, render, and deliver web video
   style list|show                Discover reusable art direction and review criteria
   workflows list|show|plan|run   Plan or run a reviewed reusable workflow
   code init|check|plan|run       Author, preflight, and run trusted TypeScript workflows
@@ -35,11 +38,6 @@ Commands:
   credits status|topup|wait|forget
                                  Buy and inspect hosted generation credits
   media audio|color              Apply local non-destructive audio and video effects
-  menubar [--foreground|--background]
-                                 Show your outputs in the menu bar
-  menubar install|uninstall|status  Open it at login, stop that, or check it
-  support [--json|protocol --json|offer --json|shown <id>|release <id>|dismiss|snooze|enable|status --json]
-                                 Optional support; no feature requires payment
   outputs                        Print the agent outputs directory
   recordings list               List recording bundles
   projects list|create           List projects or create one from a recording
@@ -63,19 +61,21 @@ Examples:
   slopcamera render run REC --output out.mp4  Render a recording
 
 Run slopcamera help <command> for command-specific help.
-Optional support: slopcamera support · Turn off: HRANESS_SUPPORT_AUDIENCE=off`;
+${slopcameraSupportHelpLine()}`;
 
 const HELP: Readonly<Record<string, string>> = {
+  advanced: `${slopcameraSupportAdvancedHelp()}`,
   menubar: `Usage:
   slopcamera menubar [--foreground|--background] [--json]
-  slopcamera menubar install|uninstall|status [--json]
+  slopcamera menubar install|uninstall|status|start [--json]
 
-Shows 📷 in the menu bar with your recent outputs. It only lists and opens
-files in the outputs folder (slopcamera outputs).
+Shows what Slopcamera is doing in the menu bar: a render in progress, how the
+last job ended and your last known credits balance, plus your newest outputs.
+It only reads that status and the outputs folder (slopcamera outputs).
 
   menubar               Open it now; it closes when this command ends
-  menubar --background  Open it now and return
-  menubar install       Open it now and every time you log in
+  menubar start         Open it now and return (same as --background)
+  menubar install       Open it every time you log in
   menubar uninstall     Stop opening it at login and remove the installed copy
   menubar status        Check whether it opens at login and is running
 
@@ -83,9 +83,10 @@ If it's already in your menu bar, starting it again says so and succeeds.
 macOS shows a notice that slopcamera-menubar can open at login. Turn it off any
 time in System Settings › General › Login Items & Extensions.
 
-The menu bar isn't in released packages yet. In a Slopcamera checkout, build it
-with cargo build --release --manifest-path desktop/Cargo.toml and slopcamera
-finds it; elsewhere, set SLOPCAMERA_MENUBAR to the built file.`,
+The menu bar isn't in released packages yet, so it isn't listed in
+slopcamera help. In a Slopcamera checkout, build it with
+cargo build --release --manifest-path desktop/Cargo.toml and slopcamera finds
+it; elsewhere, set SLOPCAMERA_MENUBAR to the built file.`,
   capabilities: `Usage: slopcamera capabilities [--json]
 
 Print the exact statically assembled capability manifest for this CLI build. Each module owns named operation, workflow, MCP-tool, command, and runtime-profile identities. The manifest includes trust classes, resource/effect policies, runtime requirements, qualification status, and a canonical SHA-256. It reads no workspace source, loads no plugin, probes no runtime, and grants no authority. Use doctor separately to inspect this machine's currently available executables.`,
@@ -304,7 +305,11 @@ compliance. Drawing sheets are exposed through this CLI and the root SDK, not co
         [--cell <n>] [--tile|--no-tile] [--json]
   slopcamera image icon <subject> --output <file.svg>
         [--purpose <mark|illustration>] [--model <model>] [--ink <#rgb>]
+        [--context <card|hero|inline>] [--candidates <1-4>]
         [--rounds <1-4>] [--critique-model <model>] [--keep-raster] [--json]
+  slopcamera image icon --set <file.json> --output-dir <directory>
+        [--context <card|hero|inline>] [--candidates <1-4>]
+        [--set-rounds <1-4>] [--keep-raster] [--json]
 
 Explicit --output file commands delegate to @hraness/slopcamera. Vectorization is local,
 bounded, checksum-pinned, and emits inert SVG. File generation uses Vercel AI Gateway with the
@@ -312,7 +317,10 @@ caller's environment credential. The --prompt spelling without --output is an al
 content-addressed \`ai image generate\` lane and returns project-composable content hash references.
 Icon combines a style-locked Gateway raster, local ink extraction and VTracer tracing into a
 canonical isometric line-art SVG; --rounds above 1 adds a vision-model critique that revises the
-prompt between attempts. Gallery fans one subject out to bounded parallel candidates — driven by
+prompt between attempts. --context tunes the prompt and gates to where the art lands, and --set
+generates a manifest-declared family at once: pooled candidates, joint selection toward the
+family's measured coverage and stroke median, and a contact-sheet critique of the whole set before
+anything publishes. Gallery fans one subject out to bounded parallel candidates — driven by
 variation axes or an explicit candidate list — keeps every candidate with its provenance, and
 composes a labelled contact sheet plus receipt for agent review. Texture cells repeat the
 candidate 2×2 so seams are inspectable (--tile/--no-tile overrides). It never replaces existing
@@ -330,7 +338,12 @@ direction, not proof of visual quality or historically authentic footage.`,
   html: `Usage:
   slopcamera html catalog [--json]
   slopcamera html scaffold <${HTML_OVERLAY_SCAFFOLD_KIND_HELP}> --output <file.html>
+  slopcamera html init <dir> --template launch-film [--aspect 16:9|1:1|9:16] [--json]
   slopcamera html render --input <scene.json> [--dry-run] [--json]
+  slopcamera html still --input <scene.json> --at <seconds>[,<seconds>...] --output <dir> [--json]
+  slopcamera html preview --input <scene.json> --output <dir> [--every <seconds>] [--json]
+  slopcamera html deliver <export.json> --basename <name> --poster-at <seconds> --social-at <seconds>
+      [--cuts 1:1,9:16,4:5] [--per-beat-clips] [--beats <beats.json>] [--output <dir>] [--json]
 
 Catalog lists the closed scaffold profiles in stable order with their primary jobs, render
 substrates, and current exact browser-library versions. Scaffold creates a complete transparent
@@ -344,7 +357,16 @@ with separate scene-video and original-audio tracks. Device dimensions must be e
 Duration rounds up to whole frames; audio starts at zero and is trimmed or padded to that
 duration. Soundtracks encode as 48 kHz stereo AAC at 320 kb/s. Dry run checks source and
 workload bounds without launching a browser, importing audio, or writing project state.
-Progress uses stderr; --json keeps stdout machine-readable.`,
+Progress uses stderr; --json keeps stdout machine-readable.
+
+Init creates a launch-film project (film.html, film.css, film.js, build.ts and a sample
+product mockup) in a new directory. Its build writes out/scene.json, out/beats.json and
+out/captions.vtt. Still and preview draw frames with the same injected runtime that render
+uses, so a still matches the rendered frame at that time; preview adds a contact sheet.
+Deliver reads output.path from html render --json output and writes a faststart H.264 MP4,
+a VP9 WebM, a poster, a 1200x630 social still, optional aspect cuts over a blurred fill, and
+optional 6 to 10 second clips per beat. It prints a receipt per file and exits non-zero when
+a file is over its budget: 12 MB per MP4, 10 MB for the WebM, 250 KB per JPEG.`,
   operations: `Usage:
   slopcamera operations list [--json]
   slopcamera operations show <kind>[@<version>] [--json]
@@ -701,8 +723,8 @@ Long inactivity is analyzed and removed by default; use --keep-inactivity to opt
 };
 
 export function commandHelp(topic: readonly string[]): string {
-  if (topic.length === 0) return GLOBAL_HELP;
-  return HELP[topic[0]!] ?? GLOBAL_HELP;
+  if (topic.length === 0) return globalHelp();
+  return HELP[topic[0]!] ?? globalHelp();
 }
 
 export function completions(words: readonly string[]): readonly string[] {
@@ -712,7 +734,7 @@ export function completions(words: readonly string[]): readonly string[] {
   if (words.length <= 1) return topLevel;
   const command = words[0];
   if (command === "support") return ["protocol", "offer", "shown", "release", "dismiss", "snooze", "enable", "status"];
-  if (command === "html") return ["catalog", "scaffold", "render"];
+  if (command === "html") return ["catalog", "scaffold", "init", "render", "still", "preview", "deliver"];
   if (command === "style") return ["list", "show"];
   if (command === "direct") return ["init", "anchor", "plan", "start", "inspect", "revise", "generate", "resume", "review", "assemble", "cleanup"];
   if (command === "studio") return words[2] === "assets" || words[1] === "assets" ? ["search", "describe", "plan", "import"] : ["init", "bundle", "plan", "probe", "run", "encode", "asset", "assemble", "inspect", "reconcile", "assets"];