gutterpress 0.11.11-alpha.1 → 0.11.11-alpha.2

package/README.md

@@ -170,9 +170,9 @@ gutterpress new <name> [--kind <id>] [options]
 
 ### `gutterpress preview`
 
-Live HTML preview server by default. A single Markdown edit is rendered and
-spliced as one chapter over WebSocket; CSS, manifest, multi-file, deletion, and
-other structural changes reload the full document. This path is pure JS and
+Live HTML preview server by default. Every change — a single Markdown edit,
+CSS, manifest, multi-file, deletion, or other structural change — reloads the
+full document over WebSocket. This path is pure JS and
 needs no external tools. Pass `--format pdf` or `--format pdfx` for a one-shot
 build-and-open instead. `--manifest` applies only to those one-shot PDF/PDF-X
 modes; live HTML preview discovers the project manifest from its input

package/dist/api/index.js

@@ -127,10 +127,10 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "../index-wdqymw2k.js";
+} from "../index-ssjh6tnd.js";
 import {
   BuildError
-} from "../index-b7q4wev1.js";
+} from "../index-mw8b25yx.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/{build-ycaavzsb.js → build-pjd42x09.js}

@@ -1,18 +1,18 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-g3xd0x9z.js";
+} from "./cli-d2he8zph.js";
 import {
   log
-} from "./cli-kgd355eh.js";
+} from "./cli-1kdtzgxm.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-wtw5nfsx.js";
-import"./cli-p40641zw.js";
+} from "./cli-ny50k8md.js";
+import"./cli-tjhn2mdn.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/checks/asset/extensions.d.ts

@@ -1,8 +1,8 @@
 /**
  * Canonical file-extension sets shared by every asset check.
  *
- * Keeping these in ONE place prevents the divergent glob lists that previously
- * let some formats be size-checked but silently skipped by the header-reader
+ * Keeping these in ONE place prevents divergent glob lists that would let
+ * some formats be size-checked but silently skipped by the header-reader
  * checks. Divergence here is a validation-coverage bug, so the sets and their
  * relationship are pinned by image-extension-coverage.test.ts.
  */

package/dist/checks/policy.d.ts

@@ -31,13 +31,11 @@ export interface CheckSelection {
 }
 /**
  * The check-selection sequence shared by {@link runChecks} and
- * {@link checkToolAvailability} (audit E10): resolve `only`/`skip` selectors,
- * then drop manifest-disabled checks via {@link isCheckEnabled}. Extracted so
- * the two callers can never disagree on WHICH checks are in scope — previously
- * this exact three-step sequence was hand-copied in both, kept in sync only by
- * a comment. Returns `unmatched` selectors so each caller decides whether to
- * surface them (the runner errors on them; tool probing deliberately ignores
- * them to avoid double-warning).
+ * {@link checkToolAvailability}: resolve `only`/`skip` selectors, then drop
+ * manifest-disabled checks via {@link isCheckEnabled}. Shared so the two
+ * callers can never disagree on WHICH checks are in scope. Returns `unmatched`
+ * selectors so each caller decides whether to surface them (the runner errors
+ * on them; tool probing deliberately ignores them to avoid double-warning).
  */
 export declare function selectChecks(opts: CheckSelectionOptions, config: ResolvedConfig): CheckSelection;
 /**

package/dist/checks/register-builtins.d.ts

@@ -1,12 +1,12 @@
 /**
- * Central registration of the built-in checks (audit B5).
+ * Central registration of the built-in checks.
  *
  * The check registry (registry.ts) is a module-level Map populated purely as a
- * side effect of importing each category's index module. Those four imports
- * previously lived only in `lib/validation-exec.ts`, so `runChecks`/`getChecks`
- * reached any other way (a direct import of `checks/runner`, a reordering of the
- * package entry's re-exports) would see an EMPTY registry and silently validate
- * nothing. Importing THIS module makes the registry self-populating regardless
+ * side effect of importing each category's index module. If those four
+ * imports lived in one caller, `runChecks`/`getChecks` reached any other way
+ * (a direct import of `checks/runner`, a reordering of the package entry's
+ * re-exports) would see an EMPTY registry and silently validate nothing.
+ * Importing THIS module makes the registry self-populating regardless
  * of who the first caller is; `runner.ts` imports it at load, so anything that
  * can reach `runChecks` has already registered the built-ins. ESM evaluates a
  * module once, so importing this from several places registers exactly once.

package/dist/checks/registry.d.ts

@@ -24,7 +24,7 @@ export declare function getAllCheckIds(): string[];
  * Derived from the registry (rather than a hand-maintained literal list) so
  * it can never drift from `CheckCategory`'s real members — used to validate
  * `--category` input against something other than a bare `as CheckCategory`
- * cast, which previously accepted any string.
+ * cast, which would accept any string.
  */
 export declare function getKnownCategories(): CheckCategory[];
 export interface ResolvedSelectors {

package/dist/{cli-kgd355eh.js → cli-1kdtzgxm.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-wtw5nfsx.js";
+} from "./cli-ny50k8md.js";
 import {
   execCapture,
   findTool,

package/dist/{cli-g3xd0x9z.js → cli-d2he8zph.js}

@@ -13,17 +13,17 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-kgd355eh.js";
+} from "./cli-1kdtzgxm.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-wtw5nfsx.js";
+} from "./cli-ny50k8md.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
   getAssetsDir
