Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
49 commits
Select commit Hold shift + click to select a range
2ada3d9
test(gguf): isolate corruption from live reconciliation
MrScripty Oct 11, 2026
ada3258
fix(integrity): stop automatically rechecking acquired file hashes
MrScripty Oct 11, 2026
3c43c7c
docs(release): record validated Linux checksum-policy candidate
MrScripty Oct 11, 2026
f92d35f
fix(frontend): limit partial recovery warning to inactive downloads
MrScripty Oct 11, 2026
5acc207
docs(release): record validated download-warning candidate
MrScripty Oct 11, 2026
277fff0
fix(models): surface refused deletion on the selected artifact
MrScripty Oct 11, 2026
8832b01
docs(release): record verified model-deletion installers
MrScripty Oct 11, 2026
963fe94
fix(frontend): show failed downloads on their library rows
MrScripty Oct 11, 2026
6761244
docs(release): record verified download-outcome installers
MrScripty Oct 11, 2026
bf19765
fix(downloads): preserve partials on resume and restart
MrScripty Oct 11, 2026
490c226
docs(release): record verified resume-policy installers
MrScripty Oct 11, 2026
d959480
test(rpc): report unexpected vision request provenance
MrScripty Oct 11, 2026
896a7e6
fix(library): allow deletion during unrelated HF downloads
MrScripty Oct 11, 2026
0ba3b6c
fix(library): serialize link registry mutation publication
MrScripty Oct 11, 2026
63299e8
docs(release): record verified deletion installers
MrScripty Oct 11, 2026
787baca
test(electron): resolve transport fixture paths with spaces
MrScripty Oct 12, 2026
0175852
fix(rpc): close observation streams without failing shutdown
MrScripty Oct 12, 2026
709148e
feat(downloads): reconcile retained files at changed locations
MrScripty Oct 12, 2026
46459b0
docs(release): record verified download recovery installer
MrScripty Oct 12, 2026
b098fdf
fix(frontend): restore readable library recovery colors
MrScripty Oct 12, 2026
b2c8414
docs(release): record verified library contrast installer
MrScripty Oct 12, 2026
0c6e1f1
feat(api): explain rejections, unify operation grammar, list served m…
MrScripty Nov 2, 2026
59d58e5
feat(inference): serve vision-language and multimodal embedding models
MrScripty Nov 2, 2026
4c79cd8
feat(inference): add decision capability for llama.cpp decision models
MrScripty Nov 2, 2026
832767a
docs(release): describe the v0.8 typed API changes
MrScripty Nov 2, 2026
eaeae33
docs(plan): record consumer API milestone status
MrScripty Nov 2, 2026
d9f67b5
fix(startup): keep running when saved download state is unreadable
MrScripty Nov 2, 2026
40ee738
fix(desktop): single-source startup recovery contracts and report rea…
MrScripty Nov 2, 2026
619c55c
Merge fix/main-test-validation: download recovery, deletion and check…
MrScripty Nov 2, 2026
cab2b51
fix(rpc): carry the failure reason in RPC and outcome errors
MrScripty Nov 2, 2026
268aba2
refactor(electron): declare upgrade confirmation and import selection…
MrScripty Nov 2, 2026
4a790e0
refactor(torch): type the desktop Torch inspection responses
MrScripty Nov 2, 2026
8ad8863
refactor(desktop): validate update streams from the backend declaration
MrScripty Nov 2, 2026
2016075
test(release): guard the audio session step against rehashing
MrScripty Nov 3, 2026
848cc91
build(deps): apply the Dependabot cargo and npm group updates
MrScripty Nov 3, 2026
1b1438e
docs(release): state the llama.cpp build EmbeddingGemma 2 needs
MrScripty Nov 3, 2026
79fd6c5
test(native): match the native QA tests to current platform behavior
MrScripty Nov 3, 2026
8d03e4d
fix(serving): size llama.cpp pooled batches from the served context
MrScripty Nov 3, 2026
b119683
build(release): set the source version to 0.8.0
MrScripty Nov 3, 2026
c43b13b
fix(library): treat a model moved during reconciliation as a stale scope
MrScripty Nov 3, 2026
81120ff
fix(library): keep owned migrations and merges out of watcher reconci…
MrScripty Nov 3, 2026
8de91ca
build(rust): compile test-only helpers only where their tests run
MrScripty Nov 3, 2026
e59b1fb
fix(release): build host-independent headless checksum inventories
MrScripty Nov 3, 2026
0fdf223
fix(macos): resolve registry lookups and test roots canonically
MrScripty Nov 3, 2026
1d26ca0
fix(windows): report the owner root in display form and match it in t…
MrScripty Nov 3, 2026
4ea3c9a
fix(release): retry retryable conflicts in the packaged ONNX verifier
MrScripty Nov 3, 2026
0ee2ef0
test(native): match integration tests to macOS and Windows path and l…
MrScripty Nov 3, 2026
f21d19b
fix(release): recognize packaged ONNX Runtime loaded through a verbat…
MrScripty Nov 3, 2026
f4e1c21
test(native): build RPC fixtures from the canonical library root
MrScripty Nov 3, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 18 additions & 4 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -367,7 +367,7 @@ jobs:
run: |
set -euo pipefail
PUMAS_AUDIO_SESSION_PYTHON="$(python - <<'PY'
import hashlib, json, os
import json, os
from pathlib import Path
root = Path(os.environ['QUALIFICATION_ROOT']).resolve(strict=True)
record = json.loads((root / 'torch-versions/v2.10.0/runtime.json').read_text())['managed_python']
Expand All @@ -376,9 +376,6 @@ jobs:
executable = Path(record['executable']['path'])
assert executable.is_absolute() and executable.resolve(strict=True) == executable
assert executable.is_relative_to(root) and '\n' not in str(executable) and '\r' not in str(executable)
assert record['executable']['sha256'] == pin['interpreter_executable_sha256']
with executable.open('rb') as source:
assert hashlib.file_digest(source, 'sha256').hexdigest() == pin['interpreter_executable_sha256']
print(executable)
PY
)"
Expand All @@ -392,6 +389,15 @@ jobs:
shell: bash
run: |
set -euo pipefail
mkdir -p "$EVIDENCE_DIR"
for phase in cold warm; do
for kind in runtime confined-dependency-probe; do
evidence="$QUALIFICATION_ROOT/audio-$phase-$kind.json"
if test -f "$evidence"; then
cp "$evidence" "$EVIDENCE_DIR/"
fi
done
done
selection="$QUALIFICATION_ROOT/torch-versions/v2.10.0/runtime.json"
if test -f "$selection"; then
mkdir -p "$EVIDENCE_DIR"
Expand All @@ -407,6 +413,10 @@ jobs:
${{ runner.temp }}/review-audio-evidence/probe.log
${{ runner.temp }}/review-audio-evidence/installed-runtime.json
${{ runner.temp }}/review-audio-evidence/audio-confined-dependency-probe.json
${{ runner.temp }}/review-audio-evidence/audio-cold-runtime.json
${{ runner.temp }}/review-audio-evidence/audio-warm-runtime.json
${{ runner.temp }}/review-audio-evidence/audio-cold-confined-dependency-probe.json
${{ runner.temp }}/review-audio-evidence/audio-warm-confined-dependency-probe.json
${{ runner.temp }}/review-audio-evidence/controlled-session-protocol.log
if-no-files-found: ignore
retention-days: 7
Expand Down Expand Up @@ -532,6 +542,10 @@ jobs:
run: python scripts/release/test-acquisition-integration.py --package pumas-rpc --features test-support --minimum 2
- name: Test cross-owner inference-disabled RPC shutdown
run: python scripts/release/test-acquisition-integration.py --package pumas-rpc --no-default-features --features test-support --minimum 1
- name: Test native retained-download reconciliation
run: cargo test --locked --manifest-path rust/Cargo.toml -p pumas-library retained_location
- name: Test inference-disabled retained-download reconciliation
run: cargo test --locked --manifest-path rust/Cargo.toml -p pumas-library --no-default-features retained_location
- name: Test inference-disabled native HTTP drainage
run: cargo test --locked --manifest-path rust/Cargo.toml -p pumas-rpc --no-default-features http_transport::tests
- name: Test reserved acquisition workspace custody
Expand Down
56 changes: 54 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/).

