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.

v1.x Version

Architecture, implementation status, and evidence for the processkit v1 line.

The v1 line is an active prerelease, not only a design proposal. v1.0.0-alpha.5 supplies a native Rust lifecycle CLI, a signed release contract, generated schemas, and the Python MCP runtime as visible project content.

The RFC and planning pages in this section remain useful design history. Statements written as future requirements are not evidence that a feature is implemented. Use the implementation review for the current truth.

Current Status

The fixed architecture is:

  • Rust owns release trust and project-content lifecycle.
  • Python remains the authoritative MCP implementation.
  • skills, schemas, processes, state machines, and entities remain files.
  • context/ is dogfood consumer state; src/context/ is the release producer payload.
  • the supported v0 line remains the default while v1 is exact-pin alpha.

Design and Evidence Documents

Supporting Analysis

Branch Contract

The v1 development line is isolated from v0 maintenance:

  • schema source and generated schema machinery
  • v1.0 ontology and migration adapters
  • MCP gateway, helper, and index changes required by the RFC
  • automated fixture suites and first-ART validation evidence
  • docs and acceptance-gate updates for the v1 line
PurposeBranchTag policy
v0 maintenance developmentv0.x-devnever tag
v0 integrationv0.x-releasestable v0 tags only
v1 developmentv1.x-devnever tag
v1 prerelease integrationv1.x-pre-releasev1 alpha, beta, and RC tags only
v1 GA integrationv1.x-releasestable v1 tags only
published historymaincontains every stable tagged release

v1.x-dev merges to v1.x-pre-release for each prerelease. At general availability, create v1.x-release from the selected prerelease state, validate and tag there, then merge it into main. v0 follows the same development-to-release-to-main pattern. Security fixes and dependency bumps may flow between lines when needed; feature work does not automatically backport.

Historical-page convention

Every page below this section is reviewed against alpha.5, but several pages describe a target gate or the reasoning that preceded implementation. Treat the labels as follows:

  • Implemented means executable code and release evidence exist.
  • Partial means a safe subset exists and the remaining behavior is named.
  • Planned means the page is a design contract, not a supported command.
  • Historical means the page records an earlier alpha planning stage.

Issue #135 Implementation Review

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

Acceptance Gate

Readiness criteria for processkit v1.0 stages.

Alpha Release Testing

Publish and consume an explicit v1 prerelease safely.

Alpha Scope

First buildable vertical slice for processkit v1.0.

Alpha.3 Closure Plan

Feature-completion gates for the final pre-cutover alpha.

Analysis Archive

Supporting analysis used to shape the processkit v1.0 plan.

Architecture Specification

Architectural direction for processkit v1.0.

Beta Ontology Plan

Dependency-aware target for processkit v1.0 beta coverage.

Branch Start Work Plan

Phase plan for beginning the processkit v1.0 branch.

Landscape Note

Adjacent projects and concepts processkit should learn from.

Ontology Reference

T/P/D/C ontology baseline for processkit v1.0.

Product Specification

Product definition for processkit v1.0.

Test Strategy

Automated testing strategy for processkit v1.0.

Tooling Architecture

MCP, schema, and index architecture for processkit v1.0.

v0 Reconciliation

Controlled carry-over from the supported v0 line into v1.