release: prepare v0.1.2 dark theme and python recovery for GitHub

ilya-bov · ilya-bov · commit 19b7dfeb92ce · 2026-03-06T11:00:33.000+03:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.2] - 2026-03-06
+
+### Added
+- Dark mode toggle in `Dashboard -> Settings -> Appearance`.
+- Saved theme is applied on app layout load (`<html class="dark">`) for consistent rendering.
+
+### Changed
+- Python code execution now prefers project-local virtualenv interpreters (`.venv`/`venv`) when present.
+- Python dependency recovery now includes project-local venv fallback for environments where system pip is blocked.
+- Prompt guidance updated to use `install_packages(kind=python)` and virtualenv fallback when needed.
+
+### Fixed
+- Project file tree now hides `.venv` and `venv` directories alongside `.meta`.
+
 ## [0.1.1] - 2026-03-03
 
 ### Added
diff --git a/README.md b/README.md
@@ -22,8 +22,8 @@ The app runs as a Next.js service and stores runtime state on disk (`./data`).
 
 ## Releases
 
-- Latest release snapshot: [0.1.1 - Unified Context](./docs/releases/0.1.1-unified-context.md)
-- GitHub release body (ready to paste): [v0.1.1](./docs/releases/github-v0.1.1.md)
+- Latest release snapshot: [0.1.2 - Dark Theme and Python Recovery](./docs/releases/0.1.2-dark-theme-python-recovery.md)
+- GitHub release body (ready to paste): [v0.1.2](./docs/releases/github-v0.1.2.md)
 - Release archive: [docs/releases/README.md](./docs/releases/README.md)
 
 ## Contributing and Support
diff --git a/docs/releases/0.1.2-dark-theme-python-recovery.md b/docs/releases/0.1.2-dark-theme-python-recovery.md
@@ -0,0 +1,39 @@
+# Eggent 0.1.2 - Dark Theme and Python Recovery
+
+Date: 2026-03-06  
+Type: Patch release snapshot
+
+## Release Name
+`Dark Theme and Python Recovery`
+
+This release packages three focused improvements: user-selectable dark mode, stronger Python package recovery through virtualenv fallback, and cleaner project file trees by hiding virtualenv folders.
+
+## What Is Included
+
+### 1) Settings and UI Theme
+- Added `Appearance -> Dark mode` toggle in `Dashboard -> Settings`.
+- Theme preference now applies to the root layout (`<html class="dark">`) based on saved settings.
+
+### 2) Python Runtime and Dependency Recovery
+- Python execution now prefers project-local interpreters from `.venv` or `venv` when available.
+- Python execution environment now injects virtualenv context (`VIRTUAL_ENV`, `PATH`) when using a local venv.
+- `install_packages` Python flow now includes fallback plan:
+  - create local virtualenv (`python3 -m venv .venv` or `python -m venv .venv`)
+  - install requested dependencies with `.venv/bin/python -m pip install ...`
+- Prompt guidance updated to route Python missing-dependency recovery through `install_packages(kind=python)` with virtualenv fallback when system pip is blocked.
+
+### 3) Project Files Visibility
+- Hidden project entries now include `.venv` and `venv` in addition to `.meta`.
+
+## New in 0.1.2
+
+- Added dark mode toggle and persisted theme application in layout.
+- Improved Python dependency recovery with project-local virtualenv fallback.
+- Hid Python virtualenv directories from project file listings.
+- Bumped package and health version to `0.1.2`.
+
+## Upgrade Notes
+
+- No data migration required.
+- Existing projects continue to run as-is.
+- If a project has `.venv`/`venv`, Python tool execution will now prefer that interpreter.
diff --git a/docs/releases/README.md b/docs/releases/README.md
@@ -4,4 +4,5 @@ This directory contains release summaries and publish-ready notes.
 
 | Version | Name | Date | Notes |
 | --- | --- | --- | --- |
+| `0.1.2` | Dark Theme and Python Recovery | 2026-03-06 | [Full snapshot](./0.1.2-dark-theme-python-recovery.md), [GitHub body](./github-v0.1.2.md) |
 | `0.1.1` | Unified Context | 2026-03-03 | [Full snapshot](./0.1.1-unified-context.md), [GitHub body](./github-v0.1.1.md) |
diff --git a/docs/releases/github-v0.1.2.md b/docs/releases/github-v0.1.2.md
@@ -0,0 +1,23 @@
+## Eggent v0.1.2 - Dark Theme and Python Recovery
+
+Patch release focused on UX polish and Python runtime resilience: dark mode controls, safer dependency recovery, and cleaner project file tree output.
+
+### Highlights
+
+- Added `Dashboard -> Settings -> Appearance -> Dark mode` toggle.
+- Applied saved dark mode directly in root layout for consistent initial render.
+- Improved Python package recovery with project-local virtualenv fallback when system pip is blocked.
+- Python execution now prefers `.venv`/`venv` interpreter and environment when present.
+- Hidden `.venv` and `venv` from project file tree output.
+- Version bump to `0.1.2` across package metadata and `GET /api/health`.
+
+### Upgrade Notes
+
+- No migration step required.
+- Existing projects keep working without changes.
+- Projects with local virtualenvs now get automatic interpreter preference for Python execution.
+
+### Links
+
+- Full release snapshot: `docs/releases/0.1.2-dark-theme-python-recovery.md`
+- Installation and update guide: `README.md`
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "design-vibe",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "private": true,
   "scripts": {
     "dev": "next dev",
diff --git a/src/app/api/health/route.ts b/src/app/api/health/route.ts
@@ -2,6 +2,6 @@ export async function GET() {
   return Response.json({
     status: "ok",
     timestamp: new Date().toISOString(),
-    version: "0.1.1",
+    version: "0.1.2",
   });
 }

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "design-vibe",`
`3`		`- "version": "0.1.1",`
	`3`	`+ "version": "0.1.2",`
`4`	`4`	`"private": true,`
`5`	`5`	`"scripts": {`
`6`	`6`	`"dev": "next dev",`
Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,6 @@ export async function GET() {`
`2`	`2`	`return Response.json({`
`3`	`3`	`status: "ok",`
`4`	`4`	`timestamp: new Date().toISOString(),`
`5`		`- version: "0.1.1",`
	`5`	`+ version: "0.1.2",`
`6`	`6`	`});`
`7`	`7`	`}`