# UnifiedFiler Product Documentation

UnifiedFiler Product v1.0.0 is the first public product release of the Host-embedded File Operation Control Framework.

```text
Product Version:        1.0.0
Development Version:    dev-2.1.0
Development Milestone:  2.1.0
Public API Version:     1.0
Backend API Contract:   1.0
Build Version:          20260610.002
```

## Recommended reading order

1. `VERSIONING_POLICY.md` - product/development/API version policy.
2. `PRODUCT_RELEASE_1_0_0.md` - initial product release notes.
3. `PUBLIC_API_CONTRACT.md` - stable Host-facing API contract.
4. `API.md` - API usage guide.
5. `HOST_SIDE_INTEGRATION_SPEC.md` - Host-side implementation specification.
6. `HOST_INTEGRATION.md` / `HOST_APP_INTEGRATION_PRODUCT_1_0.md` - Host integration details.
7. `GOOGLE_DRIVE_BROWSER_CLIENT.md` - frontend-only Google Drive setup.
8. `BACKEND_API_CONTRACT.md` - Backend API Contract v1.0.
9. `SECURITY_POLICY.md` - safety rules.
10. `REGRESSION_TESTS.md` - manual and browser-safe regression checks.
11. `DEVELOPMENT_HISTORY.md` - internal development milestone history.

## Version terminology

Historical documents named `VERSION_1_9_*`, `VERSION_2_0_*`, and `VERSION_2_1_*` are retained as development milestone notes. They are not product release versions.

For product release compatibility, use:

```javascript
UnifiedFiler.productVersion       // '1.0.0'
UnifiedFiler.developmentVersion   // 'dev-2.1.0'
UnifiedFiler.apiVersion           // '1.0'
UnifiedFiler.contractVersion      // '1.0'
```

## Public release scope

Product v1.0.0 includes:

- FileExplorer / FilePicker / FileSaver
- Control architecture
- CommandRegistry / StateStore / EventBus
- CreateTypeRegistry
- PreviewProviderRegistry
- AppStorage / This Device / Backend API / Google Drive adapters
- Metadata editing UI
- Permission / Capability UI
- Backend API Contract v1.0
- SecurityPolicyService
- Host integration bridge
- RegressionTestService
- Node.js and PHP backend samples
