Code UX 0.9.7

Code UX 0.9.7

Code UX 0.9.7 is a broad runtime and dashboard reliability release, adding persistent skill and memory workflows, richer sprint coordination, local speech and 3D Chat capabilities, safer preview and repository operations, and extensive orchestration repairs. See the release PR #2957 for the complete promotion diff.

Release Snapshot

Item	Details
Version	0.9.7
Release commit	964ce8dbe6305a22968ada18eb16aba2195792ca
Release PR	#2957
Included dev sync	#2851
Scope	751 files changed across runtime, dashboard, documentation, and tests

What’s New

Persistent Skills, Memory, and Base Agents

Code UX can now preserve and retrieve reusable operating knowledge with versioned, locally managed storage.

• Persistent skill stores use local-only Git repositories, immutable revisions, read-only provider mounts, and managed mutation history.
• Skill retrieval combines semantic and lexical ranking with heading-aware chunks and a shared token budget across planning, workers, QA, CI repair, and merge repair.
• The Memory Map adds a read-only Skills tier with filtering, search, graph inspection, counts, and bounded API responses.
• Built-in Project Manager and Planning Agent instructions track base revisions, automatically update untouched presets, and offer guarded compatibility updates for customized agents.

Sprint Planning, Progress, and Scheduling

Sprint state is more responsive, more accurate, and easier to audit.

• Sprint summaries expose weighted progress from task lifecycle stages and coding telemetry while preserving raw completion counts.
• MCP sprint planning returns immediately, completes asynchronously, and wakes the originating chat agent with a success or failure recap.
• After-sprint schedules launch only after successful source completion and plan unplanned targets before execution.
• Project Manager continuations appear as agent-owned scheduled events with delivery state, timing, and next-step context.

Human Intervention and Worker Clarification

Operators and coding workers have clearer, durable ways to ask for and provide help.

• A cross-project realtime intervention feed surfaces actionable notifications in navigation, overlays, toasts, and sprint states.
• Assigned workers and worker pools can request clarification through scoped MCP tools before declaring a task blocked.
• Project Managers can answer clarification requests and resume the same coding session without duplicate dispatch.

3D Chat and Local Speech

The conversational workspace now has a substantially richer local voice and agent-presence stack.

• 3D Chat supports validated response emotions, animation cues, refined activity states, and accessible playback controls.
• Catalog-driven create-app quick actions cover web, desktop, game, shop, and portfolio templates for eligible fresh projects.
• Local speech adds Whisper Base/Tiny transcription and Kokoro/Piper synthesis with explicit Local/API routing, lifecycle controls, provenance, hashes, license acceptance, and repair states.
• German speech uses a language-first Piper MLS flow with a pinned eSpeak sidecar and compatible voice selection.
• New replies can auto-play once without replaying loaded history, and speech preprocessing omits widgets, metadata-only payloads, and fenced code.

Projects, Settings, Legal, and Integrations

Core administration surfaces are more focused, accessible, and complete.

• Projects is redesigned as a responsive gallery with clearer selection, status hierarchy, and preserved setup flows.
• Settings adds grouped navigation, live overview cards, focused workspaces, Smart Find, mobile navigation, and persisted accent presets.
• Speech and memory catalogs add search, filters, install details, language metadata, license provenance, and development-only flags.
• General settings exposes the Code UX license and a curated open-source dependency catalog.
• Projects can mount linked Google Drive directories into Project Manager and worker containers, defaulting to read-only access.

Analytics, Preview Runtime, and MCP

Operational visibility and local execution are both more capable.

• Stats adopts the shared v2 layout with clearer token composition, provider distribution, runtime context, and Git/task/sprint workbenches.
• Preview startup, reconciliation, and port allocation are serialized, with recovery for exited containers and orphaned startup rows.
• Trusted previews can opt into validated Docker socket access, Docker CLI, and Compose v2 with explicit host-control warnings.
• Preview commands support project defaults and per-container overrides, and upstream host headers are normalized for local applications.
• The built-in Playwright MCP integration uses the supported package launch shape and migrates untouched saved defaults.
• The vendored models.dev catalog is refreshed with current provider and model metadata.

Fixes

Orchestration and QA Reliability