## [Unreleased]

## [0.8.0] - Unreleased candidate
## [0.8.0] - Unreleased

Source manifests currently identify `0.8.0-rc.1`; no final release is implied.
Source manifests identify `0.8.0`. The date is set when the release is published.
See [release notes and migration](docs/release-notes-0.8.0.md) and the
[checkpoint qualification](docs/release-qa-0.8.0.md) before choosing a consumer pin.

Expand All @@ -25,6 +25,13 @@ See [release notes and migration](docs/release-notes-0.8.0.md) and the
- Pinned inference-enabled headless candidate assembly for Linux x86_64,
Windows x86_64 and macOS ARM64. The release inventory now requires sixteen
artifacts; assembly and startup do not qualify pretrained inference.
- `GET /v1/served-models` lists every served model and profile with its
provider, context size and capabilities, so consumers discover models
instead of configuring profiles by hand.
- `multimodal_embedding` capability: image and mixed text/image embeddings
for llama.cpp embedding models with a projector, such as EmbeddingGemma 2.
- `decision` capability: typed choice/score/yes-no questions answered with
probabilities by llama.cpp native decision models such as Kev and OpenJev.

### Changed

Expand All @@ -34,16 +41,61 @@ See [release notes and migration](docs/release-notes-0.8.0.md) and the
discovery and live download authority remain distinguishable.
- Installed speech has conditional custody and qualification plumbing;
production Audio-to-Text remains unavailable until its admission gates pass.
- Typed operation errors always carry a human-readable `message`, echo the
caller's `request_id` whenever it is readable, and use an HTTP status that
matches the error code. Provider failure reasons reach the caller with
credential-shaped text redacted.
- `/v1/model-operations` has one request grammar: `capability`,
`semantic_task` and `options` are optional selectors, and every request
accepted before remains valid.
- Responses may gain fields, capabilities and enum values within contract
version 1; consumers must ignore what they do not use.
- Limits come from the serving runtime: `max_tokens` is bounded by the served
context, ONNX batch limits apply only to ONNX, and requested embedding
dimensions are applied by Matryoshka truncation when a provider ignores them.
- `/v1/models` lists each model ID once, with its serving profiles.
- Desktop Torch install choices, saved probe results, startup trials and
alternative wheels are declared once by the backend and validated from that
declaration. The saved probe result carries only the checks the desktop shows.
- Desktop update streams (model library, downloads, runtime profiles, serving
status and status telemetry) are validated against the backend's declaration.
A rejected desktop payload says which field and rule failed.
- Updated Electron to 43.8.1, Vite to 6.4.5, undici to 6.29.1 and 7.30.1,
`zip` to 2.6.1, `rustls` to 0.23.46 and `rand` to 0.10.

