Skip to content

rulvar v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@o-stepper o-stepper released this 11 Jul 14:00
v1.0.0
4a04f00
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

rulvar v1.0.0

The first published release: an embeddable TypeScript engine for durable, budget-bounded, testable multi-agent LLM workflows. No server, no database, no control plane.

What ships

  • Durable execution as a library. An append-only journal with byte-deterministic replay and crash resume over plain JSONL files or SQLite; multi-process workers with lease fencing. A completed LLM call is never paid for twice.
  • Testability as a contract. Hermetic VCR cassettes record real LLM exchanges once and replay them in CI with zero live calls; a frozen catalog of 60 defect cassettes gates every commit of the engine itself.
  • Hard budget accounting. Per-run USD ceilings, orchestrator sub-budgets with finalize reserves, spawn/revision/escalation unit limits, and admission control: runs terminate cleanly under a hard ceiling, provably from the journal.
  • Adaptive orchestration. Typed plan revisions with rebase, worker escalation protocols, model ladders (cheapest first, escalate on evidence), wake digests, lineage and lesson tracking, dedup and result reuse.
  • ModelKnowledge (phases 1 and 2). A git-reviewed, per-project claim store about model suitability per task class: TTL decay, eval-measured claims from matrix sweeps through a dedicated committer identity, canary fingerprints for silent model swaps, and a one-rung-clamped verified layer. Advisory only: floors and caps stay hard.
  • Provider-neutral. First-class adapters for Anthropic, OpenAI-compatible endpoints, and Google, plus a Vercel AI SDK bridge; model routing by role with quality floors.
  • Tooling. The rulvar CLI (run, resume, runs ls, inspect, plan, kb list/sweep), an eval framework (golden, rubric, LLM-judge graders, matrix sweeps), store conformance kits, and a testing harness.

Versioning note

This release ships the scope of internal milestones M9 through M11 together (docs/12, section 2, amendment of 2026-07-11); the 1:1 milestone-to-version mapping resumes from the next milestone. Thirteen packages release in lockstep at 1.0.0; @rulvar/compat versions independently (0.1.0).

The seams

The six core SPI seams (ProviderAdapter; JournalStore/LeasableStore; TranscriptStore; ScriptRunner; ToolSource; IsolationProvider) are FROZEN as of this release, guarded by committed .d.ts baselines in CI; ModelKnowledgeStore froze alongside as the sanctioned seventh seam (docs/02, section 5.1).

Provenance

This first release was published by the maintainer directly while the repository was private: npm provenance attestations are NOT attached to 1.0.0. Provenance guarantees begin with the first release published from CI via OIDC trusted publishing after the repository goes public (docs/12, section 6).

License

Apache-2.0. Contributions are accepted under the DCO.

Full changelogs live per package (see packages//CHANGELOG.md); the complete 1.0.0 history spans the m9-, m10-, and m11- changesets plus the rename and licensing changes.

Assets 2
Loading