# Release Notes — YuMatrix Studio 0.1.0-beta.1

**Release Date:** 2026-08-25
**Channel:** beta
**Version:** 0.1.0
**Tag:** `v0.1.0-beta.1`

---

## What is YuMatrix Studio

YuMatrix Studio is a desktop application for AI-assisted content operations, multi-account management, and publishing orchestration. This is a **controlled Private Beta** release for early testers.

---

## Major Capabilities

### AI Studio
- Generate content ideas and topics using AI providers
- Create content from AI-generated topics
- Provider-agnostic AI gateway (Anthropic, OpenAI interfaces)
- Honest "not configured" state when no API key is set — no fake success

### Content Workflow
- Create, edit, and organize content
- Content lifecycle management (draft → review → approved → scheduled → published)
- Content versioning

### Media Management
- Upload and attach media assets
- Workspace-scoped media storage
- SHA-256 integrity verification for stored files
- Path-traversal-protected file operations

### Account Center
- Multi-account management per platform
- OAuth-based platform connection (PKCE + state validation)
- External system browser for OAuth (never in-app credential entry)
- Sanitized account status — secrets never leave the main process

### Publishing Center
- Publishing workflow orchestration
- Publication state machine (QUEUED → RUNNING → RETRYING → COMPLETED/FAILED)
- Publication recovery after restart
- Idempotency enforcement

### Network Architecture
- Per-account network profile configuration
- Proxy support with credential protection
- Loopback callback server bound to 127.0.0.1 with ephemeral ports

### Diagnostics
- Built-in diagnostics surface (health, version, config, database)
- Logging infrastructure for support
- Settings validation

---

## Security

- **contextIsolation:** enabled
- **nodeIntegration:** disabled
- **sandbox:** enabled
- **CSP:** strict production policy (`script-src 'self'`, `frame-src 'none'`)
- **IPC validation:** sender identity verified
- **SecretStore:** Electron safeStorage (OS keychain/DPAPI) in production — encrypted at rest, persisted across restarts
- **OAuth:** PKCE + state validation + 127.0.0.1 ephemeral loopback + external browser
- **Secrets:** never in database, never in renderer, never in logs

---

## Supported Platforms (Workflow)

| Platform | Status | Notes |
|----------|--------|-------|
| YouTube | Adapter implemented | OAuth + resumable upload. Real credential/publication = OWNER_ACTION_REQUIRED |
| TikTok | Catalog entry | Approval pending — not implemented |
| China platforms | Human handoff only | `HumanHandoffAdapter` — assisted execution |

---

## System Requirements

| Requirement | Minimum |
|-------------|---------|
| OS | Windows 10 (x64) |
| RAM | 4 GB recommended |
| Disk | 500 MB free |
| Network | Required for OAuth and AI features |

---

## Installation

### Windows

1. Download `YuMatrix Studio-Setup-0.1.0-x64.exe`
2. Verify SHA-256: `AD0D5F11B7B7D7A3E28445F755DA3E3861F829AB1373F14BC16DAA6ECF0507DD`
3. Run installer (no Administrator required for per-user install)
4. Launch YuMatrix Studio

---

## Known Limitations

This is a **Private Beta**. Honest limitations:

- **Real YouTube production verification pending** — adapter implemented, needs real OAuth credentials
- **TikTok production adapter pending** — not implemented
- **China platforms use Human Handoff** — assisted, not automatic
- **macOS signing pending** — OWNER_ACTION_REQUIRED (Developer ID)
- **macOS notarization pending** — OWNER_ACTION_REQUIRED
- **Automatic updates may be unavailable** — manual update for Beta
- **Some AI providers require user configuration** — set API key in Settings
- **Network connectivity depends on user's environment** — proxy support available
- **Windows code signing pending** — unsigned local build (SmartScreen warning expected)

See `PRIVATE_BETA_KNOWN_LIMITATIONS.md` for full details.

---

## Test Baseline

| Check | Result |
|-------|--------|
| typecheck | 0 errors |
| tests | 524 passed, 5 skipped (32 files) |
| lint | 0 errors (64 pre-existing warnings) |
| build | pass |
| Windows artifact | verified (SHA-256 above) |

---

## Artifact Integrity

| Field | Value |
|-------|-------|
| Filename | `YuMatrix Studio-Setup-0.1.0-x64.exe` |
| Size | 106,270,732 bytes |
| SHA-256 | `AD0D5F11B7B7D7A3E28445F755DA3E3861F829AB1373F14BC16DAA6ECF0507DD` |
| Version | 0.1.0 (consistent across package.json / Electron / artifact / manifest / diagnostics) |
| Signed | No (unsigned local build — OWNER_ACTION_REQUIRED for signing) |

---

## Support

- See `PRIVATE_BETA_ONBOARDING.md` for first-run guidance
- Report issues via the official support channel (see `docs/PRIVATE_BETA_OWNER_ACTIONS.md`)
- Include version, OS, workflow, expected/actual behavior, reproduction steps, severity (P0-P3)

---

**This is a controlled Private Beta. Do not redistribute publicly.**