# Beta roadmap to v0.1.0

What is supported today, and the milestones between the current beta and the **v0.1.0** release.

[← Back to README](https://kinhin.dev/v0.0.1-beta-7/index.md) · [Forge support](https://kinhin.dev/v0.0.1-beta-7/guide/forges.md#what-has-been-tested)

kinhin is in beta (`v0.0.1-beta-7`).

The beta supports **GitHub, Gitea, Forgejo and GitLab CE**; Buildkite, Azure Pipelines and Bitbucket Pipelines follow in
later betas (planned for beta 8). Milestones are ordered by what has to be true, not by date.

## Where we are

| Area | State |
| ---- | ----- |
| GitHub Actions | Supported; live-tested on Tart macOS VMs and apple/container |
| Gitea, Forgejo, GitLab CE | Supported; live-tested on every runtime by the [end-to-end suite](https://kinhin.dev/v0.0.1-beta-7/guide/e2e-testing.md) |
| Runtimes: Tart macOS and Linux VMs, apple/container, Docker, host mode | Live-tested |
| Buildkite, Azure Pipelines, Bitbucket Pipelines | Planned (implemented and unit-tested, not supported yet) |
| ThreadSanitizer | Clean on the beta 4 release; not yet re-run on beta 5 or 6 (`scripts/tsan.sh`) |
| Long-running soak test | Not done |
| In-app updater | Ships in beta-3; not yet exercised by a published release updating itself (needs the next release) |
| Outbound alerts | Opt-in webhook for fleet problems; unit-tested, not yet run against a real Slack, Discord or ntfy endpoint. See [Alerts](https://kinhin.dev/v0.0.1-beta-7/guide/alerts.md) |
| Telemetry | Opt-in OpenTelemetry (off by default; exports only to a server you configure). See [Telemetry](https://kinhin.dev/v0.0.1-beta-7/guide/telemetry.md) |

## Milestones

### beta-1: first public beta

- GitHub, Gitea, Forgejo and GitLab CE supported. Gitea, Forgejo and GitLab CE live-tested on every runtime; GitHub on
  Tart macOS VMs and apple/container.
- Menu bar app, CLI and LaunchAgent daemon released, signed and notarized.
- Docs, forge reference and the forge-report issue template published.

### beta-2: hardening the supported forges

- Fixes from beta testers' real projects.
- The GitHub lane of the end-to-end suite running against a throwaway repository.
- The e2e suite running nightly on a dedicated Mac.
- Exercise the in-app updater against a published release.

**Exit:** no open bugs that lose a job or leak a runner on a supported forge.

### beta-3: updater, restart safety and localization

- The in-app updater installs updates itself (Sparkle, EdDSA-signed feed).
- A restart no longer registers a VM again while its runner is still on the forge.
- Ollama as a healing advisor, camera and karaoke captions for videos, and the app in seven more languages.
- Azure Pipelines labeled experimental.

### beta-4: telemetry, macOS 27 images and reliability

- Opt-in OpenTelemetry: metrics, traces and logs over OTLP, a Prometheus endpoint, `kinhin telemetry status` and a menu bar card.
- The macOS 27 Golden Gate base images and digest-pinned base images.
- Install and reliability fixes: the daemon's LaunchAgent path, `vm.cpu` and `vm.memory_gb` on Tart, warm-pool counting, and
  every running job shown on multi-runner VMs.
- Linux runners (Apple container and Docker) no longer carry the `macos` label.

The Buildkite, Azure Pipelines and Bitbucket Pipelines work promised for this beta did not make it, or beta 5, and is now planned for beta 8.

### beta-5: Apple container pools, Docker and amd64

- `container.pools:` splits Apple container into named pools with their own image, size, labels and idle floors, shown and edited in the app.
- `container.docker: true` runs Docker inside container runners, with a Docker Hub pull-through cache kinhin runs for them.
- `container.platform: linux/amd64` runs x86_64 Linux runners under Rosetta.
- `min_idle` keeps idle registered runners per pool and per Tart image.
- `kinhin image prepare --container` bakes as layers on the base image, so it needs far less disk.

The Buildkite, Azure Pipelines and Bitbucket Pipelines work did not make this beta either and moves to beta 8.

### beta-6: alerts and reliability

- Opt-in outbound alerts: a webhook (generic JSON, Slack, Discord or ntfy) when a fleet problem is raised or clears.
- Tart hosts share one `tart list` for 10 seconds, which fixes a kernel panic on a Mac with eight VMs on macOS 27.2.
- One fleet engine per host, and a replaced engine stops its old listeners.
- GitHub jobs queued inside an in-progress run count as demand.

The Buildkite, Azure Pipelines and Bitbucket Pipelines work did not make this beta either and moves to beta 8.

### beta-7: the redesigned app and storage control (current)

- The desktop app is one sidebar (Fleet, Runtimes, Accounts, Toolchains, Diagnostics, Settings), rebuilt from the design.
- Pools have an on/off switch, several alert webhooks with event types, and every `min_idle` floor applies on reload.
- `tart_home`, `container_app_root` and the cache paths move storage to another volume, with a mount and ownership check.
- Opt-in Docker build cache for container runners, a configurable Docker Hub cache TTL and repair of broken entries.

The Buildkite, Azure Pipelines and Bitbucket Pipelines work did not make this beta either and moves to beta 8.

### beta-8: more forges

- Buildkite, Azure Pipelines and Bitbucket Pipelines run against real accounts in the end-to-end suite, and become
  supported one by one as they pass.
- Multi-account and mixed-forge fleets on one shared pool.
- Register the dedicated `kinhin-e2e` Mac, run the GitHub lane, and turn on the nightly end-to-end run.

**Exit:** every forge the docs call supported is live-tested; the rest are clearly labeled planned.

### rc: hardening

- ThreadSanitizer still clean (`scripts/tsan.sh`).
- Long-running soak test: scaling up and down, crash and restart recovery, no leaked VMs, containers or registered runners.
- Troubleshooting and security [known limits](https://kinhin.dev/v0.0.1-beta-7/guide/security.md#known-limits) reviewed against what beta testers hit.
- Docs read-through against the shipped CLI and app.

**Exit:** no open data-loss, leaked-credential or leaked-runner bugs.

### v0.1.0: full release

- All the exit criteria above are met.
- Signed, notarized release with a working updater path from the last beta.
- Docs snapshot published under the version picker.

## How to help

Run kinhin on your own projects with a supported forge, then open a
[forge report](https://github.com/RabinApps/kinhin/issues/new/choose) saying whether it worked.
