Preview This is the v1.0 preview line. It documents a rebuild that is still in alpha — schemas, tool names, and package contents change without notice, and nothing here is covered by a stability guarantee. For the released line, see the v0.x documentation.

Issue #135 Implementation Review

Final requirement review of the Rust CLI and Python MCP product briefing against the v1.x development line.

This final review compares GitHub issue #135 with the v1.0.0-alpha.5 implementation and its published release evidence.

Summary

The corrected product boundary and trustworthy local lifecycle are implemented. The Rust executable verifies and transactionally applies an explicit release; Python remains the MCP runtime; release content stays visible; and interruption recovery is exercised with real processes.

Issue #135 is complete as the v1.x implementation umbrella. Three extracted engineering tracks are implemented in alpha.5. The four-platform publication track remains open until locally produced artifacts from every supported host have been collected and verified.

Coverage Matrix

Requirement clusterStatusCurrent evidence or follow-up
Rust CLI / Python MCP / visible-file boundaryImplementedRust binary under installer/; Python servers ship with skills; release and architecture docs state the fixed boundary
context/ dogfood vs src/context/ payloadImplementedRelease-boundary checks prevent project entities from entering the staged payload
Deterministic plan and transactional install/update/recover/uninstallImplementedplanner.rs, transaction.rs, target lock/staging/journal tests, lifecycle pilot
Signed release and native verificationImplementedEd25519 envelope binds archive, descriptor, provenance, and all four native installers
Opaque execute --request automation contractImplementedVersioned request/result schemas and golden fixtures
Rust modularization and typed failuresImplementedFocused modules, stable error tests, a public library API, rustdoc, and runnable examples
README/help/schema consistencyImplementedShipped CLI help and release facts are generated and checked by the mandatory local installer gate
Four native target platformsPending local host evidence#165 requires locally built and natively smoke-tested outputs from all four supported hosts
Bootstrap installerImplementedExact-version, non-root checksum/signature verification uses the canonical fingerprint and fails closed
Human exact-version online resolutionImplementedExact tags resolve to immutable release assets; absent versions fail without fallback
Python/uv runtime contractImplementedEvery profile uses the shipped universal, hash-locked dependency set, including offline verification
Native processkit doctor and processkit mcpImplementedStable runtime, container, and deferred host-only findings include IDs, severity, and remediation
Extracted-release MCP acceptanceImplementedPackage smoke starts the staged gateway and exercises representative tools
Repository dogfood update/recovery acceptanceImplementedThe release gate combines the full-content lifecycle pilot with a deterministic real-process update interruption, rollback, user-data preservation, retry, and provenance verification
v0 migration and aibox parityImplementedVersioned ownership baselines cover mixed roots, replay is idempotent, ambiguity blocks safely, and direct/aibox state is identical
Harness projection ownershipImplementedCodex and Claude adapters preserve unrelated keys and have lifecycle tests
Stable/prerelease documentation storyImplementedDocs separate v0 stable and v1 preview and generate release facts, CLI help, and public Rust API guidance

What Users Can Rely On

  • exact local and immutable published release inputs;
  • checksum and Ed25519 verification;
  • a non-mutating deterministic plan;
  • transactional install and update with persisted ownership;
  • recovery after interrupted installer transactions;
  • conservative uninstall that preserves changed or user-owned files;
  • installed-provenance verification;
  • Codex and Claude managed-key projections;
  • Python MCP operation from the extracted package;
  • versioned machine request/result envelopes for integrators;
  • mixed-root v0 migration with replay-safe evidence; and
  • reproducible, hash-locked Python runtime dependencies.

What Users Must Not Assume

  • native semantic corpus migration, package, or harness commands;
  • removal of Python or uv as runtime dependencies;
  • in-place mutation of an existing v0 source tree; or
  • GA stability of alpha contracts.

Extracted GA Follow-ups

  1. #165: trusted four-platform release distribution
  2. #167: v0 mixed-root baselines and CLI/aibox parity
  3. #168: generated CLI, release, and Rust API documentation
  4. #170: runtime dependency locking and host-health coverage

Alpha.5 completes the trustworthy native lifecycle around visible content and the Python MCP runtime. Issue #165 remains the publication gate; the other three follow-ups are complete.