Weft

A Bun-native durable execution engine with pluggable key-value storage.

This repository is a publication mirror of the private corvidae workspace, which is the source of truth for @lostgradient/weft. Lint, tests, coverage, documentation audits and benchmarks run there before a sync reaches this repository; here, the transform-emitted mirror-verify.yaml builds, typechecks, packs and lints the published package on every pull request, and release.yaml publishes it on a tag. Pull requests are welcome, but they cannot be merged as submitted: a change is ported into corvidae by hand and arrives back through a sync.

Packages

• packages/weft: the @lostgradient/weft durable execution engine, server, client, CLI, and storage adapters. Published to npm.

The operator console is now developed and built as @lostgradient/weft-ui from its own repository, not from this repository. It is not yet published to npm.

Getting started

bun install
bun run build       # turbo run build across all packages
bun run typecheck   # turbo run typecheck across all packages

Run a single package's scripts either through Turborepo filters or directly in the package directory:

bunx turbo run build --filter=@lostgradient/weft
cd packages/weft && bun run typecheck

Repository layout

Each package keeps its own configuration (tsconfig.json, bunfig.toml, lint and formatting settings), scripts, tests, and documentation. Repository-level concerns—GitHub workflows, git hooks, and this README—live at the root. Package documentation lives in packages/weft/documentation.

History

Before August 2026, packages/weft was the root of this repository and the console lived in the archived stevekinney/weft-console repository. If you maintain a fork from before the monorepo conversion, the package move was a pure git mv commit, so git log --follow and merge rename detection carry history across the move.