### Fixed

- Vision-language models published as `image-text-to-text` (Gemma, Qwen VL)
are available for chat and image-to-text instead of reporting a task mismatch.
- A model directory's primary file is never its multimodal projector, which
had launched EmbeddingGemma 2's projector as the model and broke llama.cpp
router catalog generation.
- llama.cpp embedding and reranking models launch in embedding/reranking mode
in dedicated profiles too, with a micro-batch that fits whole inputs: the
served context when the profile sets one, otherwise 8,192 tokens, never more
than the model's trained context. Ollama embedding models load through
`/api/embed`.
- Saved download state that this version cannot read (for example, fields
written by a newer Pumas) no longer stops the backend. The library, models
and inference start, downloads are disabled without rewriting that state,
and the reason is shown in a status banner.
- A backend that cannot start reports why, and the desktop recovery screen
shows that reason instead of guessing. The startup diagnostic is read across
builds, ignoring fields it does not know.
- Offer explicit recovery for moved legacy download files in the running desktop,
preserving files and failed-attempt history while releasing exact download custody.
First confirmation upgrades the HF partition and warns older direct readers.
- Close read-only desktop update streams without falsely failing instance shutdown.
- Desktop startup failures keep recovery and metadata upgrade actionable,
including small windows and failed replacement startup attempts.
- Startup preserves retained downloads whose destination folders are missing,
without recreating folders or finalizing absent outputs.
- Receipt-bound GGUF selection survives owned library moves, and explicit
headless legacy-schema preflight avoids creating a new failed owner claim.
- Candidate packaging selects notices matching the current source version.
- A failed Torch startup trial reports why the managed launch failed.
- A desktop update that fails validation is no longer dropped silently, which
had left views stale; the reason is reported and the view reloads.

## [0.7.0] - Unreleased candidate

Expand Down
10 changes: 5 additions & 5 deletions RELEASING.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Do not dispatch this merely because a PR is green. Complete native artifact and
trained-model acceptance before the maintainer's later tag/publication decision.
The same existing package jobs and final inventory checker serve rehearsals and
tags; branch rehearsal does not imply a prerelease or final release. A tag must
match source manifests exactly. Current `0.8.0-rc.1` must never be tagged `v0.8.0`.
match source manifests exactly; the manifests identify `0.8.0`.

