v0.4.1 Stable

This file is the tracked release notes source for the stable patch release that hardens Skylattice's Hosted Alpha deployment contract.

Canonical public page: releases/v0-4-1.md

Release Positioning

v0.4.1 Stable is the first patch release after the hosted web control-plane foundation.

It does not widen the product into a hosted runtime.

It does make the Hosted Alpha story more credible by hardening:

• production-style control-plane persistence behavior
• deployment and bootstrap guidance
• browser-visible state boundaries
• build reliability for the web workspace

What Changed Since v0.4.0

• added a blocked Hosted Alpha persistence mode so production-like deployments no longer silently fall back to local-file state
• added route-level blocked responses for control-plane APIs when Hosted Alpha env is incomplete
• added a tracked Hosted Alpha runbook, env template, SQL bootstrap, and maintainer commands for readiness checks plus database bootstrap
• added app-shell status surfaces that distinguish preview, local development, Hosted Alpha blocked, and real paired control
• stripped connector tokens from browser-facing device and pairing payloads
• switched the web workspace typography to repo-local font assets so web:build no longer depends on live Google Fonts fetches

What This Release Keeps Intact

• local-first execution
• local memory and SQLite truth
• GitHub as auth and collaboration surface, not runtime truth
• explicit approvals for risky local or external actions
• preview as a read-only first-look surface rather than a fake live environment

5-Minute Verification Path

1. python -m pip install -e .[dev]
2. npm install
3. python -m skylattice.cli doctor
4. npm run web:build
5. python -m pytest -q
6. python tools/run_validation_suite.py
7. python -m mkdocs build --strict

Optional Hosted Alpha maintainer checks:

1. npm run web:hosted-alpha:check
2. npm run web:hosted-alpha:bootstrap

What To Cite And Share

• Pages homepage: https://yscjrh.github.io/skylattice/
• web control-plane page: https://yscjrh.github.io/skylattice/web-control-plane/
• Hosted Alpha runbook: https://yscjrh.github.io/skylattice/ops/hosted-alpha-runbook/
• proof page: https://yscjrh.github.io/skylattice/proof/
• stable release page: https://yscjrh.github.io/skylattice/releases/v0-4-1/
• repository: https://github.com/YSCJRH/skylattice

Known Limits

• there is still no public hosted app deployment URL created from this repository alone
• the real Hosted Alpha deployment still requires Vercel, Neon, and GitHub OAuth setup outside the repo
• task execution is still text-native rather than AST-aware
• meaningful task planning still depends on OPENAI_API_KEY
• radar live discovery still depends on explicit provider credentials
• Figma and Linear delivery objects still need to be created in their external systems

Suggested GitHub Release Body Shape

• what Skylattice is
• what changed since v0.4.0
• how Hosted Alpha is now hardened without becoming hosted execution
• verification path
• deployment and onboarding caveats
• feedback wanted