-} from "./cli-p40641zw.js";
+} from "./cli-tjhn2mdn.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
@@ -3690,8 +3690,8 @@ var GUTTERPRESS_CSS = `
 
 /* the per-shape decisions the paragraph above deliberately leaves to the
    author, named instead of left as raw CSS every book was reinventing
-   (2026-09-01 CSS architecture review, findings C1/C7 — CLAUDE.md §0:
-   "behavior broadly useful to non-technical authors belongs in core").
+   (CLAUDE.md §0: "behavior broadly useful to non-technical authors belongs
+   in core").
    Permanent vocabulary, standard properties verbatim — same rationale as
    the column/grid runs above. One name each, no aliases:
      .gp-columns-all       column-span: all      a heading or block that
@@ -7728,7 +7728,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path8.join(stage, "raw.pdf") : path8.resolve(pdfFile);
       await fsp2.mkdir(path8.dirname(path8.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-fv61tyn7.js");
+      const { buildNativePdf } = await import("./engine-132czsq9.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,

package/dist/{cli-wtw5nfsx.js → cli-ny50k8md.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.11-alpha.1",
+  version: "0.11.11-alpha.2",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",

package/dist/{cli-p40641zw.js → cli-tjhn2mdn.js}

@@ -1109,13 +1109,13 @@ var favicon_default = "./favicon-wkbm9cjn.ico";
 var manifest_schema_default = "./manifest.schema-61bsspsb.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-x22vcqyw.js";
+var preview_interface_default = "./preview-interface-twd6nsf5.js";
 
 // src/assets/preview/scripts/preview-bridge.js
-var preview_bridge_default = "./preview-bridge-b4jbtb79.js";
+var preview_bridge_default = "./preview-bridge-8jhd1wpb.js";
 
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-tqndvhbx.js";
+var preview_shell_default = "./preview-shell-y8yrm3f0.js";
 
 // profiles/CGATS21_CRPC1.icc
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-wtw5nfsx.js";
+} from "./cli-ny50k8md.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -18,14 +18,14 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-c6pmpvhw.js").then((m) => m.default),
-  preview: () => import("./preview-6n5ava6c.js").then((m) => m.default),
-  build: () => import("./build-ycaavzsb.js").then((m) => m.default),
-  publish: () => import("./publish-9an2a1ma.js").then((m) => m.default),
-  validate: () => import("./validate-0rrjva48.js").then((m) => m.default),
-  preflight: () => import("./preflight-9vq1ygh4.js").then((m) => m.default),
-  doctor: () => import("./doctor-71dxjkpz.js").then((m) => m.default),
-  ext: () => import("./ext-rkfntmtv.js").then((m) => m.default)
+  new: () => import("./new-7w4ezfpy.js").then((m) => m.default),
+  preview: () => import("./preview-y39jrpbs.js").then((m) => m.default),
+  build: () => import("./build-pjd42x09.js").then((m) => m.default),
+  publish: () => import("./publish-tvj3xh8m.js").then((m) => m.default),
+  validate: () => import("./validate-9enr4ecc.js").then((m) => m.default),
+  preflight: () => import("./preflight-f3h6arjp.js").then((m) => m.default),
+  doctor: () => import("./doctor-qkh9byxa.js").then((m) => m.default),
+  ext: () => import("./ext-271xnh70.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -50,7 +50,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-c6pmpvhw.js");
+      const { newArgs } = await import("./new-7w4ezfpy.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed = parseArgs(commandArgs, {
         ...newArgs,
@@ -62,7 +62,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-9vq1ygh4.js");
+      const { preflightArgs } = await import("./preflight-f3h6arjp.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -82,7 +82,7 @@ async function preflightRequiredInvocations(rawArgs) {
       }
       if (subcommand.startsWith("-"))
         return;
-      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-rkfntmtv.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-271xnh70.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-71dxjkpz.js → doctor-qkh9byxa.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-kgd355eh.js";
+} from "./cli-1kdtzgxm.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-wtw5nfsx.js";
+} from "./cli-ny50k8md.js";
 import"./cli-46ycxe6r.js";
 import"./cli-7fkhgtfn.js";
 import"./cli-37x76zdn.js";

package/dist/engine/shared/cdp.d.ts

@@ -20,11 +20,9 @@
  * `getComputedStyle(el, '::after').content` instead of trusting
  * `CSS.supports` — i.e. the thing that actually defends against this class of
  * silent-content-loss regression is the probe, not the milestone pin. Measured
- * 148 vs 151 head-to-head: the spike suite differs in exactly 2 checks (both
- * assertions ABOUT Chromium's parse-vs-drop behaviour, now written to accept
- * either regime — see spike/native-engine s0/s2), the parity gate output is
- * byte-identical, and real 34pp/53pp book builds produce identical page counts
- * and sizes on both milestones. So 151 was a *floor for the incident's
+ * 148 vs 151 head-to-head: the parity gate output is byte-identical, and real
+ * 34pp/53pp book builds produce identical page counts and sizes on both
+ * milestones. So 151 was a *floor for the incident's
  * discovery*, not a requirement of the fix. It is pinned rather than probed —
  * running on anything below 148 is still an error rather than a guess — but
  * 148 is the honestly-supported floor because it's also what Electron's
@@ -32,10 +30,8 @@
  * desktop app needs to drive its own Chromium for native-engine PDF export
  * (see packages/desktop/electron's engine-browser module). Raising or
  * lowering this floor again means re-measuring and treating every changed
- * measurement as a finding, same as before — but the `spike/folio/spikes/`
- * harness that produced these numbers (`bun run spikes`) was deleted with
- * the rest of the pre-native-engine scaffolding and no command in this repo
- * re-runs it, so it would have to be rebuilt first. See the provenance note
+ * measurement as a finding. No command in this repo re-runs that
+ * measurement, so it would have to be rebuilt first. See the provenance note
  * at the top of docs/engine/ENGINE.md.
  */
 export declare const REQUIRED_MILESTONE = 148;

package/dist/engine/shared/pdf-inspect.d.ts

@@ -1,4 +1,3 @@
-export declare const PT_PER_IN = 72;
 export interface PageBoxes {
     media: number[];
     crop?: number[];
@@ -19,6 +18,3 @@ export interface PdfFacts {
     }>;
 }
 export declare function inspectPdf(bytes: Uint8Array): Promise<PdfFacts>;
-/** Extract per-page text as a rough sanity channel (not used for measurement). */
-export declare function ptToIn(pt: number): number;
-export declare function boxesEqual(a: number[] | undefined, b: number[], tol?: number): boolean;

package/dist/{engine-fv61tyn7.js → engine-132czsq9.js}

@@ -1,6 +1,6 @@
 import {
   build
-} from "./cli-p40641zw.js";
+} from "./cli-tjhn2mdn.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";

package/dist/{engine-sq1kpg5s.js → engine-bgd4aa99.js}

@@ -1,9 +1,9 @@
 import {
   build
-} from "./index-dxt4t7et.js";
+} from "./index-b6p1fh61.js";
 import {
   BuildError
-} from "./index-b7q4wev1.js";
+} from "./index-mw8b25yx.js";
 import"./index-rzm1phg0.js";
 import"./index-37x76zdn.js";
 

package/dist/{ext-rkfntmtv.js → ext-271xnh70.js}

@@ -10,16 +10,16 @@ import {
   removeExtension,
   searchNpmExtensions,
   setExtensionEnabled
-} from "./cli-g3xd0x9z.js";
-import"./cli-kgd355eh.js";
+} from "./cli-d2he8zph.js";
+import"./cli-1kdtzgxm.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-wtw5nfsx.js";
-import"./cli-p40641zw.js";
+} from "./cli-ny50k8md.js";
+import"./cli-tjhn2mdn.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";

package/dist/{index-dxt4t7et.js → index-b6p1fh61.js}

@@ -3,7 +3,7 @@ import {
   isIgnoredMarginBoxProperty,
   marginBoxAlign,
   marginBoxRectPt
-} from "./index-b7q4wev1.js";
+} from "./index-mw8b25yx.js";
 import {
   launchChromium
 } from "./index-rzm1phg0.js";

package/dist/{index-b7q4wev1.js → index-mw8b25yx.js}

@@ -29,13 +29,13 @@ var favicon_default = "./favicon-wkbm9cjn.ico";
 var manifest_schema_default = "./manifest.schema-61bsspsb.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-x22vcqyw.js";
+var preview_interface_default = "./preview-interface-twd6nsf5.js";
 
 // src/assets/preview/scripts/preview-bridge.js
-var preview_bridge_default = "./preview-bridge-b4jbtb79.js";
+var preview_bridge_default = "./preview-bridge-8jhd1wpb.js";
 
 // src/assets/preview/scripts/preview-shell.js
-var preview_shell_default = "./preview-shell-tqndvhbx.js";
+var preview_shell_default = "./preview-shell-y8yrm3f0.js";
 
 // profiles/CGATS21_CRPC1.icc
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";

package/dist/{index-wdqymw2k.js → index-ssjh6tnd.js}

@@ -4,7 +4,7 @@ import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   getAssetPath,
   getAssetsDir
-} from "./index-b7q4wev1.js";
+} from "./index-mw8b25yx.js";
 import {
   INSTALL_HINTS,
   execCapture,
@@ -1575,8 +1575,8 @@ var GUTTERPRESS_CSS = `
 
 /* the per-shape decisions the paragraph above deliberately leaves to the
    author, named instead of left as raw CSS every book was reinventing
-   (2026-09-01 CSS architecture review, findings C1/C7 — CLAUDE.md §0:
-   "behavior broadly useful to non-technical authors belongs in core").
+   (CLAUDE.md §0: "behavior broadly useful to non-technical authors belongs
+   in core").
    Permanent vocabulary, standard properties verbatim — same rationale as
    the column/grid runs above. One name each, no aliases:
      .gp-columns-all       column-span: all      a heading or block that
@@ -3858,7 +3858,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.11.11-alpha.1",
+  version: "0.11.11-alpha.2",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -8218,7 +8218,7 @@ class PdfOutput {
       const rawPdf = pdfxMode ? path8.join(stage, "raw.pdf") : path8.resolve(pdfFile);
       await fsp2.mkdir(path8.dirname(path8.resolve(pdfFile)), { recursive: true });
       log.info("Rendering HTML to PDF via the Gutterpress engine (native Chromium pagination)");
-      const { buildNativePdf } = await import("./engine-sq1kpg5s.js");
+      const { buildNativePdf } = await import("./engine-bgd4aa99.js");
       const engineDiagnostics = await buildNativePdf(htmlFile, rawPdf, {
         title: config.title,
         author: config.authors.length > 0 ? config.authors.join(", ") : undefined,

package/dist/index.js

@@ -144,13 +144,13 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "./index-wdqymw2k.js";
+} from "./index-ssjh6tnd.js";
 import {
   BUILD_DIAGNOSTIC_CODES
-} from "./index-dxt4t7et.js";
+} from "./index-b6p1fh61.js";
 import {
   BuildError
-} from "./index-b7q4wev1.js";
+} from "./index-mw8b25yx.js";
 import {
   DEFAULT_PRINT_OPTS,
   assertMilestone,

package/dist/lib/asset-inline.d.ts

@@ -61,8 +61,7 @@ export declare function escapesProjectRoot(projectDir: string, absPath: string):
  * `source.links.local-refs` check consume, so validation and the build agree
  * on the rule — an image referenced from Markdown prose must live inside the
  * book folder — AND on the exact decode (`stripUrlSuffix(decodeRef(...))`) and
- * wording. They previously hand-rolled this apart and had already drifted (the
- * check decoded without stripping the `?query`/`#frag` suffix).
+ * wording.
  */
 export declare function proseImageRefError(ref: string, projectDir: string): string | null;
 /**

package/dist/lib/build-error.d.ts

@@ -1,5 +1,5 @@
 /**
- * The CLI's exit-code contract (UX finding M47) — ONE place the numbers are
+ * The CLI's exit-code contract — ONE place the numbers are
  * defined. Every command's process exit code means the same thing across
  * `build`/`preview`/`validate`/`preflight`/`publish`/`ext`/`new`/`doctor`,
  * so CI can branch on it without parsing output:
@@ -9,11 +9,9 @@
  *                  failures (validate/preflight findings, a build's
  *                  quality-gate rejection). The invocation itself was fine;
  *                  the content wasn't. `gutterpress build`'s CSS
- *                  print-safety check (`source.stylelint`) now runs as one
- *                  of pre-build validation's checks (#272 — one CSS gate,
- *                  not two) and fails the build through this same code; the
- *                  `build` pipeline's former separate CSS-lint gate, and its
- *                  own exit code 2, are gone.
+ *                  print-safety check (`source.stylelint`) runs as one of
+ *                  pre-build validation's checks (#272 — one CSS gate, not
+ *                  two) and fails the build through this same code.
  *   2  USAGE     — the invocation itself was wrong: a bad flag, positional,
  *                  preset, or value. See {@link UsageError} in ./cli-args.ts.
  *   3  PIPELINE  — the build/render/export pipeline failed for a reason

package/dist/lib/build-fingerprint.d.ts

@@ -15,10 +15,9 @@ export type BuildFingerprintInput = {
      * These are the same for a caller that writes straight to its destination, but
      * a build always assembles into a scratch work dir and only then publishes it
      * atomically — so the file must be created in the work dir while the value
-     * anyone later reads has to be the delivered destination. One field served both
-     * roles, so shipped fingerprints recorded a scratch path
-     * (`.dist-build-a1b2c3…`, or an OS temp dir) that no longer existed
-     * (2026-07-29 audit).
+     * anyone later reads has to be the delivered destination. One field for both
+     * roles would make shipped fingerprints record a scratch path
+     * (`.dist-build-a1b2c3…`, or an OS temp dir) that no longer exists.
      */
     recordedOutputDir?: string;
     sourceDir?: string;

