# ClientLiteJSX — SPECTER Version Vault

## What this package is

This is a **static Cloudflare Pages Direct Upload project** for the CLJ/CJS historical archive. It is not a Cloudflare Worker backend. The authenticated **OPEN** platform and other full Ubuntu server-based systems remain separate and continue running on the user's own computer. This static vault serves files, docs and supported browser-only previews.

The full Cloudflare upload ZIP includes every complete archived version snapshot plus supplemental patches and SDKs. **Each individual CL version ZIP contains exactly its original single-version source snapshot, not an extra nested archive of all previous versions.** The CL version ZIP bytes are unchanged from the user-provided files; filenames are catalog aliases assigned for browsing. The original ZIP filename, exact SHA-256, and byte count are retained in each manifest.

## Run locally (Ubuntu/Windows/macOS)

1. Extract the Cloudflare-upload ZIP into an empty directory.
2. `cd` into the directory containing `index.html`.
3. Run `python3 -m http.server 8000 --bind 127.0.0.1`.
4. Open `http://127.0.0.1:8000/` in a browser.
5. Pick a codename, inspect its `CL:n` identity, open the codename folder, download the version-specific ZIP, or check its SHA-256.

Standalone browser compiler previews exist for CL:11, CL:12 and CL:13, served from the original bundled files. Older native Ubuntu/OPEN versions have no claimed Cloudflare-hosted server runtime. Download those ZIPs to use their original local setup and build scripts.

## Cloudflare Pages (no Worker required)

1. Sign in to Cloudflare and open **Workers & Pages**.
2. Create a **Pages** project using **Direct Upload** (drag-and-drop assets).
3. Upload this *whole archive ZIP*, containing `index.html` at its top level, or upload the extracted static folder.
4. Deploy it. The selector and downloadable individual version ZIPs are served as static assets.

Cloudflare Pages documentation: https://developers.cloudflare.com/pages/get-started/direct-upload/

Dashboard drag-and-drop allows 1,000 site files and 25 MiB per individual static file as documented in November 2026. All complete historical source ZIPs in this catalog are under that *individual asset* limit. If your account has an upload-size or network restriction for the overall package, extract it and deploy the folder from a computer with `wrangler pages deploy <folder>`; do not run it as a Worker backend.

**Do not upload this package as a GitHub Action source ZIP expecting the old workflow to extract it automatically.** It is already a fully built static Cloudflare Pages site.

## Catalog identity and filenames

- CL number is permanent in the *catalog*: e.g. `CL:1`.
- Codename is displayed first in the selector: e.g. `JetBird`.
- ZIP filenames are cross-platform safe: `CL-1-JetBird-05-02-26-10-23.zip`.
- The date/time in that filename is taken from available ZIP entry metadata, **not an independently confirmed original release date**. The manifest retains that distinction. All legacy snapshots are unsigned; official freeze status is not asserted.
- `VERSION-VAULT/VAULT-INDEX.json` lists all complete versions, exact original filenames and hashes.
- `SUPPLEMENTS/` preserves the patches and independent SDKs; these are **not** mislabeled full versions.
- Duplicate uploads of identical 18-dialect patch bytes are recorded once.

## Current language and C sources

- `CURRENT/browser/index.html` — standalone current CLJ Studio compiled from C11 to WASM.
- `CURRENT/docs/index.html` — twelve original CLJ-authored docs pages.
- `CURRENT/src/` — original separate C11 source files.
- `CURRENT/review/CLJ-HyperCore-Combined-C-Source-For-AI.c` — original read-only combined source listing for AI review.
- `PREVIEWS/CL-11/` and `PREVIEWS/CL-12/` — original static compiler previews for earlier standalone versions.

## Security

Read `SECURITY/README.md`. This archive provides checksum integrity today and defines a 3-of-3 Ed25519 signing workflow for future official releases. Historical snapshots do not have attested release dates or signature chains. **No private keys are included.**

## Verify every archive locally

`python3 TOOLS/verify_vault.py`

This validates all 13 complete version ZIPs and all nine supplemental ZIPs against their SHA-256 values, and checks any three-key signatures where present.

## Create the *next* signed official version (on your own trusted machine)

After creating and safeguarding three encrypted OpenSSH Ed25519 keys, use the **local-only** tool `TOOLS/create_signed_successor.py`. It takes a new, single-version source ZIP and refuses to accept a ZIP that embeds the entire old `VERSION-VAULT`. It requires all three offline keys, enforces the next unused CL number and unique codename, copies the new archive byte-for-byte, signs its manifest, preserves older archives, and creates a **new complete Cloudflare upload ZIP** containing the updated version vault. The private keys are neither embedded nor uploaded.

```bash
python3 -m pip install cryptography
python3 TOOLS/create_signed_successor.py \
  --source /private/new-CLJ-version.zip --number 14 --codename SignalOsprey \
  --description 'New signed language release' \
  --phantom /private/PHANTOM --cipher /private/CIPHER --sentinel /private/SENTINEL \
  --output /private/CLJ-SPECTER-next-Cloudflare.zip
```

This command is an example of a **future** signing workflow; CL:14 does not exist in the current archive. The tool must run on a trusted device and requires the three actual owner-controlled signing keys. Once the first official keys are provisioned, replacements must match the pinned public keys. Publish the public-key fingerprints independently; otherwise, the hosting platform alone cannot prove the publisher's identity.

## November 17, 2026 UI and provenance repair

- The vault embeds **the historical browser HTML belonging to the selected CL release** where the original ZIP contains a browser frontend. CL:1–CL:5 mirror their historical compiled ClientLite example frontends; CL:6 uses its original portable browser compiler; CL:7 preserves its own CJS/WASM 3D page; CL:8–CL:10 show their original OPEN static frontends, which **cannot substitute for the Ubuntu-hosted backend**; CL:11–CL:13 use their own browser Studios.
- All 12 CLJ-generated documentation chapters now explicitly import their compiled JS modules and call `mountCJS18(root)`. Each has visible error feedback if compilation or mounting fails.
- Studios are marked with their active `CL:<number>` and codename, with SPECTER navy/cyan styling. Download ZIP contents remain untouched.
- Times and version ZIP *filenames* use a **12-hour clock with AM/PM and seconds**. Times are derived from this conversation's file attachment metadata, converted to America/Chicago. They are **not** retrospectively authenticated release times. The ISO UTC time is retained in manifest and catalog fields.
- Windows-compatible filenames replace colons with hyphens. The ZIP data bytes were not recompressed or modified.
- Browser previews are historical **copies for display**. The downloaded ZIPs remain byte-preserved. Legacy network services, OPEN authentication, and server-backed publishing need their original backends.

To test: run `python3 -m http.server 8000` in the unzipped site folder, open `http://127.0.0.1:8000/` and click an older version. For docs open `/CURRENT/docs/index.html`.
