v0.1.3

SparseRead v0.1.3 — Codex/Pi large-workspace fix

This patch release preserves the v0.1.2 Codex and Pi integrations and fixes a
timeout observed in a large local project. After an agent switched a long file
to full_fidelity, the shared host bridge still recursively inspected its
parent collection even though the request had already selected native reading.
The bridge now skips that unnecessary parent check for this explicit native
veto. Reader algorithms, BenefitGate thresholds, and evidence format are unchanged.

Download and install

Download sparseread-source-installer-v0.1.3.zip or
sparseread-source-installer-v0.1.3.tar.gz from this release, verify the
attached SHA256SUMS, and extract the archive. From the extracted directory:

uv run --python 3.12 python scripts/install_sparseread.py \
  --platform codex --workspace /absolute/path/to/project --doctor

uv run --python 3.12 python scripts/install_sparseread.py \
  --platform pi --workspace /absolute/path/to/project --doctor

Requires Python 3.11+, uv, Node.js 22+, and the corresponding agent CLI. The
source installer fetches dependencies; it is not an offline binary. Restart or
reload the agent in the target project and review its plugin/extension trust
prompts. Codex hook trust is separate from plugin installation; the installer
does not approve hooks or Pi project extensions for you.

Verification and limits

• The full Python suite and a Codex/Pi regression for the native-veto path
  passed before release. In the affected local project, the previously timed-out
  full-fidelity decision returned native in about 3 ms after reinstall.
• Actual Codex app-server loading exposed all six MCP tools. Deterministic
  replay on two local Markdown records and one JSONL trace passed targeted
  evidence, exact raw verification, and native fallback checks. A narrow
  refine was needed to recover one exact protocol line missed by initial focus.
• The user confirmed the plugin appeared in Codex App, approved its hooks, and
  observed actual sro_preview and sro_read calls in a new App chat. App hook
  interception itself was tested through the host hook contract, not an
  automated GUI run. This is not an autonomous model-quality or token benchmark.

No private record bodies, App transcripts, or credentials are included. PyPI,
npm, and framework marketplace publishing are not part of this release; the
source-installer bundle is the supported end-user download. The original
v0.1.2 release
and its assets remain unchanged.

Installation and recovery ·
Historical v0.1.2 record replay

v0.1.2

SparseRead v0.1.2 — Codex and Pi integrations

Codex and Pi now join the existing Claude Code, OpenCode, OpenClaw and NanoBot
adapters. Framework adapters reuse SparseRead core: reader algorithms and gate
thresholds are unchanged; package version metadata is synchronized to 0.1.2.

Download and install

Download sparseread-source-installer-v0.1.2.zip (Windows or any OS) or
sparseread-source-installer-v0.1.2.tar.gz (macOS/Linux), verify it against
the attached SHA256SUMS, and extract it. Open a terminal in sparseread-v0.1.2.
The source bundle is not an offline binary: dependency installation needs network
access. Prerequisites: uv, Python 3.11+ (commands select 3.12), Node 22+, and the
target agent CLI. Tested host versions: Codex CLI 0.158.0-alpha.2 and Pi 0.87.1.

uv run --python 3.12 python scripts/install_sparseread.py \
  --platform codex --workspace /absolute/path/to/project --doctor

uv run --python 3.12 python scripts/install_sparseread.py \
  --platform pi --workspace /absolute/path/to/project --doctor

Restart/reload in the target project. Review project extensions and Codex hooks
before trusting them. If Pi reports an untrusted project, review its files and
explicitly rerun with --pi-approve: approval applies only to that install
command. SparseRead does not add it automatically. Use --sparseread-mode advisory
for non-blocking guidance; --reader-extras none omits PDF/XLSX dependencies.

The individual Codex/Pi archives are developer/plugin resources, not standalone
Python runtime installers. The source-installer bundle is the recommended end-user
download. This release attaches npm tarballs and Python distributions to GitHub;
it does not claim that these versions were published to npm or PyPI.

Fixes and verification

• Workspace-local wheel runtime, six tools, conservative once-only native-read
  redirection, native fallbacks, and project configuration preservation.
• Codex cache-safe reinstalls; Pi persistent JSONL lifecycle, UTF-8, cancellation,
  timeout and restart handling; installation symlink overwrite protection.
• Stale raw references and core protocol errors are failed tool calls, not
  successful evidence. Raw ranges use Unicode character offsets, not bytes/lines.
• Actual installed Codex MCP and Pi SDK extension replay five local record
  scenarios. Broad long-log focus required a fixed follow-up to retrieve all
  expected details; JSONL remains native rather than an unsupported sparse reader.
• Clean source-bundle installation succeeds in a Chinese/space-bearing project
  path. Full regression, Node 22/24 tests and independent Luna/max audit are
  documented in the linked reports.

No private record bodies or full local traces are distributed. Deterministic
tool replay is not an autonomous model quality/token benchmark; real Windows
agent hosts and older host versions remain unverified.
Evidence-only reduction is not total response savings: in these samples, short
logs/summaries returned more JSON characters than the original file. Prefer
native/bounded reads for short or full-fidelity tasks; see the overhead table.

Installation and recovery ·
Real-record validation ·
Independent review

v0.1.1

What's Changed

• Fix/windows fresh install by @xueluo124 in #7
• Publish SparseRead GitHub Pages site by @Zedong-Liu in #9
• Update SparseRead How section on GitHub Pages by @Zedong-Liu in #10
• Add widescreen demo GIF to README intro by @Zedong-Liu in #11
• Update SparseRead GitHub Pages site by @Zedong-Liu in #12

New Contributors

• @xueluo124 made their first contribution in #7

Full Changelog: v0.1.0...v0.1.1