# ClearScroll 0.4.0 — independent publication snapshot

This is selected, unchanged application source for the verified text-focused extension. It has no development Git history. **It is not Git commit `965f65a957336838956f06e917a8397ff12cf9e2`**: that is the original immutable release's provenance. A future independent publication commit will have a different identity.

Original release ZIP: SHA-256 `09d5e0944c668b03da9764f1038286e896d83f09a531f164d62fecbd0929ba7b`, 44,120,448 bytes. No release ZIP is included, rebuilt or repackaged here. Hashes for its 27 files and the source-to-output mapping are in `RELEASE-FILE-CORRESPONDENCE.json`. `SOURCE-FILES.json` records every copied release file's SHA-256 and original Git blob. `SHA256SUMS` inventories this entire snapshot except itself. Verify from this directory with `sha256sum -c SHA256SUMS`.

All application source in `src/`, build/conversion inputs, lockfiles, configuration, own icons and required notices are copied byte-for-byte from that original release tree. Original package metadata and script definitions are preserved, including historical repository links; those links are not a claim that public main contains 0.4.0. The independently published directory containing this README is the proposed source distribution.

The supported application blurs webpage text about chosen topics on a best-effort basis, locally. It includes reveal, pause, three modes, exclusions, local feedback, CPU and supported WebGPU. It does not include image classification or guarantee spoiler/topic blocking or YouTube preview protection. Dormant original vision modules, related license texts and imported build helpers are retained for exact source identity and build completeness; no image weights or ONNX runtime are delivered with the verified text extension. Do not pass `--with-images` or change model/thresholds when reproducing this release.

## Build recipe for a separate development copy

No build was run to prepare this publication snapshot. These are instructions for recipients, not evidence of a new qualification run. First copy this source directory outside the development repository and any ancestor Git worktree. A parent repository can otherwise be discovered by Git metadata commands even though this snapshot contains no .git directory. Use a new disposable copy/output directory; never write into an installed extension or overwrite a verified release ZIP.

Recorded release tools: Linux ARM64, Node 24.22.1, npm 11.19.1, Rust/cargo 1.97.0, wasm-bindgen CLI 0.2.129, Python 3.12.3, zlib 1.3. `rust-toolchain.toml`, `Cargo.lock`, `package-lock.json` and `tools/requirements.lock` pin the relevant tool/dependency inputs. Compiler/linker host, generated model metadata/floating point and compression tool changes can change output bytes. This source package alone does not certify byte-for-byte rebuilds on other environments.

Prerequisites: install Node/npm, Rust with `wasm32-unknown-unknown`, Python with venv/pip or uv, and `cargo install wasm-bindgen-cli --version 0.2.129 --locked`. Network is needed to obtain pinned crates/npm packages, Python wheels and the model. Existing `npm ci` may run normal dependency installation scripts. Review upstream install tooling as usual. Default setup downloads only the pinned MiniLM model, not vision models. With uv the unchanged helper selects Python 3.13; the recorded conversion environment was Python 3.12.3. For closer replication, explicitly create `.venv` with Python 3.12.3 and install `tools/requirements.lock` with hashes first. Do not use `--update-lock`.

```sh
npm ci
python3.12 -m venv .venv
.venv/bin/python -m pip install --require-hashes -r tools/requirements.lock
CLEARSCROLL_MODEL=minilm-l6 CLEARSCROLL_DTYPE=f16 npm run setup:model
npm run build:wasm
CLEARSCROLL_MODEL=minilm-l6 CLEARSCROLL_DTYPE=f16 node scripts/build.mjs --out build/recipient-040/unpacked
node scripts/validate-dist.mjs build/recipient-040/unpacked
node scripts/package.mjs build/recipient-040/unpacked build/recipient-040/clearscroll-0.4.0.zip
sha256sum build/recipient-040/clearscroll-0.4.0.zip
```

The default JS helper uses `minilm-l6`/`f16` even though historical alternate entries remain in the unmodified model lock. Use these explicit settings. The prepared model location is `build/models/minilm-l6-f16/`. Exported weights must hash to `a32a31567e28b85eafb400b7cd450328d0cf6c96c7b4f8e2970ce31ec055c94a`; vocabulary must hash to `07eced375cec144d27c900241f3e339478dec958f92fddbc551f295c992038a3`. The exporter contains the actual transpose, position truncation, binary16 conversion and model metadata recipe. It consumes project-authored background/topic strings in `src/shared/`; no evaluation corpus is needed.

`scripts/assemble-production.mjs` retains the original optional two-assembly comparison recipe. Without a Git repository its Git identity fields are null; inside a new independent repository they describe that repository, **not** the original release commit. Consult `SOURCE-PROVENANCE.json` for original identity.

## Deliberately omitted development material

All ClearScroll tests/fixtures, evaluation corpora, research archives, browser data, internal release evidence, diagnostics and old demonstration screenshots are excluded. Publisher-derived fixtures are not needed to modify or compile the distributed software and are not provided. Attribution alone was not used as a publication-rights basis. No new test pass is claimed. Original npm scripts referencing omitted tests/review/evaluation tools remain unchanged; `npm test`, `npm run check`, `npm run release:prepare`, end-to-end/privacy/benchmark commands and evaluation commands are not supported by this selected snapshot. The production build commands above have a complete audited source/input closure. Authored inline Rust unit cases remain part of the unchanged source; integration fixtures outside `src/` are omitted. The original engineering qualification was performed separately on the immutable release before this snapshot was made.

## Licenses and source availability

Own application source: ISC, retain `LICENSE`. Other files retain their own notices; this README does not relicense third-party material. Root `THIRD_PARTY_NOTICES.md` is the unmodified broader development-tree notice and mentions optional image tooling. `distribution-notices/` contains the exact text-only notices shipped in the immutable extension; these describe what was actually distributed. Full required license/copyright texts are preserved under `licenses/`.

The original locked WASM dependency graph lists 190 crates. All registry archives were checked against their Cargo.lock checksums, and their extracted source files matched the installed build-source cache without changes. `DEPENDENCY-SOURCES.json` identifies exact versions, hashes and source URLs. **Both MPL-2.0 packages** are additionally provided in preferred source form under `third-party/colored-3.1.1/` and `third-party/option-ext-0.2.0/`, with full original MPL license texts, manifests, Rust source, and any upstream examples/test snapshots needed by that source. Their synthetic ANSI/Option examples contain no ClearScroll publisher fixtures. `MPL-SOURCE.json` inventories every supplied file. Only upstream CI/container/history metadata was omitted. These MPL files remain MPL-2.0, including recipients' rights to them; no ClearScroll changes to them were found. The upstream registry source links in the existing executable notices remain valid source routes.

The text model and WordPiece vocabulary are Apache-2.0, based on the explicit license metadata at [the exact upstream model revision](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2/blob/1110a243fdf4706b3f48f1d95db1a4f5529b4d41/README.md) and the BERT origin identified in the notices. No license is inferred from an absent LICENSE file. Model input filenames, revision and SHA-256 values are in `tools/model_lock.json`; model conversion source and modification notices are included. No training dataset or evaluation excerpts are redistributed. Weights are not vendored in this source directory; they remain in the immutable extension and can be reproduced/downloaded from the pinned, explicitly licensed origin. This is a documented upstream licensing basis, not legal certification of training-data rights.

The public documentation next to this source directory describes privacy, support, limitations and notices. Publication of this selected source does not remove or resolve any content previously published elsewhere. No public hosting URL or Chrome Web Store approval is asserted by this package.
