gutterpress 0.11.10-alpha.3 → 0.11.10-alpha.7

package/README.md

@@ -133,9 +133,9 @@ The full configuration cascade is `CLI flags > manifest.yaml > preset defaults`.
 
 ## Commands
 
-Gutterpress has 10 subcommands. `new`, `preview`, `build`, and `publish` are the
-primary author commands; `lint`, `validate`, `audit`, and `preflight` are
-CI / advanced checks; `doctor` reports system readiness; and `ext` manages the
+Gutterpress has 8 subcommands. `new`, `preview`, `build`, and `publish` are the
+primary author commands; `validate` and `preflight` are CI / advanced
+checks; `doctor` reports system readiness; and `ext` manages the
 project's extensions (plugins, looks, component libraries). Every
 command also accepts `--help` for the authoritative, always-current flag list
 (`gutterpress <command> --help`) — this section is regenerated from the same
@@ -268,28 +268,6 @@ gutterpress publish --provider gdrive --connect
 gutterpress publish --provider gdrive ./my-book
 ```
 
-### `gutterpress lint`
-
-Run Gutterpress's PostCSS-based print-safety checks, including remote URLs,
-rasterizing effects, and source-level page-containment risks, against the
-project's CSS files.
-
-```sh
-gutterpress lint [files] [options]
-
-  --manifest <path>    Path to manifest.yaml
-```
-
-`files` is a positional: either a project directory containing `manifest.yaml` (its configured stylesheets are linted), or a glob pattern for CSS files to lint directly. There is no `--files` flag — pass the directory/glob as the positional.
-
-Common findings include remote `url(...)` references, effects that rasterize
-print text, and declarations on core page wrappers that could clip or trap
-out-of-flow art. Each finding is listed with its file and `line:col`, so you
-can see exactly which selectors rasterize text; a property at its initial value
-(`filter: none`, `will-change: auto`) is not a finding. The source-level
-containment check is an early signal; the build-time `engine.layer.trapped`
-diagnostic inspects the authoritative live ancestor chain.
-
 ### `gutterpress validate`
 
 Run the validation pipeline (pre-build source checks and/or post-build PDF checks). Tools that aren't installed are skipped with a warning — they don't fail the run. See [User Guide: Chapter 6 — Validation](https://github.com/dimm-city/gutterpress/blob/main/examples/gutterpress-user-guide/06-validation.md) for the full check list and [User Guide: Chapter 7 — System Setup](https://github.com/dimm-city/gutterpress/blob/main/examples/gutterpress-user-guide/07-system-setup.md) for which external tools each check needs.
@@ -324,18 +302,17 @@ It writes only when `source.markdownlint` is actually part of the run, so
 markdown untouched — `--fix` can never rewrite a file for a check the report
 does not mention.
 
-### `gutterpress audit`
-
-Run asset-only validation checks (image DPI/format/color-space, print-readiness) without the rest of the validation pipeline.
+Two narrowed runs replace the former `lint` and `audit` commands (removed in
+0.11.10 — each was a thin alias over this same pipeline):
 
 ```sh
-gutterpress audit [dir] [options]
+# CSS print-safety only — remote url(), rasterizing effects, page containment
+# (the check `gutterpress lint <dir>` used to run; findings list file and line:col)
+gutterpress validate my-book --only source.stylelint
 
