diff --git a/docs/ACCEPTANCE_DOSSIER.md b/docs/ACCEPTANCE_DOSSIER.md index dd0f285..9e7dd34 100644 --- a/docs/ACCEPTANCE_DOSSIER.md +++ b/docs/ACCEPTANCE_DOSSIER.md @@ -8,14 +8,15 @@ ## 1. Release Package Artifact & Exact Commit -- **Exact Git Review Commit (`dev`)**: [`47150c2688820f4c39f0464f16524317187e172e`](https://github.com/BerryUIKI/AI-Studio/commit/47150c2688820f4c39f0464f16524317187e172e) -- **Preceding Integration Commit (`dev`)**: [`fc83abfcfb83abfb79bb074dc9ef182a0b1cb3b3`](https://github.com/BerryUIKI/AI-Studio/commit/fc83abfcfb83abfb79bb074dc9ef182a0b1cb3b3) +- **Exact Git Review Commit (`dev`)**: [`135126e97ad0aa5c548b6c730dd6d97de87c7088`](https://github.com/BerryUIKI/AI-Studio/commit/135126e97ad0aa5c548b6c730dd6d97de87c7088) +- **Preceding Integration Commit (`dev`)**: [`17fb69d15f621c49bc58e6016cdd62399de58bf4`](https://github.com/BerryUIKI/AI-Studio/commit/17fb69d15f621c49bc58e6016cdd62399de58bf4) - **Primary Package Artifact**: - **Archive**: `dist/Berry-AI-Studio-v0.1.0-windows-x64.zip` (18.9 MB) - **Unpacked Distribution Directory**: `dist/Berry-AI-Studio-v0.1.0-windows-x64/` - **Contents**: - `berry.exe` (Native Rust launcher & environment manager) - - `Berry.bat` (Double-click launcher wrapper) + - `Berry AI Studio.exe` (Native Tauri desktop window application shell) + - `Berry.bat` (Double-click launcher wrapper prioritizing native desktop app) - `README.txt` (User onboarding & quickstart instructions) - `frontend/dist/` (Compiled React/Vite single-page production web application) - `backend/app/` (FastAPI core, DAG cache, persistent storage, runners, supervisors) @@ -55,6 +56,11 @@ All changes have been developed on focused feature branches and integrated into | **[PR #22](https://github.com/BerryUIKI/AI-Studio/pull/22)** | `docs/reconcile-verification-matrix` | `docs: reconcile support matrix, roadmap, and acceptance dossier with 4-tier verification taxonomy` | 3/3 Passed | [`90f2845`](https://github.com/BerryUIKI/AI-Studio/commit/90f2845) | | **[PR #23](https://github.com/BerryUIKI/AI-Studio/pull/23)** | `feature/bounded-workflow-construction` | `feat(agent): implement bounded ComfyUI workflow construction, DAG review, and validation gating` | 3/3 Passed | [`fc83abf`](https://github.com/BerryUIKI/AI-Studio/commit/fc83abf) | | **[PR #24](https://github.com/BerryUIKI/AI-Studio/pull/24)** | `feature/harden-video-journey` | `fix(video): harden video container preservation, provider routing, and cancellation disclaimers` | 3/3 Passed | [`47150c2`](https://github.com/BerryUIKI/AI-Studio/commit/47150c2) | +| **[PR #25](https://github.com/BerryUIKI/AI-Studio/pull/25)** | `docs/sync-bounded-and-video-dossier` | `docs: synchronize roadmap and acceptance dossier with bounded workflow and video hardening PRs` | 3/3 Passed | [`036d476`](https://github.com/BerryUIKI/AI-Studio/commit/036d476) | +| **[PR #26](https://github.com/BerryUIKI/AI-Studio/pull/26)** | `fix/system-info-endpoint` | `fix(system): add /api/v1/system/info endpoint for CLI diagnostics (M8, M11)` | 3/3 Passed | [`b54c421`](https://github.com/BerryUIKI/AI-Studio/commit/b54c421) | +| **[PR #27](https://github.com/BerryUIKI/AI-Studio/pull/27)** | `feature/tauri-desktop-app` | `feat(desktop): add native Tauri desktop app and root Berry.bat launcher` | 3/3 Passed | [`27a1c03`](https://github.com/BerryUIKI/AI-Studio/commit/27a1c03) | +| **[PR #28](https://github.com/BerryUIKI/AI-Studio/pull/28)** | `fix/tauri-root-detection-and-readiness` | `fix(desktop): resolve root dir traversal and backend readiness in Tauri desktop app` | 3/3 Passed | [`17fb69d`](https://github.com/BerryUIKI/AI-Studio/commit/17fb69d) | +| **[PR #29](https://github.com/BerryUIKI/AI-Studio/pull/29)** | `feat/canvas-quick-add-and-context-menu` | `feat(canvas): add double-click and right-click quick node creation context menu` | 3/3 Passed | [`135126e`](https://github.com/BerryUIKI/AI-Studio/commit/135126e) | --- @@ -168,6 +174,15 @@ cargo run --manifest-path launcher/Cargo.toml 6. **Workflow Repair Ambiguity & Compatibility Guards**: - The ComfyUI repair engine automatically reconnects slots only when an unambiguous single source exists in the DAG. If multiple sources exist, automatic connection is blocked (`substitution_blocked`) to avoid graph corruption. - Checkpoint substitution is strictly constrained to matching architecture families (`sd15`, `sdxl`, `flux`, `svd`). Unknown or cross-family substitutions are blocked. +7. **Native Tauri Desktop Application (PR #27, PR #28)**: + - Berry AI Studio includes a native Tauri 2.0 desktop window application shell (`frontend/src-tauri`) in addition to the standalone Rust CLI launcher (`launcher/`). + - The Tauri app provides native desktop window controls, bidirectional backend readiness polling, and robust root directory resolution across both development and packaged portable layouts. + - The root `Berry.bat` launcher detects compiled `Berry AI Studio.exe` to prioritize native desktop execution, falling back to `pnpm --prefix frontend tauri dev` or web browser mode. +8. **Canvas Context Menu & Quick Node Creation (PR #29)**: + - Users can right-click or double-click anywhere on the blank infinite canvas to open `QuickAddMenu.tsx`. + - The menu provides rapid keyboard-searchable node placement (Image Card, Video Card, Text Prompt, ComfyUI Workflow templates, and Image Editing tools) without navigating through sidebars. +9. **Unified System Diagnostics Endpoint (PR #26)**: + - Added `/api/v1/system/info` providing aggregated system metrics, detected GPU hardware, OS platform, memory, and engine statuses for consumption by the CLI (`berry system info`) and GUI diagnostics. --- @@ -177,8 +192,8 @@ The following test scenarios should be executed during the unified product accep 1. **Clean-Machine Windows Package Verification**: - Extract `dist/Berry-AI-Studio-v0.1.0-windows-x64.zip` on a clean Windows 10/11 machine without host Python, Node.js, or Git installed. - - Run `berry.exe` or double-click `Berry.bat`. Confirm readiness probe passes and opens `http://127.0.0.1:8000`. - - Run `berry.exe` a second time; confirm it detects the running instance and focuses the browser without spawning a second process. + - Run `Berry.bat`, `Berry AI Studio.exe`, or `berry.exe`. Confirm readiness probe passes and opens the creative workspace (native desktop window or browser `http://127.0.0.1:8000`). + - Run `berry.exe` a second time; confirm it detects the running instance and focuses the active workspace without spawning a second process. 2. **Cloud-Only BYOK End-to-End Workflow**: - On a machine without local engines, open **Cloud BYOK** and enter a valid API key (Fal.ai, OpenAI, or SiliconFlow). - Generate an image via the Bottom Creation Dock (`txt2img`). diff --git a/docs/ROADMAP_POST_V0_1.md b/docs/ROADMAP_POST_V0_1.md index bdcd7bf..cd80e0e 100644 --- a/docs/ROADMAP_POST_V0_1.md +++ b/docs/ROADMAP_POST_V0_1.md @@ -29,7 +29,7 @@ This roadmap operationalizes the long-term approved technical directions for Ber | Milestone | Title & Focus Area | Implementation PRs | Status on `dev` | Verification Evidence & Tier | | :--- | :--- | :--- | :--- | :--- | | **M7** | Video Generation & Usable Video Creation Journey | [PR #11](https://github.com/BerryUIKI/AI-Studio/pull/11), [PR #20](https://github.com/BerryUIKI/AI-Studio/pull/20), [PR #24](https://github.com/BerryUIKI/AI-Studio/pull/24) | **Merged** (`64cd55c`, `befb14d`, `47150c2`) | **Mocked Verification**: `test_m7_video.py` (10/10 passed), SVD XT / AnimateDiff macro compiler, container magic-byte detection (.webm/.mp4/.webp), inline disposition export, SiliconFlow CogVideoX dispatch & cancellation. (Live cloud video generation requires funded BYOK keys). | -| **M8** | Documented Unified Berry CLI for Creation & Management | [PR #12](https://github.com/BerryUIKI/AI-Studio/pull/12) | **Merged** (`8e394dd`) | **Physical Hardware Verified**: Rust CLI binary execution on Windows 11 host (`test_m8_cli.py`, `cargo test`, `berry.exe run/tasks/system`). | +| **M8** | Documented Unified Berry CLI for Creation & Management | [PR #12](https://github.com/BerryUIKI/AI-Studio/pull/12), [PR #26](https://github.com/BerryUIKI/AI-Studio/pull/26) | **Merged** (`8e394dd`, `b54c421`) | **Physical Hardware Verified**: Rust CLI binary execution on Windows 11 host (`test_m8_cli.py`, `cargo test`, `berry.exe run/tasks/system`, `/api/v1/system/info`). | | **M9** | Conversational Agent Control of Existing Workflows & Engines | [PR #13](https://github.com/BerryUIKI/AI-Studio/pull/13), [PR #18](https://github.com/BerryUIKI/AI-Studio/pull/18) | **Merged** (`1260722`, `3cf860a`) | **Mocked Verification**: `test_m9_agent.py` (6/6 passed), `AgentService`, deterministic keyword/regex intent parsing, transparent `AgentProposal`, human-in-the-loop gate. | | **M10** | Agent-Assisted Construction, Validation, Repair of Workflows | [PR #14](https://github.com/BerryUIKI/AI-Studio/pull/14), [PR #18](https://github.com/BerryUIKI/AI-Studio/pull/18), [PR #23](https://github.com/BerryUIKI/AI-Studio/pull/23) | **Merged** (`60c3620`, `3cf860a`, `fc83abf`) | **Mocked Verification**: `test_m10_workflow_repair.py` (9/9 passed) + `test_workflow_construction.py` (10/10 passed), 6 bounded workflows in `WorkflowCatalog`, reviewable proposed DAG stages, canvas isolation, approval gate, missing model detection with recovery guidance. | | **M11** | Local Inference on Selected Non-NVIDIA Discrete GPUs | [PR #15](https://github.com/BerryUIKI/AI-Studio/pull/15), [PR #19](https://github.com/BerryUIKI/AI-Studio/pull/19) | **Merged** (`7f700b2`, `c35f3b1`) | **Mocked Verification**: `test_m11_hardware.py` (5/5 passed), AMD/Intel GPU detection via WMI/ROCm, DirectML launch flags. (Physical AMD/Intel hardware runs unverified in this session). |