• Fixed resolved QA handoffs remaining parked in QA_REVIEW_FAILED; addressed tasks now re-enter review safely.
• Bounded QA retries with terminal attempt ceilings, single-use post-cap verification, and stopping on no-progress continuations.
• Fixed ambiguous no-change coding runs being marked complete; they now require a structured completion outcome and fail closed when absent.
• Separated structured provider errors from benign stderr diagnostics so actionable failures reach downstream repair flows.
• Prevented sprint-completion QA, CI repair, and active human handoffs from pausing recoverable runs before retry limits are exhausted.

Preview and Container Reliability

• Fixed preview sessions becoming stuck after interrupted startup, runtime restart, missing containers, or overlapping reconciliation.
• Fixed strict preview applications rejecting contradictory local host and forwarding headers.
• Added the missing Compose plugin path for Docker-enabled previews and exposed project/session Docker policy from the Browser surface.
• Removed shipped preview runtime dependence on host Git.

Navigation and Realtime Recovery

• Fixed chat draft hydration combining a newly selected project with the previous project’s thread.
• Cleared stale realtime cursors after server restart to prevent repeated snapshot recovery and refresh fan-out.
• Prevented out-of-order project and sprint responses from leaking stale selections into Tasks or Live views.

Speech and 3D Chat Reliability

• Fixed inherited incompatible voices after model changes by resolving a valid default for the selected model.
• Surfaced synthesis and browser playback failures beside accessible voice controls.
• Prevented old assistant audio from replaying after refresh, navigation, or history hydration.
• Removed the unreliable Wav2Vec2 local transcription path and migrated unknown local selections to Whisper Base without changing external API settings.
• Restored German 3D Chat speech after cross-scope model changes.

Dashboard and Accessibility

• Fixed unreadable dark-theme markdown links across thread, invocation, system-message, and cinematic chat surfaces.
• Fixed quick actions crowding avatars, overflowing narrow layouts, and bypassing fresh-project eligibility.
• Fixed provider-share rings disappearing when one provider represented nearly all usage.
• Gave built-in MCP tool categories unique detail-workspace identities so expanding one category no longer expands all categories.

Repository Initialization Security

• Hardened initial README.md creation with a fixed contained file URL and no-follow open, preventing a raced symlink from redirecting repository seeding outside the validated clone target.

Validation

Check	Result
Typecheck & Lint	Passed
Backend Tests & Coverage	Passed — 5,328 tests; coverage thresholds enforced
Dashboard Tests	Passed — 2,135 tests
Security Audit	Passed — no known high-severity vulnerabilities
Playwright E2E	Passed on Linux, macOS, and Windows
CodeQL Analysis	Passed
Package / Release Candidates	Passed on Linux, macOS, and Windows

Additional local validation:

pnpm run ci
pnpm run sync:docs-web
pnpm run check:docs-web
pnpm run build
CODE_UX_SKIP_RELEASE_INSTALL_BUILD=1 node scripts/verify-release-install.mjs
git diff --check

Known Follow-Up

• Refresh pinned GitHub Actions as upstream Node runtime deprecation warnings become actionable; these warnings did not affect the passing release matrix.

Included Change Set

• Persistent skills and optimized memory retrieval: #2856
• Weighted sprint progress: #2858
• Refreshed models.dev catalog: #2849
• Project Manager continuation and linked-skill clarity: #2859
• After-sprint scheduling semantics: #2870
• Resolved QA handoff recovery: #2876
• Projects redesign: #2882
• Playwright MCP package restoration: #2883
• Preview startup hardening: #2888
• Asynchronous MCP sprint planning: #2889
• Orphaned preview recovery: #2891
• Dark chat link contrast: #2873
• Orchestration retry guardrails: #2892
• Catalog-driven 3D Chat quick actions: #2886
• Compose for trusted preview Docker mode: #2896
• Bounded no-progress QA retries: #2897
• Cross-project intervention visibility: #2899
• Local speech and 3D Chat voice controls: #2900
• Runnable local speech defaults: #2901
• License-gated speech downloads and phonemization: #2914
• Open-source software and license catalog: #2920
• Safe base-agent instruction updates: #2923
• Richer 3D Chat runtime and interactions: #2927
• Worker clarification workflows: #2930
• Navigation and realtime recovery: #2931
• Speech input and playback stability: #2932
• Wav2Vec2 removal and migration: #2933
• Settings model catalog improvements: #2934
• Language-first German speech output: #2935
• Scoped asynchronous project and sprint selections: #2941
• Google Drive project mounts: #2947
• German 3D Chat speech restoration: #2948
• Settings navigation and personalization: #2949
• Contained 3D Chat quick actions: #2951
• Stats composition workspace redesign: #2954