# Private Beta Known Limitations

**Version:** 0.1.0-beta.1
**Date:** 2026-08-25

This document honestly states the current limitations of YuMatrix Studio Private Beta. Beta users must read this before participating.

---

## Platform Limitations

### YouTube
- **Adapter implemented:** OAuth connection + resumable upload code paths exist
- **Real production verification pending:** No verified real-world publication with production credentials
- **Credential requirement:** Needs `OAUTH_YOUTUBE_CLIENT_SECRET` — OWNER_ACTION_REQUIRED
- **Honest status:** Do not claim automated YouTube publishing is verified

### TikTok
- **Not implemented:** Catalog entry only
- **Approval pending:** TikTok developer approval required
- **Honest status:** TikTok is not available in this release

### China Platforms (WeChat, Weibo, Douyin, Xiaohongshu, etc.)
- **Human Handoff only:** `HumanHandoffAdapter` provides assisted execution
- **No automatic publishing:** Manual steps required
- **Honest status:** China platforms are not automatically integrated

---

## Signing & Notarization

### Windows
- **Unsigned local build:** No code signing certificate applied
- **SmartScreen warning expected:** Windows may show "Unknown publisher" warning
- ** OWNER_ACTION_REQUIRED:** Certificate needed for production signing
- **Not a Beta blocker:** Users can proceed past the warning for Beta testing

### macOS
- **Not built on Windows host:** macOS artifacts require macOS build environment
- **Signing pending:** Developer ID Application certificate required
- **Notarization pending:** Apple ID + app-specific password + team ID required
- **Stapling pending:** After notarization
- **Status:** CONFIGURED but not verified — OWNER_ACTION_REQUIRED

### Linux
- **AppImage configured:** Build command documented
- **Not verified on Windows host:** Requires Linux build environment
- **Status:** CONFIGURED but not verified

---

## Update Limitations

- **Manual update recommended for Beta:** Automatic updates require production update hosting
- **Update endpoint:** `https://REPLACE_WITH_OFFICIAL_DOMAIN/updates` — placeholder, OWNER_ACTION_REQUIRED
- **Architecture in place:** Update service implemented but production endpoint not configured
- **Honest status:** Auto-update may be unavailable during Private Beta

---

## AI Provider Limitations

- **Provider configuration required:** Users must set API keys in Settings
- **Honest "not configured" state:** AI Studio reports unavailable when no provider is configured — no fake success
- **No hidden mock responses:** When unconfigured, the UI clearly indicates the provider is not available

---

## Network Limitations

- **Depends on user environment:** Network connectivity, firewall, and proxy settings affect functionality
- **Proxy support available:** Per-account network profiles with proxy configuration
- **127.0.0.1 loopback:** OAuth callback uses localhost — may conflict with other services binding the same port (ephemeral port used to minimize conflict)

---

## Feature Limitations (Not Implemented)

The following are **NOT** available in this Beta. Do not claim otherwise:

- Analytics / billing
- Team collaboration
- Cloud sync
- CRDT / real-time collaboration
- Automatic public registration
- Microsoft Store / Mac App Store / Snap Store distribution
- Third-party marketplace presence

---

## Data & Privacy

- **Local-first:** Data stored locally on user's machine
- **Secrets encrypted at rest:** OS keychain (macOS) / DPAPI (Windows) via Electron safeStorage
- **No telemetry by default:** No hidden analytics collection
- **AI provider interaction:** Content sent to configured AI providers (Anthropic/OpenAI) per user action

---

## Reliability Expectations

- **Beta quality:** May contain bugs and unexpected behavior
- **Not production-grade:** Do not use for mission-critical operations without backups
- **Feedback welcome:** Report issues via the official support channel

---

## Summary Table

| Area | Status | Notes |
|------|--------|-------|
| YouTube workflow | Adapter implemented | Real credentials pending |
| TikTok | Not implemented | Approval pending |
| China platforms | Human handoff only | Assisted execution |
| Windows artifact | Verified | Unsigned (SmartScreen warning) |
| macOS artifact | CONFIGURED | Not built/verified on Windows host |
| Linux artifact | CONFIGURED | Not built/verified on Windows host |
| Windows signing | OWNER_ACTION_REQUIRED | Certificate needed |
| macOS signing | OWNER_ACTION_REQUIRED | Developer ID needed |
| macOS notarization | OWNER_ACTION_REQUIRED | Apple credentials needed |
| Auto-update | DEFERRED / OWNER_ACTION_REQUIRED | Manual update for Beta |
| AI providers | Requires user config | Honest not-configured state |
| Privacy Policy | OWNER_ACTION_REQUIRED | Legal review pending |
| Terms of Service | OWNER_ACTION_REQUIRED | Legal review pending |

---

**Honesty is mandatory. Do not hide these limitations from Beta users.**