- docs
- Look things up
- Look things up
- Project
- Changelog
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.6.8 - 2026-11-15
Fixed
- Cascade repair points every alias a build owns at the build tag’s own index (cascade)
0.6.7 - 2026-11-15
Added
- Verify packages against publishers declared in the index (trust) BREAKING
- --no-verify is refused when the system config locks signatures to required (install) BREAKING
- Prune deletes GitHub Packages tags for ghcr.io with --forge github (package)
- Package verify and sbom default to the host platform (cli) BREAKING
- Package prune accepts an index-named GitHub Enterprise host listed in trusted_hosts (cli)
Changed
- Package prune reads the manifests of kept versions concurrently (announce)
Documentation
- The lock guide says when a lock install skips the publisher check (guides)
- Declaring publishers in the index has its own guide (guides)
- The changelog page derives its font preload at build time (website)
Fixed
- Sign, attest and verify an image index on registries that honour Accept, such as ghcr.io (sign)
- Cascade repair for a build tag writes and announces only the aliases that build owns (package)
- Log lines carry the full error cause chain, including the registry authentication cause (cli)
- A failed package push --sign or --sbom writes no tag and returns the error document (cli) BREAKING
- Announce --tags-from-registry indexes version tags only (cli)
- An unreadable discovered config file is named in the hint instead of --config (config)
- Ocx lock states a missing tag once instead of three times (cli)
- Selecting a version that is not installed says so and names ocx install (cli)
- Package verify says to pass --platform when an image index carries no signature (cli)
- A publisher mismatch says when keyless publishers were skipped for a missing trust root (cli)
- Signing or attesting again under the same identity adds no second referrer (sign)
- Package prune reports shared_version as the reason for a refused tag (cli)
- A package prune that fails part-way names every version it did not delete (cli)
- The push report no longer lists a failed attestation status (cli) BREAKING
- Package sbom fails when every candidate is refused (cli) BREAKING
- The per-prompt hook keeps working on Windows and with a relative OCX_CONFIG (shell)
- The system config on Windows is %ProgramFiles%\ocx\config.toml (config) BREAKING
- The index conformance fixtures match indexbot again and the publishers vector is ocx-authored (test)
- Bin_scan scans the content root for a bare ${installPath} PATH entry (package)
Release
- V0.6.7
0.6.6 - 2026-11-12
Added
- OCX machine-interface contract, the ocx-sdkgen Rust SDK generator, and exit codes 83–87 folded into the next-action codes BREAKING
- Cli.json marks a flag that repeats with repeatable: true (cli)
- Every CLI-level refusal names its cause in error.detail (cli)
- --purge on add, remove, lock, update and upgrade deletes the packages they unpin when nothing else references them (cli)
- The PR body names carried tags and a rebuild onto the base (announce)
- Warn when joining an announce PR opened by someone else (announce)
- The JSON report states the branch state, base, ref update, carried tags and PR author (announce)
- A group tool can reuse the default pin with { from = “default” } (project)
- Ocx exec and ocx env --with <package> add packages not in the project (exec)
- Ocx exec --stack layers the project onto the already active environment instead of replacing it (exec)
- Ocx pull without -g pulls only the default group, and takes package names (pull) BREAKING
- Bare ocx shell opens your shell inside the project environment (shell)
- Ocx update and ocx upgrade without -g re-resolve only the default group (update) BREAKING
- Ocx lock re-resolves only the tools whose ocx.toml entry changed (lock) BREAKING
- Ocx exec layers onto the caller’s environment, and only __OCX_ENV_STATE and OCX_BINARY_PIN reach child processes (exec) BREAKING
Changed
- OCX_LAUNCH_IDENTITIES is renamed __OCX_LAUNCH_IDENTITIES, marking it ocx-internal (patches) BREAKING
Documentation
- Home nav and logo leave the SPA for the ocx.sh root site (website)
- The docs move to Starlight with task-first pages and a reference generated from the CLI, environment and config…
- Render Markdown with the theme on Sätteri (website)
Fixed
- Pin the uv projects to Python 3.14 (test)
- Keep the reports and errors contracts at v1 while the interface hardens (schema)
- A transient GitHub OIDC token fetch failure exits 75 so CI retries it (sign)
- Repeatable flags such as --env and --group take a list (sdkgen)
- Commands that return raw output fail on a non-zero ocx exit (sdkgen)
- The generated SDK builds warning-free in repos that do not ban std::env reads (sdkgen)
- The compat gate checks both args when a flag’s long and short spellings split (sdkgen)
- PowerShell emits escape the typographic quotes PowerShell also reads as quote delimiters (shell)
- Patch sync fans out to windows/arm64 like every other platform OCX ships (patch)
- The docs deploy builds the ocx binary its terminal recordings run instead of failing on a missing test/bin/ocx (website)
- Ocx.sh/schemas/ lists the published JSON Schemas (website)
- Ocx remove drops only the binding and leaves package install symlinks alone (cli)
- The changelog page shows the release notes again instead of an empty body (website)
- A credential helper installed through ocx no longer deadlocks ocx update and ocx pull
ocx patch syncfetches each descriptor and installs each companion once instead of once per base and platform (patch)ocx package create’s binary scan claims only programs on PATH, never shared libraries (package)- A pre-release no longer blocks a stable release’s cascade to X.Y, X and latest (package)
- A stale-branch rebuild commits every carried tag’s object (announce)
- Refuse to commit or write a root that references an object it does not carry (announce)
- A rerun over a missing object commits it instead of reporting unchanged (announce)
- A private index read without a token says to set OCX_ANNOUNCE_TOKEN (announce)
- A Windows lock wait never outlasts its timeout, and a try-lock never sleeps (store)
- An env package no longer exposes its private interpreter as a
pythonentrypoint (python) - A tool run under
ocx --global execno longer inheritsOCX_GLOBAL(config) - Quote the Bazel cache rc paths so a RUNNER_TEMP with a space stays one token (ci)
- Ship Windows arm64 from a native build, the bytes readiness tests, and gate the Linux glibc floor (release)
- A tool run under
ocx --project <p> execno longer inheritsOCX_PROJECT(config) - The per-prompt
ocx:summary no longer lists ocx-private__OCX_*variables (shell) - A --fork into your own GitHub account creates the fork instead of failing with 422 (announce)
- Packages addressed by their ocx.sh index name verify against the backing registry instead of failing with 401 (verify)
- Ocx lock honours lazy-mode, and names tools it could not render offline (lock)
- An interactive shell started by ocx exec -g keeps the selected groups instead of the default set (exec)
- Ocx pull declares its NAME positional after every flag (pull)
- A from = “default” follower moves with its source, and ocx clean keeps patch companions matched through a dependency (toolchain) BREAKING
- Old environment-reference links to OCX_ENV and __OCX_LAUNCH_IDENTITIES resolve again (docs)
- Ocx --remote index catalog lists registries no index owns, and fails when an index serves no catalog (index)
- The telemetry credential reaches only the step that exports test timings (ci)
- The docs job names a page whose HTML outgrew Lighthouse’s first round trip instead of failing on performance 99 (ci)
- A lock written by a newer ocx tells you to upgrade ocx, and ocx 0.6.5 and older cannot read a version 4 lock (lock)
- The release bump also sets the Bazel module version, and a stale one fails bazel:pin:check (release)
- Ocx exec --clean keeps SystemRoot on Windows, without which a child process cannot start there (exec)
Release
- V0.6.6
Older releases are on the GitHub releases page.