Fruth 0.1.3

Fruth 0.1.3

Fruth 0.1.3 adds local Apple Foundation Models and optional Apple Private Cloud
Compute, native macOS PDF processing, improved follow-ups and provider recovery,
and reusable Research evidence review. The experimental 0.x support scope
remains unchanged.

• Apple AI: on-device text and image analysis through the installed fm
  transport, with instance controls, streaming and request-bound context.
• Apple PCC: optional cloud text/image execution through user-installed
  Shortcuts, with recorded tier fallback and provider-limit evidence.
• PDF handling: native PDFKit/CoreGraphics page rendering, retained pypdf
  text extraction, fresh processing for incoming PDFs and ordered page dispatch
  through the selected OCR/vision path. Rendering and transcription accuracy
  remain separate guarantees.
• Follow-ups and fallback: reuse saved image/audio evidence, carry full
  selected replies and multiple artifact references, and recover eligible
  provider failures through bounded compatible alternatives while respecting
  explicit targets, refusals and evidence gates. Public artifact lists preserve
  registered dependency identities, consistently with downloadable bundles.
• Research: maintained offline candidate audit, exact response inspection,
  explicit Gold curation and retained-evidence validation. New installations
  initialize empty stores; private cases, reviews and retained evidence are not
  shipped.
• Documentation and packaging: current backend diagram, PCC setup guide,
  dependency/setup instructions and reproducible source archives with checksums.

Installation and upgrading

The supported environment is macOS on Apple Silicon with Python 3.11 or newer.
Extract the source archive, enter fruth-0.1.3, and run ./fruth start. A fresh
installation creates its Python environment and installs requirements; the
initial installation needs internet access. Backend runtimes and model weights
are separate. Apple AI requires available Apple Intelligence and fm; PCC
requires the Shortcuts described in the included setup guide.

For an existing environment, update requirements explicitly before the next
start/restart:

.venv/bin/python -m pip install -r requirements.txt

Preserve existing settings, state/, artifacts/ and Research stores. An empty
registry or store in a fresh release is not a migration over saved user data.

Conformance evidence

The dated September 25–27 campaigns remain unchanged. AFM recorded 168 passing
cases and two correct audio/transcript mismatch rejections, leaving successful
handoff coverage incomplete for those two cases. PCC recorded 126 passing cases;
remaining coverage includes provider-quota blocks, one sequence timeout and one
correct mismatch rejection. Neither campaign recorded invariant findings; both
retain their native INCOMPLETE verdict.

These campaigns predate the later PDF, provider-failover and Research changes.
They are historical integration evidence, not a full-conformance claim for every
0.1.3 path. Apple model output quality, guardrails, availability and usage limits
remain provider-dependent. The observed four-page AFM transcription had reading
errors despite complete page coverage.

Fruth's code and project documentation remain Apache-2.0. The separately licensed
bundled font retains its attribution and OFL license. Python dependencies,
Apple frameworks, backend runtimes and model weights are not bundled.

Release validation

The isolated offline checks passed 4,426 distinct tests, with one expected skip
for a development-only compatibility entrypoint excluded from source releases.
This includes native PDF rendering, Apple transports/fallback, response and
artifact contracts, and Research verification. Initial failures were resolved
through fixes and explicit reruns. No new live conformance campaign was run.

The attached source archive is the curated 467-file distribution; its SHA-256
checksum is attached separately. Backend runtimes, model weights and private
runtime/Research data are excluded.

PCC shortcut download added September 28

Download fruth-pcc-shortcuts.zip and its .sha256 checksum from the assets below.
The ZIP contains importable Fruth PCC (Cloud) and Fruth PCC Pro (Cloud Pro)
shortcuts, import instructions and file checksums. Import them explicitly in
Apple's Shortcuts app, keeping the exact names and avoiding duplicates. Apple's
model availability, access requirements and usage limits still apply.

Both exports were inspected and accepted by Shortcuts' import preview; the
focused packaging checks passed 46 tests. The original 0.1.3 tag, source archive
and source checksum are unchanged. The shortcuts and updated setup guide are
also available in the repository's main branch.