Skip to content

HOSTED.md

Latest commit

 

History

History
93 lines (64 loc) · 3.65 KB

HOSTED.md

File metadata and controls

93 lines (64 loc) · 3.65 KB

Hosted OpenCoven for GitHub

Hosted OpenCoven is the managed version of coven-github: install the GitHub App, configure a familiar, assign an issue or label, and get a draft PR back with Cave oversight.

The hosted tier should monetize managed reliability and familiar continuity, while the open-source adapter remains self-hostable for trust and inspection.

See Architecture Diagrams for the hosted vs self-hosted deployment diagram and trust-boundary map.

Hosted Flow

flowchart LR
    install[Install hosted GitHub App]
    route[Configure familiar routing]
    trigger[Assign issue or add trigger label]
    queue[Managed queue and task history]
    worker[Managed isolated worker]
    pr[Draft PR with Check Run evidence]
    cave[Cave oversight link]

    install --> route --> trigger --> queue --> worker --> pr --> cave
Loading

What Hosted Adds

Capability Self-hosted adapter Hosted OpenCoven
GitHub App ingress You run it Managed
Queue In-process/dev path until configured Durable queue
Task state Local/in-memory unless extended Persistent history
Worker isolation Operator-managed Managed worker pool
Familiar routing Static config Installation/repo scoped
Familiar memory Local/operator-managed Optional cloud memory
Cave oversight Local Cave Hosted-ready oversight links and dashboard
Usage limits Operator-managed Tiered limits and audit logs
Support Community Priority by tier

Packaging

Tier Buyer Initial shape
Open / Self-host OSS maintainers, security reviewers, local-first users Free adapter, BYOM, one familiar, community support.
Hosted Starter Small teams with backlog Managed queue, one familiar, task caps, Cave oversight links.
Hosted Team Product/platform teams Multi-familiar routing, audit log, usage controls, priority queue, team memory.
Hosted Dedicated Security-sensitive orgs Dedicated workers, stronger retention controls, custom limits, SLA, onboarding support.

Launch with flat monthly tiers and task caps. Avoid pure usage billing until task duration and model-cost distribution are known.

Buyer Promise

Your familiar on your GitHub: the one that already knows your code, your team, and how you ship.

The strongest buyer promise is trust continuity. A familiar should know the diff between "works" and "good enough for this repo." Hosted makes that reliable without making the customer operate workers, queues, or task history.

Data Boundaries

Hosted should make these boundaries explicit before beta:

  • GitHub installation tokens are scoped to the installed repositories.
  • User GitHub credentials are not used for worker pushes.
  • Familiar memory is opt-in and scoped by installation/repository policy.
  • Task history records metadata, status, evidence, links, and summaries.
  • Raw repository workspaces are temporary and destroyed after the task.
  • Secrets are redacted from logs and task output.

Beta Gate

Hosted beta should wait for:

  1. Persistent task store.
  2. Durable queue.
  3. Tenant-scoped task API authentication.
  4. Worker isolation with cleanup and timeouts.
  5. Usage metering by installation, repo, familiar, and task.
  6. Cave oversight dashboard for task history and human intervention.

Landing Page Copy

Headline:

Assign it like a teammate. Get a PR back.

Support copy:

OpenCoven lets your team deploy a trusted familiar to GitHub. It knows your repo context, follows your skills and review norms, drafts PRs under Cave oversight, and gets better as it works with your team.

Primary CTA:

  • Join hosted beta

Secondary CTA:

  • Self-host the adapter