Changelog
What’s new in Mokly Every release of the Mokly CLI, newest first.
Releases
0.14.0 8 October 2026 0.13.0 30 September 2026 0.12.0 22 September 2026 0.11.0 17 September 2026 0.10.0 17 September 2026 0.9.0 15 September 2026 0.8.0 11 September 2026 0.7.1 11 September 2026 0.7.0 10 September 2026 0.6.0 26 August 2026 0.5.1 11 August 2026 0.5.0 7 August 2026 0.4.0 28 July 2026 0.3.0 23 July 2026 0.2.0 22 July 2026 0.1.0 20 July 2026 Breaking changes
publish: mokly publish now requires a clean checkout. Commit, stash or ignore uncommitted files before publishing. There is no override flag.Use mokly-viewer/ and generations/, ownership v3 and upload v2. Older services reject publication with the documented version error until their receiver and viewer are updated. file-path identity and Markdown documents (#131 ) Path identity removes id, navPath, entries and entriesDir. Use roots and file-derived paths. Rebuild manifest v8 and consume read model v4, review result v5, disclosure storage v4 and /view/<path>/ URLs. Earlier formats, URLs, ids, disclosure keys and configuration are not read or translated. The release note documents manual migration only. Features
cache: make .mokly-cache ignore itself (#145 ) (43ae07b )deps: baseline-relative audit and daily update PRs (#157 ) (6bb6421 )file-path identity and Markdown documents (#131 ) (c4138a0 ) publish: require a clean checkout (#168 ) (acac1c7 )simplify generated output and delivery (#156 ) (b39d89a ) tier MockLink asChild placement and add build warnings (#124 ) (f66c274 ) viewer: add route-scoped shell bootstraps (#120 ) (b2c82c1 )xtask: run the complete gate on Blacksmith Testboxes (#160 ) (fcc5059 )Bug fixes
build: ignore source maps in CSS Modules (#144 ) (f8ab241 )build: keep lock directories on release (#132 ) (781da7a )ci: publish npm releases from GitHub runners (#126 ) (b4a02a3 )deps: add expiring braces audit exception (#130 ) (1dc9158 )deps: apply in-range dependency updates (#146 ) (f1ab129 )deps: patch source-map-js advisory (#140 ) (ad2b3ec )export: read only specifiers in scripts (c4138a0 )prevent output write and frame usage races (#129 ) (800fe9f ) server: keep the checked closure on reload (#172 ) (eea44b6 )viewer: keep stacked narrow frames reachable (c4138a0 )xtask: close Testbox SSH before cleanup to end boxes promptly (#177 ) (3a7be25 )xtask: resolve remote verification review findings 4 to 14 (#164 ) (3ce2fb5 )Performance
test: run more tests in parallel locally (#148 ) (6bf6251 )Documentation
present moves in the guides and contracts (c4138a0 ) Dependencies
The following workspace dependencies were updated * dependencies * @mokly/viewer bumped from 0.4.0 to 0.5.0 Breaking changes
publish: mokly publish no longer uploads one catalogue archive; it runs the plan, blob and complete exchange documented in docs/protocol/mokly-upload.md, so receivers must implement that exchange. Export ownership markers are schema 2 with per-file SHA-256 digests and sizes; schema 1 markers are rejected, so export directories written by earlier releases must be removed before exporting again. Successful plain publish output is now Published Mokly catalogue. <uploaded> files uploaded, <unchanged> unchanged. or Mokly catalogue already published for this commit., optionally followed by the viewer URL line.defineCollection, collection, and the collection types are removed; place entries with navPath or nested folder(). Generated manifests are schema v6 and the public catalogue read model is v2 (folder nodes, navPath, no collections or ancestors). Rebuild generated output after upgrading. Features
add co-located entries and screen variants (ce3da27 ) design: add the disabled and validation roles (d4228f9 )publish: upload catalogue content deltas (#122 ) (0c8245f )replace collections with navigation paths (#123 ) (b4314fe ) viewer: add Auto/Light/Dark appearance (#96 ) (d4228f9 )viewer: adopt the mokly-cloud logo (#119 ) (3699c56 )viewer: align comparison pane scrolling (#121 ) (d71b03b )Bug fixes
align screen variants and history (#115 ) (2ec4d83 ) ci: align workflow tests with Blacksmith (74043d2 )ci: await navigation disclosure transitions (#108 ) (2dac7b0 )ci: drain fixtures before removal (d3d3e4c )ci: drain fixtures before removal (c19cccb )ci: enforce fixture-owned teardown (a8e2ea4 )ci: enforce fixture-owned teardown (a32b9f2 )ci: pin release checkout action (a59aab2 )ci: prevent hydration timeouts and shutdown hangs (47c5197 )ci: resolve Node 24 once per run (#113 ) (a233cbd )ci: reuse one Node 24 version across jobs (bbba28e )cli: arm shutdown before ready output (#106 ) (0216610 )complete entry discovery follow-up (#111 ) (5ea5258 ) viewer: resolve effective views (#112 ) (d665d06 )Performance
ci: gate Node 24 checks on release PRs (#114 ) (a8f408d )Dependencies
The following workspace dependencies were updated * dependencies * @mokly/viewer bumped from 0.3.0 to 0.4.0 Features
cli: color rich success ticks green (#91 ) (48af447 )cli: improve terminal experience (#85 ) (ddb263b )show previous versions of removed pages and screens (#98 ) (a177abd ) viewer: hydrate the shared Browse shell (#95 ) (b5c9f07 )viewer: present removed previews as viewer-owned documents (#104 ) (f23c376 )Bug fixes
align mobile inspector surface (#92 ) (310749a ) release: extend registry retry window (#86 ) (8c4701f )shell: match inspector divider to nav divider (#90 ) (9bd6f20 )viewer: authenticate frame document handoffs (#99 ) (b95ad47 )viewer: repair embedded stylesheet layout (#103 ) (dde661c )Performance
ci: parallelize verification suites (#93 ) (3f6ea42 )review: skip unchanged component view comparisons (#94 ) (20e55ca )Dependencies
The following workspace dependencies were updated * dependencies * @mokly/viewer bumped from 0.2.0 to 0.3.0 Features
default generated output to derived (#81 ) (37a5ea8 ) docs: ship the CLI guides in the package (#82 ) (9296ee3 )viewer: add comment anchoring primitives (#84 ) (adac9e1 )Dependencies
The following workspace dependencies were updated * dependencies * @mokly/viewer bumped from 0.1.0 to 0.2.0 Features
add @mokly/viewer embeddable viewer package (#76 ) (d7b0ac3 ) upstream the Mokabook 0.8.0 consumer patch (#74 ) (7ca301c ) xtask: add commit-title-lint gate (7ca301c )Bug fixes
release: pin viewer initial version (#78 ) (65feea8 )serve: drop dead anchor guard in localHost (7ca301c )serve: surface worker render failures on the server (7ca301c )serve: validate transferred exclusions without re-prepending (7ca301c )Performance
build: cache compiled exclusion matchers per config (7ca301c )workspace: dedupe affected usages in one pass (7ca301c )Breaking changes
npm consumers must install and import @mokly/mokly; the unscoped name is not a package alias. Install and import @mokly/mokly. The unscoped name is not a package alias; the CLI remains mokly. rename package to Mokly (#66 ) rename package to Mokly Features
add CSS change attribution (#72 ) (4869b4a ) add derived baseline output (#70 ) (9af53be ) design: add stylesheet evidence mockups (4869b4a )design: depict stylesheet evidence inside a loaded comparison (4869b4a )publish catalogues to upload services (#71 ) (9580d74 ) rename package to Mokly (96a7ca6 ) rename package to Mokly (#66 ) (f0fcfa9 ) review: add the review.css-analysis timing span (4869b4a )shell: split catalogue navigation into sections (#60 ) (83b377a )Bug fixes
address Mokly migration review findings (681db1a ) benchmark: expect zero Changes for an unrelated shared-rule edit (4869b4a )design: show impact screens as plain previews and fix card spacing (4869b4a )keep added and removed screens current-only (#64 ) (9301443 ) load selected comparisons and recover expired snapshots (#62 ) (b19dc62 ) pack bootstrap from the exact source tip (aeb9a26 ) preserve catalogue state on evidence updates (#59 ) (7cefa42 ) preserve Usage link focus during updates (#63 ) (e0dc6d1 ) publish under the Mokly npm scope (#67 ) (bf1f5be ) publish under the Mokly npm scope (#69 ) (5b4c647 ) review: preserve function-name boundaries in CSS serialization (4869b4a )Breaking changes
remove legacy configuration and exported types, automatic source discovery, comment-component expansion, legacy lint options and route aliases. Consumers must register document pages, preserve explicit routes, and regenerate v4 output through the documented ownership migration. The legacy renderer and raw HTML fixture are intentionally removed; shared change metadata replaces the removed-screen helper without removing screen support. Features
unify catalogue pages and optional published Changes (#54 ) (b5065a6 ) Bug fixes
server: allow five-minute watched startup (#56 ) (bdb2125 )Performance
start large catalogues with on-demand previews (#57 ) (aab65ab ) Bug fixes
ci: isolate comparison test baselines (#51 ) (4d1fb34 )Breaking changes
use mokabook serve and select a screen comparison instead of invoking mokabook review or opening a standalone Review report. Bug fixes
browse: preserve collapsed groups across navigation (#35 ) (ef66bf2 )collapse details inspector by default (#41 ) (9398ff6 ) focus Changes on reviewable screen output (#47 ) (a5ecbc0 ) search: match authored page IDs (#39 ) (1dcfb67 )shell: draw copy and expand as legible icons (#50 ) (aa5adea )shell: replace tiny search glyph with a legible search icon (#43 ) (bb3a22f )Features
infer breadcrumbs from hierarchy (#29 ) (f8aa5fc ) navigate catalogue links through Browse (#30 ) (4c3fd17 ) Bug fixes
browse: persist details before navigation (#32 ) (9292dbc )ignore compatibility nav paths in Changed (#33 ) (6acfa2a ) Bug fixes
compare branch changes from merge base (#27 ) (f2c7dd2 ) Features
example: dark fragments become readable - dark accent #7 fae95 (c92e6e5 )native light/dark color scheme support (#26 ) (c92e6e5 ) Bug fixes
browse: remember details disclosure (#24 ) (7e12e79 )preview: the static snapshot now rewrites data-fragment-light (c92e6e5 )Performance
review: speed large catalogue loading (#23 ) (bd28247 )Features
review: serve Review at /review in the shell design (#19 ) (bf06cbb )Bug fixes
release: retry registry propagation (#16 ) (c7bbf23 )review: keep served artifacts current (#20 ) (8fff547 )Features
add pull request preview deployments (#12 ) (37b7dc3 ) move viewport switch into header (#11 ) (d5ee0be ) Bug fixes
browse: copy IDs without navigation (#13 ) (5123150 )release: install before auditing signatures (#8 ) (05b95d3 )server: advance past occupied ports (#15 ) (9e416c2 )
Mokly CLI 0.1.0 20 July 2026 Features
example: prove the consumer contract against the real Firna stack - (2b3827e )establish an app-independent Mokabook framework (#1 ) (2b3827e ) rebuild the served Browse shell to the refined Mockbook design from (2b3827e )