-  --input <dir>        Asset directory (overrides the positional directory)
-  --manifest <path>    Path to manifest.yaml
-  --only <ids>         Run only these check IDs/selectors (comma-separated)
-  --skip <ids>         Skip these check IDs/selectors (comma-separated)
-  --format <fmt>       text (default) | json
+# Asset checks only — image DPI / format / color space, fonts
+# (what `gutterpress audit <dir>` used to run)
+gutterpress validate my-book --category asset --phase pre
 ```
 
 ### `gutterpress preflight`
@@ -398,9 +375,9 @@ Add an extension. What `SOURCE` is decides what happens:
 
 - an **npm package** (`name` or `name@version`) is downloaded straight from
   the registry along with its runtime dependencies, hash-verified, vendored
-  into the project under `plugins/npm/` with a receipt, load-tested, and
-  written back pinned as `name@<exact version>`. This does not invoke npm,
-  Bun, Node.js tooling, or package install scripts;
+  into the project under `plugins/npm/`, load-tested, and written back pinned
+  as `name@<exact version>`. This does not invoke npm, Bun, Node.js tooling,
+  or package install scripts;
 - a **bundled feature** (`markdown-it-mark`, `markdown-it-sub`,
   `markdown-it-sup`, `markdown-it-abbr`, `gutterpress-gfm-alerts`) is simply
   listed — nothing to install, works offline;
@@ -488,11 +465,11 @@ Every command follows the same exit-code contract, so CI can branch on the resul
 | Code | Meaning |
 |---|---|
 | `0` | Clean — no findings, nothing to fix. |
-| `1` | Findings — the command ran fine but reported findings/validation failures (`lint` CSS errors, `validate`/`preflight`/`audit` findings, a `build` quality-gate rejection). |
+| `1` | Findings — the command ran fine but reported findings/validation failures (`validate`/`preflight` findings, a `build` quality-gate rejection). |
 | `2` | Usage — the invocation itself was wrong: a bad flag, positional argument, preset, or value. |
 | `3` | Pipeline — the build/render/export pipeline itself failed for a reason unrelated to usage or findings (I/O error, missing tool, renderer crash). |
 
-This applies uniformly across `build`, `preview`, `lint`, `validate`, `preflight`, `audit`, `publish`, `ext`, `new`, and `doctor`.
+This applies uniformly across `build`, `preview`, `validate`, `preflight`, `publish`, `ext`, `new`, and `doctor`.
 
 ## Extensions
 
@@ -539,13 +516,14 @@ An extension folder (or npm package) describes itself in its **`package.json`**
 
 Order is load order: a later entry's markdown runs after earlier entries' (and sees their output) and its CSS wins ties — each extension's stylesheets are wrapped in their own cascade layer (`@layer ext.<name>`), declared in list order, so this holds however an extension writes its CSS; the project's own `styles:` stay unlayered and load after every extension, beating all of them at any specificity. There is no `priority` and no `path:`/`name:` wrapper — a manifest still carrying `plugins:` fails with a message that prints the same entries rewritten as `extensions:`. The `engine:` and `engineStyles:` keys are gone too (there is one engine; move any `engineStyles` entries to the end of `styles:`).
 
-Pinned npm packages and their runtime dependencies live under `plugins/npm/`,
-with a receipt that records the exact graph and hashes the complete tree. They
-travel with the project and builds never fetch from the registry. Install/build
-scripts, native addon compilation, bundled `node_modules`, and non-registry
-dependency selectors are intentionally unsupported. Only install packages you
-trust: extensions run unsandboxed with the process's full filesystem and network
-privileges.
+Pinned npm packages and their runtime dependencies live under `plugins/npm/`
+as a plain nested `node_modules` tree, which Node's own module resolution loads.
+They travel with the project and builds never fetch from the registry; each
+tarball's integrity is checked against the registry's hash when it is
+installed. Install/build scripts, native addon compilation, bundled
+`node_modules`, and non-registry dependency selectors are intentionally
+unsupported. Only install packages you trust: extensions run unsandboxed with
+the process's full filesystem and network privileges.
 
 Use the entry's `export` field, or `ext add --export <name>`, for packages
 that expose a named plugin function instead of a default export.

package/dist/api/index.d.ts

@@ -11,7 +11,7 @@
  *   await runBuild({ inputDir: "./book", format: "pdf", outDir: "./out", rawArgs: {} });
  */
 export { runBuild, splitOutPath, BuildError, type BuildFormat, type PdfxFlavor, type BuildRunnerOptions, type BuildRunnerResult, type SplitOutPath, type EngineBrowser, type EngineSession, } from "../lib/build-runner";
-export { DEFAULT_PRINT_OPTS, readyProbeExpr } from "../engine/shared/cdp";
+export { DEFAULT_PRINT_OPTS, readyProbeExpr, assertMilestone } from "../engine/shared/cdp";
 export { startPreviewServer, type PreviewServerHandle, type StartPreviewServerOptions, } from "../server";
 export type { PreviewServerOptions } from "../types";
 export { loadManifestWithPath, resolveConfig, MANIFEST_FILENAMES, hasProjectManifest, } from "../lib/manifest";

package/dist/api/index.js

@@ -7,6 +7,7 @@ import {
   BUILT_IN_STYLE_SET_IDS,
   BUILT_IN_TEMPLATE_IDS,
   BUNDLED_EXTENSIONS,
+  DEFAULT_NPM_REGISTRY,
   EXTENSIONS_DIR,
   EXTENSION_KINDS,
   EXTENSION_MANIFEST_FILENAME,
@@ -75,6 +76,7 @@ import {
   listRepoBooks,
   listSnippets,
   loadManifestWithPath,
+  npmRegistryUrl,
   parseExtensionSpecifier,
   parseRemoteOrigin,
   pathEscapesFolder,
@@ -125,15 +127,17 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "../index-cgbxryk0.js";
+} from "../index-ns8gav3w.js";
+import {
+  BuildError
+} from "../index-r4wvy5v3.js";
 import {
-  BuildError,
   DEFAULT_PRINT_OPTS,
+  assertMilestone,
   readyProbeExpr
-} from "../index-t43k5rq1.js";
+} from "../index-rzm1phg0.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
-  DEFAULT_NPM_REGISTRY,
   HISTORY_PAGE_LIMIT,
   PLUGINS_DIR,
   RESTORE_BACKUP_MESSAGE,
@@ -141,13 +145,12 @@ import {
   countUnversionedChanges,
   isNoChangesError,
   listLocalBranches,
-  npmRegistryUrl,
   providerFor,
   resolveLogger,
   restoreVersionWithBackup,
   switchBranch,
   whenGitIdle
-} from "../index-fnhak0nh.js";
+} from "../index-qf7y4d85.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -264,6 +267,7 @@ export {
   capabilitiesFor,
   autoSyncDelayMs,
   autoSnapshotDelayMs,
+  assertMilestone,
   assertExtensionContained,
   adoptFolder,
   addExtension,

package/dist/{build-wvm8haf3.js → build-v8gn687b.js}

@@ -1,23 +1,24 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-w3khh6re.js";
+} from "./cli-2frrxgf3.js";
 import {
   log
-} from "./cli-m3jt4tw6.js";
+} from "./cli-wyry8qbw.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-xk7qfz4m.js";
-import"./cli-d8rdk1y7.js";
-import"./cli-c41yr7he.js";
+} from "./cli-2k72f0ww.js";
+import"./cli-30j93gzt.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-pfczdbyd.js";
+import"./cli-kkzka31p.js";
+import"./cli-7fkhgtfn.js";
+import"./cli-5qr3z0qa.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/cdp-jg95s674.js

@@ -0,0 +1,15 @@
+import {
+  DEFAULT_PRINT_OPTS,
+  REQUIRED_MILESTONE,
+  assertMilestone,
+  launchChromium,
+  readyProbeExpr
+} from "./index-rzm1phg0.js";
+import"./index-37x76zdn.js";
+export {
+  readyProbeExpr,
+  launchChromium,
+  assertMilestone,
+  REQUIRED_MILESTONE,
+  DEFAULT_PRINT_OPTS
+};

package/dist/cdp-smdx6mr3.js

@@ -0,0 +1,16 @@
+import {
+  DEFAULT_PRINT_OPTS,
+  REQUIRED_MILESTONE,
+  assertMilestone,
+  launchChromium,
+  readyProbeExpr
+} from "./cli-kkzka31p.js";
+import"./cli-7fkhgtfn.js";
+import"./cli-37x76zdn.js";
+export {
+  readyProbeExpr,
+  launchChromium,
+  assertMilestone,
+  REQUIRED_MILESTONE,
+  DEFAULT_PRINT_OPTS
+};