v0.1.0 — Public Preview

Draft. Status: pre-release. The exact tag and date will be finalized when CE / Agent SDK / Contracts packages reach the cut.

The first publicly usable release of Xtrape Capsule.

Highlights

• Opstage CE — single-container control plane (Fastify + SQLite + React 18 + Ant Design).
• Capsule Management Contract v0.1 — shared Zod schemas and TypeScript types in @xtrape/capsule-contracts-node.
• Node Embedded Agent SDK — @xtrape/capsule-agent-node, with registration, heartbeats, service reports, health/config providers, action prepare/execute, and command polling.
• RBAC — owner / operator / viewer.
• Audit — every meaningful operator and system action; CSV / JSON export.
• Maintenance scheduler — offline detection, expiry, audit pruning.
• Backup — owner-only SQLite snapshot download from the console.

What is included

Component	Repo	Status
Opstage CE backend + UI	xtrape-capsule-ce	Source build during Public Review; pinned GHCR image after v0.1.0 cut
Node Embedded Agent SDK	xtrape-capsule-agent-node	npm public-review dist-tag
Contracts (Zod + TS)	xtrape-capsule-contracts-node	npm public-review dist-tag
Public site + docs	xtrape-capsule-site	Live

Quick Start

git clone https://github.com/xtrape-com/xtrape-capsule-ce.git
cd xtrape-capsule-ce
cp .env.example .env
docker compose -f deploy/compose/docker-compose.yml up --build -d

Open http://localhost:8080. Default bootstrap credentials are in .env.example. Change the password and OPSTAGE_SESSION_SECRET before exposing Opstage beyond localhost.

Docker image

During Public Review, the source-build Docker Compose path remains the canonical quick-start path. GHCR images may be produced from main for validation, but the stable ghcr.io/xtrape-com/xtrape-capsule-ce:0.1.0 image becomes the primary documented path only after the v0.1.0 Public Preview cut.

NPM packages

@xtrape/capsule-agent-node and @xtrape/capsule-contracts-node are published to npm under the public-review dist-tag. Install them with:

pnpm add @xtrape/capsule-agent-node@public-review
pnpm add @xtrape/capsule-contracts-node@public-review

Until the v0.1.0 stable release, use the public-review dist-tag to get the latest Public Review versions.

Documentation

• Full docs: https://xtrape-com.github.io/xtrape-capsule-site/
• Quick Start
• First Capsule Service
• Security Overview
• Roadmap

Known limitations

• Single-node only. Running multiple backend containers against the same SQLite file is unsupported.
• No HA / SSO / SCIM. Those are EE-edition concerns.
• No stable v0.1.0 Docker image as the primary path yet. During Public Review, use the source-build Docker Compose path; GHCR pre-release/main images may exist for validation.
• No stable v0.1.0 npm latest release yet. During Public Review, use the public-review dist-tag for @xtrape/capsule-agent-node and @xtrape/capsule-contracts-node.
• Public-internet exposure is not recommended without an additional layer (VPN / reverse proxy with SSO / IP allow-list). CE has no built-in IP allow-list, no rate-limit on admin login, no SSO.
• No real screenshots in docs yet — placeholders only.
• Agent SDK API may shift before v1.0 — minor versions in the 0.x line may include breaking changes; pin matching minors of CE / Agent SDK / Contracts.

Roadmap Snapshot

• v0.1 Public Review Foundation — CE, Agent SDK, Contracts, Demo, and public docs are validated end-to-end.
• v0.2 Developer Experience & Runtime Maturity — Docker/release maturity, SDK reliability, demo polish, command/action/audit improvements.
• v0.3 Capsule Events and Capability Metadata — capability, event, and permission metadata foundations.
• v0.4 Capsule Bus Experimental — governed event-to-command routing for controlled service coordination.
• v0.5 Capsule Catalog — read-first catalog for discoverable Capsule Packages.
• v0.6 Capsule Registry — machine-readable package index, versions, compatibility, and trust metadata.
• v0.7 Private Capsule Marketplace — internal/private marketplace workflows for package approval, install requests, and governance.
• v1.0 CE Stable and Ecosystem Foundation — stable CE deployment, stable contracts/SDK, upgrade path, and ecosystem baseline.

Catalog, Registry, Marketplace, Capsule Bus, and AI-assisted governance are future roadmap items. They are not implemented in the current Public Review build.

→ See the full roadmap.

Feedback

• Bug reports / feature requests: open an issue on the relevant repo.
• General discussion: xtrape-capsule-ce discussions (when enabled).
• Security issues: see each repo's SECURITY.md.

Cross-package compatibility

Package	This release	npm dist-tag
xtrape-capsule-ce	0.1.0	n/a (source build during Public Review; pinned Docker image after v0.1.0)
@xtrape/capsule-agent-node	0.1.0-public-review.0	public-review
@xtrape/capsule-contracts-node	0.1.0-public-review.0	public-review
xtrape-capsule-demo	matches	n/a
xtrape-capsule-site	matches	n/a

Match CE, SDK, Contracts, and Demo versions

During Public Review and Public Preview, always pin matching 0.1.x minors across CE, Agent SDK, Contracts, and the Demo repo. The wire protocol may still change before v1.0. The npm public-review dist-tag on @xtrape/capsule-agent-node and @xtrape/capsule-contracts-node always points at the version that pairs with the current Public Review CE build; pin explicit versions if you need reproducibility.