@legionworks/facet 1.10.0 → 1.10.1

package/dist/gallery/{chunk-48emrxg6.js → chunk-0by8qn4x.js}

@@ -40,6 +40,9 @@ function buildFrameAttributes(src = "/gallery/frame") {
     src
   };
 }
+function usesArtifactStylesheet(artifactType) {
+  return artifactType === "html" || artifactType === "tsx";
+}
 function isLoopbackHostname(hostname) {
   return hostname === "127.0.0.1";
 }
@@ -5190,6 +5193,13 @@ function createArtifactFrame(options) {
       renderResult = handle;
       return handle;
     },
+    setTheme(theme) {
+      const api = raw.contentWindow?.__facetFrame;
+      if (api === null || api === undefined || typeof api.setTheme !== "function") {
+        throw new Error("frame theme API unavailable");
+      }
+      api.setTheme(theme);
+    },
     get renderResult() {
       return renderResult;
     }
@@ -5782,6 +5792,11 @@ async function startGallery(runtime = browserGalleryRuntime()) {
     const canCommit = () => themeGeneration === generation && nextMode === requestedThemeMode;
     if (!canCommit())
       return;
+    if (usesArtifactStylesheet(source.artifactType)) {
+      current.setTheme(nextResolvedTheme);
+      commitTheme(nextMode, nextResolvedTheme);
+      return;
+    }
     const next = createArtifactFrame({
       artifactType: source.artifactType,
       renderer: source.renderer,

package/dist/gallery/frame/artifact.css

@@ -5256,6 +5256,9 @@
   .mx-16 {
     margin-inline: calc(var(--spacing) * 16);
   }
+  .mx-auto {
+    margin-inline: auto;
+  }
   .my-0 {
     margin-block: 0px;
   }

package/dist/gallery/frame/chunks/{markdown-fvfncadf.js → markdown-g3asgaw3.js}

@@ -11,6 +11,9 @@ import {
 function isResolvedGalleryTheme(value) {
   return value === "dark" || value === "light";
 }
+function galleryDataTheme(theme) {
+  return theme === "light" ? "winter" : "night";
+}
 
 // src/gallery-web/frame/renderer-validation.ts
 function validateRenderer(value) {
@@ -395,6 +398,11 @@ function installGalleryFrameApi(registry) {
     setPointerEventsForAllChildren(container, mode === "panzoom" ? "none" : "");
   };
   const api = {
+    setTheme(theme) {
+      if (!isResolvedGalleryTheme(theme))
+        throw new FacetRenderError("frame theme is invalid", "invalid_request");
+      document.documentElement.dataset.theme = galleryDataTheme(theme);
+    },
     async render(payload) {
       if (rendered)
         throw new FacetRenderError("frame already rendered", "invalid_request");

package/dist/gallery/frame/frame.css

@@ -78,26 +78,7 @@ body {
   padding-inline: max(16px, calc((100% - 92ch) / 2));
 }
 
-/*
- * Native dashboard artifacts (html, interactive tsx) read top-down
- * like markdown — vertical stays start-aligned — but unlike markdown
- * their width is whatever the fixture authored (often a fixed-width
- * `max-w-*` container), not a fluid readable column. Left unstyled,
- * that narrow content sits pinned to the container's left edge,
- * stranding most of a wide desktop stage as dead space.
- *
- * The centering has to land on the renderer-ROOT element
- * (`.facet-html-root` / `#facet-tsx-mount`), not `#artifact` itself:
- * `renderHtml`/`renderTsx` always mount a single full-width wrapper
- * as `#artifact`'s only child, and the fixture's own narrow content
- * (e.g. `<main class="max-w-2xl">`) is a GRANDCHILD of `#artifact`
- * inside that wrapper — centering `#artifact`'s single full-width
- * child does nothing. `safe center` on the horizontal axis only —
- * the same fallback-to-start mechanism the standalone-diagram rule
- * above uses — centers content that fits and never clips content
- * wider than the stage (it start-aligns and stays reachable by
- * scroll instead).
- */
+/* These selectors match usesArtifactStylesheet in frame-html.ts; CSS cannot import it. */
 #artifact[data-facet-artifact-type="html"],
 #artifact[data-facet-artifact-type="tsx"] {
   display: flex;
@@ -106,10 +87,9 @@ body {
 
 #artifact[data-facet-artifact-type="html"] > [data-facet-renderer-root],
 #artifact[data-facet-artifact-type="tsx"] > [data-facet-renderer-root] {
-  display: flex;
-  justify-content: safe center;
-  align-items: flex-start;
-  /* A full-height root plus a sibling runtime error makes capture bounds grow on every viewport resize. */
+  /* Block flow preserves authored sibling order while keeping the renderer root a flex item of the stage. */
+  display: block;
+  /* Filling the stage keeps a sibling runtime-error line outside capture bounds as the viewport resizes. */
   flex: 1 0 auto;
 }
 

package/dist/gallery/frame/runtime/chart.js

@@ -3,7 +3,7 @@ import {
 } from "../chunks/markdown-zazx9h4n.js";
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-g3asgaw3.js";
 import {
   FacetRenderError,
   createRendererRegistry,

package/dist/gallery/frame/runtime/html.js

@@ -3,7 +3,7 @@ import {
 } from "../chunks/markdown-rd8w0ng9.js";
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-g3asgaw3.js";
 import {
   createRendererRegistry
 } from "../chunks/markdown-d1wfbs70.js";

package/dist/gallery/frame/runtime/markdown.js

@@ -1,6 +1,6 @@
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-g3asgaw3.js";
 import {
   createRendererRegistry,
   decodeArtifactBytes

package/dist/gallery/frame/runtime/mermaid.js

@@ -7,7 +7,7 @@ import"../chunks/markdown-h7pzv34e.js";
 import"../chunks/markdown-zazx9h4n.js";
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-g3asgaw3.js";
 import {
   createRendererRegistry
 } from "../chunks/markdown-d1wfbs70.js";

package/dist/gallery/frame/runtime/svg.js

@@ -3,7 +3,7 @@ import {
 } from "../chunks/markdown-zazx9h4n.js";
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-g3asgaw3.js";
 import {
   createRendererRegistry
 } from "../chunks/markdown-d1wfbs70.js";

package/dist/gallery/frame/runtime/tsx.js

@@ -3,7 +3,7 @@ import {
 } from "../chunks/markdown-rd8w0ng9.js";
 import {
   installGalleryFrameApi
-} from "../chunks/markdown-fvfncadf.js";
+} from "../chunks/markdown-g3asgaw3.js";
 import {
   RENDER_ERROR_ATTRIBUTE,
   appendRenderError,

package/dist/gallery/index.html

@@ -8,7 +8,7 @@
     
     
     
-  <link rel="stylesheet" crossorigin href="./chunk-2dge4gwb.css"><script type="module" crossorigin src="./chunk-48emrxg6.js"></script></head>
+  <link rel="stylesheet" crossorigin href="./chunk-2dge4gwb.css"><script type="module" crossorigin src="./chunk-0by8qn4x.js"></script></head>
   <body>
     <div id="facet-shell">
       <header id="facet-status">

package/docs/reference/cli.md

@@ -125,7 +125,7 @@ errors and next actions:
 | code                   | next action                                                                                                    |
 | ---------------------- | -------------------------------------------------------------------------------------------------------------- |
 | `artifact_not_found`   | Check the artifact ID and list the project.                                                                    |
-| `revision_not_found`   | Omit the SHA for latest read-back or use an existing SHA.                                                      |
+| `revision_not_found`   | Check that the artifact has a revision; omit the SHA for latest or use an existing SHA.                        |
 | `duplicate_revision`   | Reuse `error.details.revisionSha`; no new revision was stored.                                                 |
 | `output_unwritable`    | Fix the output directory, permissions, or rename target.                                                       |
 | `evidence_unavailable` | Run Tier 1 again or inspect retention and evidence paths.                                                      |

package/docs/reference/html.md

@@ -142,15 +142,15 @@ an included Tailwind utility outside this list can still render.
 
 ### Recommended Tailwind utilities
 
-`block`, `flex`, `grid`, `inline-flex`, `flex-col`, `flex-wrap`, `items-center`, `justify-between`, `justify-center`, `grid-cols-1`, `grid-cols-2`, `grid-cols-3`, `gap-2`, `gap-3`, `gap-4`, `gap-6`, `p-2`, `p-3`, `p-4`, `p-6`, `px-3`, `px-4`, `py-2`, `py-3`, `m-0`, `mt-2`, `mt-4`, `mb-2`, `mb-4`, `w-full`, `max-w-prose`, `max-w-2xl`, `text-xs`, `text-sm`, `text-base`, `text-lg`, `text-xl`, `text-2xl`, `font-medium`, `font-semibold`, `font-bold`, `leading-relaxed`, `text-left`, `text-center`, `text-right`, `text-legion-ink`, `text-legion-muted`, `text-legion-cyan`, `bg-legion-paper`, `bg-legion-ink`, `bg-legion-cyan`, `border`, `border-2`, `border-legion-line`, `rounded`, `rounded-box`, `overflow-x-auto`, `table`, `table-zebra`.
+`block`, `flex`, `grid`, `inline-flex`, `flex-col`, `flex-wrap`, `items-center`, `justify-between`, `justify-center`, `grid-cols-1`, `grid-cols-2`, `grid-cols-3`, `gap-2`, `gap-3`, `gap-4`, `gap-6`, `p-2`, `p-3`, `p-4`, `p-6`, `px-3`, `px-4`, `py-2`, `py-3`, `m-0`, `mt-2`, `mt-4`, `mb-2`, `mb-4`, `mx-auto`, `w-full`, `max-w-prose`, `max-w-2xl`, `text-xs`, `text-sm`, `text-base`, `text-lg`, `text-xl`, `text-2xl`, `font-medium`, `font-semibold`, `font-bold`, `leading-relaxed`, `text-left`, `text-center`, `text-right`, `text-legion-ink`, `text-legion-muted`, `text-legion-cyan`, `bg-legion-paper`, `bg-legion-ink`, `bg-legion-cyan`, `border`, `border-2`, `border-legion-line`, `rounded`, `rounded-box`, `overflow-x-auto`, `table`, `table-zebra`.
 
-59 recommended utilities.
+60 recommended utilities.
 
 ### Recommended daisyUI components
 
 `alert`, `badge`, `btn`, `card`, `stat`, `table`.
 
-6 recommended components · 64 documented recommendations.
+6 recommended components · 65 documented recommendations.
 
 <!-- VOCABULARY:END -->
 

package/docs/reference/mcp.md

@@ -11,9 +11,14 @@ bun add -g @legionworks/facet
 facet-mcp
 ```
 
-Releases through `1.9.0` ship a `facet-mcp` bin that cannot launch directly. Use the next release or newer. A local package built with this fix answered JSON-RPC `initialize` after a global install. The `npx -p @legionworks/facet facet-mcp` path still needs verification against that published release before it is recommended.
+Releases through `1.9.0` ship a `facet-mcp` bin that cannot launch: its entry file has no `#!/usr/bin/env bun` line. Use `1.10.0` or newer. With `1.10.0` on Bun `1.4.0`, each of these answered JSON-RPC `initialize` and listed six tools:
 
-Do not use `bunx -p @legionworks/facet facet-mcp` as the registration command without verifying the local Bun release. It exited immediately with status 1 on Bun `1.3.14` on the measured host; the same form also exited with status 1 under the available scratch Bun `1.4.0` runtime. These observations are environment-specific, so this caveat is not a universal claim about every Bun release or installation.
+- `bun add -g @legionworks/facet`, then `facet-mcp`
+- `npm i -g @legionworks/facet`, then `facet-mcp`
+- `npx -p @legionworks/facet facet-mcp`
+- `bunx -p @legionworks/facet facet-mcp`
+
+Run `npx -p` from outside a Facet checkout. Inside one, npx resolves the local project instead of the published package and fails with `facet-mcp: command not found`.
 
 The adapter resolves the CLI in this order: `FACET_CLI`, then `bun <adapter-relative-repository>/src/cli/main.ts`, then `facet` on `PATH`. Set `FACET_CLI` to an absolute CLI executable when the adapter should use another installation.
 
@@ -69,6 +74,14 @@ Set `FACET_HOME` in the host configuration when the adapter must use a non-defau
 
 Exactly one of `sourceText` or `file` is required. The adapter returns `invalid_request` when both or neither are supplied.
 
+Tier 0 means structure was parsed and compiled, not rendered. Request
+`facet_read_back` with `tier: "visual"` before reporting a render. Visual
+evidence covers the first rendered state of an interactive TSX artifact;
+later interaction is not validated and does not change the stored verdict.
+When testing by hand with the MCP Inspector CLI, `--tool-arg key=value` passes
+`\n` literally, so multi-line `sourceText` arrives as one line; pass `file`
+instead.
+
 The MCP surface has six artifact tools. Start a cold-home flow with `facet_create`, then call `facet_publish`, `facet_read_back`, and `facet_export`. Each tool advertises its input schema in `tools/list`; run `facet doctor` through the CLI.
 
 ## Result and error handling

package/docs/reference/tsx.md

@@ -74,7 +74,9 @@ has no host port or service capability.
 The TSX verifier loads the vendored `artifact.css` used by the gallery frame.
 A runtime error after initial render, such as one thrown by a click handler,
 appears as a gallery signal in an `aria-live="polite"` status region. It does
-not rewrite the immutable verdict and clears on revision swap or theme change.
+not rewrite the immutable verdict. It clears on revision swap. Switching the
+theme keeps the frame mounted, including interactive component state and any
+runtime error signal already displayed.
 
 Revision source remains immutable. Compilation creates derived bytes recorded at
 the run's `compiled_path`; TSX source export writes the original `.tsx` bytes.

package/docs/reference/validation.md

@@ -80,8 +80,8 @@ capture it emulates `prefers-reduced-motion: reduce` and awaits
 Tier 1 uses the same artifact-type layout rules as the gallery frame: Mermaid,
 SVG, and chart roots are safely centered on both axes, with oversized content
 remaining reachable by scrolling; Markdown is top-aligned in a horizontally
-centered column capped at about 92ch; HTML and TSX are top-aligned while their
-renderer roots are safely centered across the stage. The renderer-parity gate
+centered column capped at about 92ch; HTML and TSX use top-aligned document
+flow, where a fixed-width layout can center itself with `mx-auto`. The renderer-parity gate
 compares both the gallery and verifier renderer-module sets and CSS/stylesheet
 sets.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legionworks/facet",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "private": false,
   "keywords": [
     "artifacts",

package/skills/facet/SKILL.md

@@ -93,7 +93,7 @@ non-whitespace text; the verdict requires a screenshot.
 | ------------------------ | ---------------------------------------------------------------------------------------------------------------- |
 | `invalid_request`        | Correct the command flags, artifact type, or source bytes, then retry.                                           |
 | `artifact_not_found`     | List or create the artifact, then use its returned ID.                                                           |
-| `revision_not_found`     | Omit the SHA for latest, or replace it with a returned revision SHA.                                             |
+| `revision_not_found`     | Check that the artifact has a revision; omit the SHA for latest, or replace it with a returned revision SHA.     |
 | `duplicate_revision`     | Use `error.details.revisionSha` as the existing revision SHA; do not republish identical bytes.                  |
 | `evidence_unavailable`   | Request Tier 1 evidence for that revision before a render export, or export source instead.                      |
 | `output_unwritable`      | Choose a writable `--out` path, resolve collisions, or use `--force` deliberately.                               |
@@ -114,9 +114,8 @@ non-whitespace text; the verdict requires a screenshot.
 - With shell access, the CLI is the integration — MCP is for structured-tool-only hosts, even when the host owns an MCP client. On that surface, `facet_open_url` is safe because it always uses `--no-launch`.
 - For MCP registration, use `bun add -g @legionworks/facet` and the bare
   `facet-mcp` command, or the no-install fallback `npx -p @legionworks/facet
-facet-mcp`. The measured `bunx -p @legionworks/facet facet-mcp` form exited
-  with status 1 under Bun `1.3.14` and the available scratch Bun `1.4.0`; treat
-  that as an environment-specific caveat, not a universal Bun claim.
+facet-mcp` (`bunx -p` also works). Use `1.10.0` or newer; earlier releases
+  ship a `facet-mcp` bin that cannot launch.
 
 ## Deeper reference
 

package/src/gallery-web/app.ts

@@ -23,7 +23,12 @@
  * surfaces an error badge.
  */
 
-import { assertLoopbackHostname, buildFrameAttributes, type FrameAttributes } from "./frame-html";
+import {
+  assertLoopbackHostname,
+  buildFrameAttributes,
+  usesArtifactStylesheet,
+  type FrameAttributes,
+} from "./frame-html";
 import { planSwap, type SwapPlanStep } from "./swap";
 import { connectRevisionStream } from "./sse-client";
 import type { VerdictObserved } from "../shared/contracts/validation";
@@ -376,6 +381,7 @@ export interface CreatedArtifactFrame {
     payload: FrameRenderPayload,
     timeoutMs: number,
   ) => Promise<FrameRenderResultHandle>;
+  readonly setTheme: (theme: ResolvedGalleryTheme) => void;
   /** Handle from the last successful render (null before the first). */
   readonly renderResult: FrameRenderResultHandle | null;
 }
@@ -488,6 +494,14 @@ export function createArtifactFrame(options: CreateArtifactFrameOptions): Create
       renderResult = handle;
       return handle;
     },
+    setTheme(theme) {
+      // oxlint-disable-next-line no-underscore-dangle
+      const api = raw.contentWindow?.__facetFrame;
+      if (api === null || api === undefined || typeof api.setTheme !== "function") {
+        throw new Error("frame theme API unavailable");
+      }
+      api.setTheme(theme);
+    },
     get renderResult(): FrameRenderResultHandle | null {
       return renderResult;
     },
@@ -1309,6 +1323,11 @@ export async function startGallery(runtime = browserGalleryRuntime()): Promise<v
     const canCommit = (): boolean =>
       themeGeneration === generation && nextMode === requestedThemeMode;
     if (!canCommit()) return;
+    if (usesArtifactStylesheet(source.artifactType)) {
+      current.setTheme(nextResolvedTheme);
+      commitTheme(nextMode, nextResolvedTheme);
+      return;
+    }
     const next = createArtifactFrame({
       artifactType: source.artifactType,
       renderer: source.renderer,

package/src/gallery-web/frame/runtime.ts

@@ -1,5 +1,5 @@
 import { isTsxExecutionMode, type TsxExecutionMode } from "../../shared/tsx/execution";
-import { isResolvedGalleryTheme } from "../theme";
+import { galleryDataTheme, isResolvedGalleryTheme, type ResolvedGalleryTheme } from "../theme";
 
 import { validateRenderer } from "./renderer-validation";
 import {
@@ -80,6 +80,7 @@ interface DiagramRegionGestures {
 
 export interface GalleryFrameApi {
   render(payload: FrameRenderPayload): Promise<RenderResult>;
+  setTheme(theme: ResolvedGalleryTheme): void;
 }
 
 declare global {
@@ -410,6 +411,11 @@ export function installGalleryFrameApi(registry: RendererRegistry): void {
   };
 
   const api: GalleryFrameApi = {
+    setTheme(theme) {
+      if (!isResolvedGalleryTheme(theme))
+        throw new FacetRenderError("frame theme is invalid", "invalid_request");
+      document.documentElement.dataset.theme = galleryDataTheme(theme);
+    },
     async render(payload: FrameRenderPayload): Promise<RenderResult> {
       if (rendered) throw new FacetRenderError("frame already rendered", "invalid_request");
       const validated = validatePayload(payload);

package/src/gallery-web/frame/styles/artifact.css

@@ -5256,6 +5256,9 @@
   .mx-16 {
     margin-inline: calc(var(--spacing) * 16);
   }
+  .mx-auto {
+    margin-inline: auto;
+  }
   .my-0 {
     margin-block: 0px;
   }

package/src/gallery-web/frame/styles/frame.css

@@ -78,26 +78,7 @@ body {
   padding-inline: max(16px, calc((100% - 92ch) / 2));
 }
 
-/*
- * Native dashboard artifacts (html, interactive tsx) read top-down
- * like markdown — vertical stays start-aligned — but unlike markdown
- * their width is whatever the fixture authored (often a fixed-width
- * `max-w-*` container), not a fluid readable column. Left unstyled,
- * that narrow content sits pinned to the container's left edge,
- * stranding most of a wide desktop stage as dead space.
- *
- * The centering has to land on the renderer-ROOT element
- * (`.facet-html-root` / `#facet-tsx-mount`), not `#artifact` itself:
- * `renderHtml`/`renderTsx` always mount a single full-width wrapper
- * as `#artifact`'s only child, and the fixture's own narrow content
- * (e.g. `<main class="max-w-2xl">`) is a GRANDCHILD of `#artifact`
- * inside that wrapper — centering `#artifact`'s single full-width
- * child does nothing. `safe center` on the horizontal axis only —
- * the same fallback-to-start mechanism the standalone-diagram rule
- * above uses — centers content that fits and never clips content
- * wider than the stage (it start-aligns and stays reachable by
- * scroll instead).
- */
+/* These selectors match usesArtifactStylesheet in frame-html.ts; CSS cannot import it. */
 #artifact[data-facet-artifact-type="html"],
 #artifact[data-facet-artifact-type="tsx"] {
   display: flex;
@@ -106,10 +87,9 @@ body {
 
 #artifact[data-facet-artifact-type="html"] > [data-facet-renderer-root],
 #artifact[data-facet-artifact-type="tsx"] > [data-facet-renderer-root] {
-  display: flex;
-  justify-content: safe center;
-  align-items: flex-start;
-  /* A full-height root plus a sibling runtime error makes capture bounds grow on every viewport resize. */
+  /* Block flow preserves authored sibling order while keeping the renderer root a flex item of the stage. */
+  display: block;
+  /* Filling the stage keeps a sibling runtime-error line outside capture bounds as the viewport resizes. */
   flex: 1 0 auto;
 }
 

package/src/gallery-web/frame-html.ts

@@ -31,6 +31,10 @@ export function buildFrameAttributes(src = "/gallery/frame"): FrameAttributes {
   };
 }
 
+export function usesArtifactStylesheet(artifactType: string): boolean {
+  return artifactType === "html" || artifactType === "tsx";
+}
+
 export function buildFrameDocument(options: {
   artifactType: string;
   runtimeUrl: string;
@@ -45,7 +49,7 @@ export function buildFrameDocument(options: {
   return (
     `<!doctype html><html data-theme="${galleryDataTheme(theme)}"><head>` +
     `<meta charset="utf-8"><link rel="stylesheet" href="/gallery/frame/frame.css">` +
-    (artifactType === "html" || artifactType === "tsx"
+    (usesArtifactStylesheet(artifactType)
       ? `<link rel="stylesheet" href="/gallery/frame/artifact.css">`
       : "") +
     "</head><body>" +

package/src/harness-adapters/mcp/server.ts

@@ -145,7 +145,7 @@ export function createFacetMcpServer(): Server {
     ),
     facet_publish: defineTool(
       PublishToolSchema,
-      "Publish exactly one sourceText or local file. Check envelope.ok separately from data.verdict.status: stored verdict status error is not a transport failure.",
+      'Publish exactly one sourceText or local file. Check envelope.ok separately from data.verdict.status: a stored verdict status of error is not a transport failure. Tier 0 parses and compiles structure but is not rendered; call facet_read_back with tier: "visual" before reporting a render.',
       async (input) => {
         const source = publishSource(input);
         return invoke(buildFacetArgs("publish", { ...input, ...source }), source);
@@ -153,7 +153,7 @@ export function createFacetMcpServer(): Server {
     ),
     facet_read_back: defineTool(
       ReadBackToolSchema,
-      "Read back the latest or revision-bound stored verdict at Tier 0, Tier 1, or visual. Tier 1 and visual need browser evidence; inspect envelope.ok before verdict status.",
+      "Read back a stored verdict at Tier 0, Tier 1, or visual. Tier 1 and visual need browser evidence from the pinned browser; inspect envelope.ok before verdict status. Visual covers the first rendered state; later interaction is not validated and does not change the stored verdict.",
       async (input) => invoke(buildFacetArgs("read_back", input)),
     ),
     facet_status: defineTool(

package/src/service/dispatcher.ts

@@ -526,6 +526,12 @@ export async function dispatch(
           ? deps.repository.getLatestRevision(command.artifactId)
           : deps.repository.getRevisionBySha(command.artifactId, command.revisionSha);
       if (revision === null) {
+        if (deps.repository.getArtifactById(command.artifactId) === null) {
+          throw new FacetError("artifact_not_found", "Artifact not found", {
+            retryable: false,
+            details: { artifactId: command.artifactId },
+          });
+        }
         throw new FacetError("revision_not_found", "Revision not found", {
           retryable: false,
           details: {
@@ -614,6 +620,12 @@ export async function dispatch(
           ? deps.repository.getLatestRevision(command.artifactId)
           : deps.repository.getRevisionBySha(command.artifactId, command.revisionSha);
       if (revision === null) {
+        if (deps.repository.getArtifactById(command.artifactId) === null) {
+          throw new FacetError("artifact_not_found", "Artifact not found", {
+            retryable: false,
+            details: { artifactId: command.artifactId },
+          });
+        }
         throw new FacetError("revision_not_found", "Revision not found", {
           retryable: false,
           details: {

package/src/shared/html/style-vocabulary.ts

@@ -28,6 +28,7 @@ export const HTML_TAILWIND_CLASSES = [
   "mt-4",
   "mb-2",
   "mb-4",
+  "mx-auto",
   "w-full",
   "max-w-prose",
   "max-w-2xl",

package/templates/capacity-report.tsx

@@ -16,7 +16,7 @@ export default function CapacityReport() {
   const capacityPercent = Math.round((readyWorkers / workerCapacity) * 100);
 
   return (
-    <main className="max-w-2xl p-6 gap-6 flex flex-col bg-legion-paper text-legion-ink">
+    <main className="max-w-2xl mx-auto p-6 gap-6 flex flex-col bg-legion-paper text-legion-ink">
       <header className="flex flex-col gap-2">
         <div className="flex flex-wrap gap-2">
           <span className="badge">capacity report</span>

package/templates/fleet-dashboard.html

@@ -4,7 +4,7 @@
     <title>Fleet dashboard</title>
   </head>
   <body class="bg-legion-paper text-legion-ink leading-relaxed">
-    <main class="max-w-2xl p-6 gap-6 flex flex-col">
+    <main class="max-w-2xl mx-auto p-6 gap-6 flex flex-col">
       <header class="flex flex-col gap-2">
         <div class="flex flex-wrap gap-2 items-center">
           <span class="badge">operations</span>

package/templates/html-release-ledger.html

@@ -4,7 +4,7 @@
     <title>Release ledger</title>
   </head>
   <body class="bg-legion-paper text-legion-ink leading-relaxed">
-    <main class="max-w-2xl p-6 gap-6 flex flex-col">
+    <main class="max-w-2xl mx-auto p-6 gap-6 flex flex-col">
       <header class="flex flex-col gap-2">
         <div class="flex flex-wrap items-center justify-between gap-2">
           <span class="badge">release ledger</span>

package/templates/html-status-report.html

@@ -20,7 +20,7 @@
     <title>Status report</title>
   </head>
   <body class="bg-legion-paper text-legion-ink leading-relaxed">
-    <main class="max-w-2xl p-6 gap-4 flex flex-col">
+    <main class="max-w-2xl mx-auto p-6 gap-4 flex flex-col">
       <header class="flex flex-col gap-2">
         <h1 class="text-2xl font-bold">Status report</h1>
         <p class="text-legion-muted text-sm">

package/templates/incident-console.tsx

@@ -44,7 +44,7 @@ export default function IncidentConsole() {
   const criticalCount = incidents.filter((incident) => incident.severity === "critical").length;
 
   return (
-    <main className="max-w-2xl p-6 gap-6 flex flex-col bg-legion-paper text-legion-ink">
+    <main className="max-w-2xl mx-auto p-6 gap-6 flex flex-col bg-legion-paper text-legion-ink">
       <header className="flex flex-col gap-2">
         <div className="flex flex-wrap gap-2 items-center">
           <span className="badge">incident console</span>

package/templates/tsx-interactive-counter.tsx

@@ -4,7 +4,7 @@ export default function InteractiveCounter() {
   const [count, setCount] = useState(0);
 
   return (
-    <section className="card bg-legion-paper p-6 w-full max-w-prose">
+    <section className="card bg-legion-paper p-6 w-full max-w-prose mx-auto">
       <h1 className="text-2xl font-semibold text-legion-ink">Interactive counter</h1>
       <p className="text-legion-muted mt-2">Button presses: {count}</p>
       <button

package/templates/tsx-status-report.tsx

@@ -2,7 +2,7 @@ import React from "react";
 
 export default function StatusReport() {
   return (
-    <section className="card bg-legion-paper p-6 w-full max-w-prose">
+    <section className="card bg-legion-paper p-6 w-full max-w-prose mx-auto">
       <h1 className="text-2xl font-semibold text-legion-ink">Status report</h1>
       <p className="text-legion-muted mt-2">Verification state for the current release.</p>
       <section className="mt-4">