1. Update `CHANGELOG.md` and the version's release notes. Keep an empty
`Unreleased` section for subsequent changes.
Expand Down Expand Up @@ -62,7 +62,7 @@ failures.
```bash
pnpm install --frozen-lockfile
npm run check:dependency-ownership
npm run check:release-versions -- v0.8.0-rc.1
npm run check:release-versions -- v0.8.0
node --test scripts/release/*.test.mjs
./scripts/rust/check.sh
cargo test --locked --manifest-path rust/Cargo.toml --workspace --exclude pumas_rustler --profile ci-test
Expand Down Expand Up @@ -146,7 +146,7 @@ crate archives and host-binding bundles are not release assets.

## Attribution and artifact metadata

The checked-in [attribution collection](docs/release-attribution/0.8.0-rc.1/README.md)
The checked-in [attribution collection](docs/release-attribution/0.8.0/README.md)
is embedded in desktop packages. After dependency or manifest changes, run
`python3 scripts/release/generate-notices.py` and review the source-text inventory.
CI and Electron beforePack reject missing or stale attribution. Preserve
Expand Down Expand Up @@ -181,8 +181,8 @@ untrained ONNX graph through its own extracted Pumas binary, observes the pinned
native runtime mapping, and requires graceful shutdown. Its separately labeled
fixture hashes and lifecycle log are execution evidence, not pretrained Nomic
acceptance or embedding-quality evidence. No model weights are downloaded.
The integrated candidate identity is `0.8.0-rc.1`. This source-version preparation
does not publish a tag or release and does not qualify native model execution.
The source version is `0.8.0`. Setting it does not publish a tag or release and
does not qualify native model execution.
The producer requires source version 0.8; older 0.7 sources fail before compilation.
After manifest or dependency changes, regenerate/review the matching `<version>`
and `<version>-s3` attribution directories. The generator and inference producer
Expand Down
13 changes: 13 additions & 0 deletions docs/DEVELOPMENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -237,3 +237,16 @@ READMEs, duplicate command guides, or permanent implementation diaries.
Plans are temporary execution authority. Once complete or abandoned, preserve
durable decisions in an ADR/current guide and remove the plan. Audits are dated
snapshots and must name their code and standards baselines.

## Retained-download recovery qualification

The [contract](contracts/download-location-reconciliation.md) owns local acceptance;
[the runbook](runbooks/download-location-reconciliation.md) describes the user action.
Run `cargo test --locked --manifest-path rust/Cargo.toml -p pumas-library retained_location`
with default features and `--no-default-features`. The native CI matrix runs both.
`scripts/acceptance/download_location_reconciliation.py RPC --temporary-parent PATH`
qualifies actual RPC and reopen using tiny authored fixtures. The companion
`download_location_reconciliation_ui.mjs ELECTRON FIXTURE [SOURCE_ELECTRON_DIRECTORY]`
requires that helper's authored marker and uses the actual renderer/preload/IPC/RPC
in the normal Electron sandbox. Qualify display/session and process isolation;
never direct these helpers at a real library.
16 changes: 11 additions & 5 deletions docs/SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,11 +38,17 @@ or diagnostics. `pumas-rpc` does not log request parameter values, including in
debug mode. Request diagnostics use an allowlisted method label, a numeric
request ID when present, and a stable outcome class/code.

JSON-RPC and RPC-owned event errors pass through the Rust producer's stable
public error projection. Its messages are bounded and deny disclosure of raw
internal path, URL, credential, dependency, and upstream error text. Internal
errors must not be serialized through `Display` or `Debug`; new transports must
reuse the same projection.
JSON-RPC, typed HTTP and RPC-owned event errors pass through the Rust
producer's public error projection (`pumas-rpc/src/public_text.rs`). Callers
branch on its stable code and class. Its message carries the failure reason so
the local user and consuming applications can act on it (owner decision,
2026-11-02). Messages are bounded to 1,024 characters and single-line;
credential-shaped words, secret `key=value` pairs, URL user info and URL query
strings (which can hold signatures) are redacted; and the home directory is
shown as `~`. Messages may include other local paths and query-free URLs, which
the receiving boundary already restricts to loopback clients of the same user.
Raw subprocess output is not forwarded. New transports must reuse the same
projection rather than serializing errors directly.

## Dependency and Release Evidence

Expand Down
24 changes: 24 additions & 0 deletions docs/adr/0003-download-location-reconciliation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# ADR 0003: Explicit local acceptance of moved legacy download outputs

Status: Accepted design, implementation in progress.

Historical reclassification moved a live download workspace without rebinding
its admitted attempt. Existing shared mutation authority prevents recurrence,
but retained Error attempts still point to absent old destinations while the
catalog records their files at classified paths.

Keep attempt history, current local availability and verified HF completion as
separate facts. Offer explicit local acceptance of an exact artifact with all
recorded selected files present. Preserve the original Error rather than
rewriting it to Completed or guessing a historical upstream revision.

Use the existing HF lifecycle, root/destination capabilities, destination queue
owner and canonical acquisition-store transaction. Publish the disposition and
exact admission release together; settle the exact dormant live claim before
success. No second journal, path alias registry, model move, payload hash/copy or
SQL repair is required. Keep older readers from silently dropping this meaning
with a partition-owned HF format-6 discriminator, while retaining envelope 7.

The contract is [retained download reconciliation](../contracts/download-location-reconciliation.md).
The [execution plan](../plans/download-location-reconciliation/plan.md) owns pending
compatibility, composed-lifecycle, desktop and artifact acceptance evidence.
Loading
Loading