RhoeJSON Release Readiness Roadmap

Status: active preflight roadmap Target repository: RhoePlatform/RhoeJSON Target release: 0.1.0 License: Apache 2.0

This roadmap tracks the work needed to move the staged public RhoeJSON folder from engine-ready to publication-ready. The repository remains intentionally non-git until every local gate passes.

Lane 1: Public Boundary And Governance

Status: in progress

• Keep the first-wave package scoped to the JSON engine, CLI, preview daemon,

macOS preview menu, WASM facade, tests, docs, examples, and release tooling.

• Document JSONSchemaAIGenerator as an optional macOS-only Apple Foundation

Models system API, not a cloud connector or platform orchestration surface.

• Keep Linux CI free of FoundationModels symbols.
• Maintain Apache 2.0 licensing, NOTICE, governance, security policy,

changelog, release process, issue templates, PR template, and CODEOWNERS.

Lane 2: Documentation Site

Status: started

• Wire the public docs pipeline for guide documentation.
• Build a GitHub Pages-ready artifact in .build/docs-pages.
• Document the Swift package surface, CLI, jq subset, preview daemon, menu app,

WASM facade, binary codecs, structured-format conversion, and platform boundary.

• Add a validation script that fails when the docs site cannot be generated.

Lane 3: Examples Gallery

Status: started

• Add a runnable examples gallery with realistic JSON documents, schemas, patch

files, jq filters, conversion inputs, and preview examples.

• Include exact shell commands and canonical outputs.
• Add a render-all validation script that proves examples are current.

Lane 4: CLI Artifacts

Status: started

• Generate and check in rhoejson manual pages.
• Generate bash, zsh, and fish completions.
• Add drift checks so CLI metadata changes require regenerated artifacts.
• Document Homebrew aliases rhoejn and json.

Lane 5: Homebrew Release

Status: started

• Add a rhoe-json formula template to RhoePlatform/homebrew-rhoe.
• Install rhoejson, rhoejn, and json aliases.
• Include rhoejson-preview-menu for macOS bottles only.
• Keep Linux bottles CLI-only.
• Add source archive checksum and bottle checksum extraction after the

v0.1.0 tag exists.

Lane 6: Linux And WASM Certification

Status: started

• Add native Linux CLI CI that builds rhoejson without compiling

FoundationModels.

• Add optional static Linux SDK certification when the SDK artifact is available.
• Add WASM SDK certification for RhoeJSONWasm when the toolchain is available.
• Keep platform-specific menu behavior as a harmless Linux stub.

Lane 7: Final Cutover

Status: blocked on Linux/WASM certification and remote/tag-dependent release artifacts

• Run the full release gate locally.
• Remove .build, Package.resolved, .DS_Store, and any generated scratch

artifacts.

• Run strict public hygiene with no CI escape hatches.
• Initialize git only after certification.
• Create one clean initial commit.
• Create the private RhoePlatform/RhoeJSON repository.
• Push the initial commit, enable Actions and Pages, run CI, then switch public

only after the final audit passes.