# ZoneGaze Social Studio Plugin

## Role

First-party Matrix plugin for local-first social-media workflow orchestration.

## Source Boundaries

- Plugin package: `plugins/social-studio/`
- Matrix web surface: `plugins/social-studio/apps/web/src/`
- Runtime services: `flow/runtime/src/social-studio/`
- Shared contracts: `flow/contracts/src/social-studio-contracts.ts`

## Current Capability Signals

- Capability registry: `social-studio`
- Runtime/package status: `ready`
- Catalog/runtime evidence: `flow/contracts/src/zonegaze-products.ts`, `flow/common/src/plugin-services.ts`

## Major Features

- Modular workspace shell with Dashboard, Ingest, Research, Media, Planner, Publishing,
  Analytics, and Automation modules
- Local workspace persistence through `social-studio.json` plus revision sidecar
  `social-studio.meta.json`
- Folder, project-context, and Whispr-transcript ingest into reusable asset collections
- Media analysis for transcription, OCR, scene boundaries, clip suggestions, and brand-safety flags
- Research-backed market, audience, and competitor sessions
- Planning for campaign briefs, post variants, and draft calendars
- Publishing export-pack generation and normalized manual-upload jobs
- Analytics imports and performance summaries
- Approval-gated automation rules and audit logs
- BYO connector model with `cline-sdk`, `ollama`, `exo`, and `custom-api`

## Current Matrix Coordination

- `Flow`: Social Studio is workspace-scoped and already receives active Matrix project/workspace
  context from the host shell.
- `Whispr`: Social Studio can import Whispr transcripts as ingest inputs.
- `Research`: Social Studio has its own current research workflow and is a strong future consumer of
  broader Matrix evidence reuse.
- `Open Design`: design artifacts and visual assets are natural supporting inputs even where the
  current handoff is still deliberate.
- `Models - Cline`, `Ollama`, `Exo`, and `custom-api`: Social Studio already exposes a BYO connector
  model rather than hard-coding one provider path.

## Future Signals Already In Source

- Direct publish connectors for official platform APIs
- Direct analytics connectors for platform-native exports
- Heavier speech, OCR, and vision engines behind user-supplied providers
- Deeper research adapters layered on top of existing Matrix/Cline model sources

## Related Docs

- [Plugin README](../../plugins/social-studio/README.md)
- [Matrix feature catalog](../features/matrix-feature-catalog.md)
- [Matrix plugin coordination](plugin-coordination.md)
- [Commercial posture](../business/commercial-posture.md)