package/dist/lib/build-preflight.d.ts

@@ -27,12 +27,10 @@ export interface Gates {
     /**
      * Disable the `source.stylelint` check (CSS print-safety: remote urls,
      * risky print effects, page-containment) for this run, without touching
-     * `preValidate` itself (#272 — one CSS gate, not two: this used to be a
-     * whole second gate, a separate lint-runner, that duplicated `source.stylelint`'s own
-     * `checkCss` pass one phase later). `true` when `--skip-lint` was passed or
-     * `config.lint.enabled === false`; consulted only when `preValidate` is
-     * also true — with `preValidate` off, no pre-build check (CSS included)
-     * runs at all, `--skip-lint` or not.
+     * `preValidate` itself (#272 — one CSS gate, not two). `true` when
+     * `--skip-lint` was passed or `config.lint.enabled === false`; consulted
+     * only when `preValidate` is also true — with `preValidate` off, no
+     * pre-build check (CSS included) runs at all, `--skip-lint` or not.
      */
     skipStylelint: boolean;
     preValidate: boolean;

package/dist/lib/build-runner.d.ts

@@ -19,9 +19,8 @@ export interface BuildRunnerOptions {
     manifestPath?: string;
     stripAnnotations?: boolean;
     /**
-     * Skip the CSS print-safety check (#272 — one CSS gate, not two). This used
-     * to gate a separate lint-runner pass (since deleted); it now disables just the
-     * `source.stylelint` check inside pre-build validation (see
+     * Skip the CSS print-safety check (#272 — one CSS gate, not two): disables
+     * just the `source.stylelint` check inside pre-build validation (see
      * {@link computeGates}'s `skipStylelint`). Has no effect when
      * `skipPreValidate` is also set — pre-build validation, CSS check
      * included, does not run at all in that case.
@@ -132,17 +131,15 @@ export interface BuildContext {
     inputDir: string;
     /**
      * THE anchor every manifest-relative path resolves against: `styles:`,
-     * `source.files`, authored plugin `path:` entries, and the lint gate's own
-     * stylesheet resolution. Equal to {@link BuildContext.manifestDir}.
+     * `source.files`, authored plugin `path:` entries, and the CSS print-safety
+     * check's stylesheet resolution. Equal to {@link BuildContext.manifestDir}.
      *
-     * These used to resolve against two different roots in one build (2026-07-29
-     * audit): plugins, the lint gate, and the output dir anchored on
-     * `manifestDir`, while `styles:`/`source.files` anchored on `inputDir`. They
-     * are identical in the normative layout (the manifest lives in the book
-     * folder) and diverge only under an explicit `--manifest` pointing outside
-     * `--input` — where the docs are unambiguous that both are manifest-relative,
-     * so the lint gate was checking a different set of stylesheets than the ones
-     * that shipped.
+     * It is NOT `inputDir`. The two are identical in the normative layout (the
+     * manifest lives in the book folder) and diverge only under an explicit
+     * `--manifest` pointing outside `--input` — where the docs are unambiguous
+     * that all of these are manifest-relative. Anchoring any of them on
+     * `inputDir` would check a different set of stylesheets than the ones that
+     * ship.
      */
     renderDir: string;
     outDir: string;
@@ -195,17 +192,12 @@ export declare function resolveBuildContext(opts: BuildRunnerOptions): Promise<B
  * `loadPluginsWithCss` directly, and only the first caller does real work —
  * the other gets the cached result back, whichever stage happens to run
  * first (a test calling {@link renderBook} directly, without going through
- * `runQualityGates`, gets a fresh load here exactly as it would have before
- * this existed).
+ * `runQualityGates`, gets a fresh load here).
  *
- * Fail-fast (no `onError`), matching `renderBook`'s pre-existing behavior:
- * a build/export must never silently omit author-configured formatting (see
- * `loadPlugins`'s doc comment in markdown/plugins.ts on the two failure
- * modes). One consequence: a plugin that fails to load now aborts the build
- * as soon as quality gates start, instead of (as before) the lint gate's own
- * degrade-and-report call warning-and-skipping that same plugin only for
- * `renderBook` to hard-fail on it moments later — the build failed either
- * way, this just stops wasting the lint pass first.
+ * Fail-fast (no `onError`): a build/export must never silently omit
+ * author-configured formatting (see `loadPlugins`'s doc comment in
+ * markdown/plugins.ts on the two failure modes), so a plugin that fails to
+ * load aborts the build as soon as quality gates start.
  *
  * Resolves plugin `path:` entries against `ctx.renderDir`, which is by
  * construction identical to `ctx.manifestDir` for the life of one
@@ -222,13 +214,12 @@ export declare function loadBuildPlugins(ctx: BuildContext): Promise<LoadedPlugi
  * rendered book.html both output strategies then paginate. This is the shared
  * pre-format work; the per-format tails live in the strategies.
  *
- * ARCH finding #4: Gutterpress's marker parser computes typed, line-numbered
- * author-mistake warnings (`env.layoutWarnings`) that every real render path
- * used to discard silently. `renderChaptersToFile`'s `onChapterWarnings`
- * threads them back out here so a final artifact never omits a marker
- * mistake without at least telling the author about it in the build log.
- * Exported (not just for the pipeline) so this stage is unit-testable
- * without driving the full `runBuild` pagination/PDF machinery.
+ * Gutterpress's marker parser computes typed, line-numbered author-mistake
+ * warnings (`env.layoutWarnings`). `renderChaptersToFile`'s
+ * `onChapterWarnings` threads them back out here so a final artifact never
+ * omits a marker mistake without at least telling the author about it in the
+ * build log. Exported (not just for the pipeline) so this stage is
+ * unit-testable without driving the full `runBuild` pagination/PDF machinery.
  */
 export declare function renderBook(ctx: BuildContext): Promise<string>;
 /**
@@ -265,12 +256,10 @@ export declare function publishToDirectory(workDir: string, targetDir: string, f
  * The browser is this function's to own: there is ONE launcher
  * (`engine/shared/cdp.ts`'s `launchChromium`, or the host's injected
  * `engineBrowser` factory in its place), it is started un-awaited so the
- * ~1–2s Chromium cold start overlaps lint + validation + markdown render, it
+ * ~1–2s Chromium cold start overlaps validation + markdown render, it
  * is awaited right before rendering (so a missing or too-old Chromium fails
  * there, with the launcher's own message, rather than deep inside the engine),
- * and it is closed in a `finally` that runs on every exit — finding #50:
- * previously the close only happened on the success tail (inside
- * `finalizeBuild`), so a pre-launched Chromium leaked whenever a quality gate
- * or the render itself threw.
+ * and it is closed in a `finally` that runs on every exit, so a pre-launched
+ * Chromium never leaks when a quality gate or the render itself throws.
  */
 export declare function runBuild(opts: BuildRunnerOptions): Promise<BuildRunnerResult>;

package/dist/lib/build-staging.d.ts

@@ -28,11 +28,9 @@ export interface StagedAssets {
  *
  * THE one implementation: `renderBook` (every real build/export) and the
  * preview/print parity gate both call this, so the gate can never measure a
- * document the build would not have produced. It previously hand-rolled a bare
- * `copyFile` loop, which (a) hard-crashed with a raw `ENOENT` on any book
- * carrying a stale image path — i.e. the tool that enforces preview↔print
- * parity could not run on the real books that need it — and (b) skipped
- * `inlineShapeUrls`, so `.gp-shape` wrapping silently differed from the build.
+ * document the build would not have produced (a hand-rolled `copyFile` loop
+ * in the gate would crash on a stale image path and skip `inlineShapeUrls`,
+ * silently diverging from the build).
  *
  * A missing image is NOT fatal: the same magenta placeholder the build ships
  * (see missing-asset-placeholder.ts) is substituted and every reference