Skip to content

Initial beta

Choose a tag to compare

View all tags
@abforman abforman released this 14 Jul 20:25
Immutable release. Only release title and notes can be modified.
v0.1
7dfddb0
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Vellis v0.1.0

Vellis v0.1 is the first public beta of a reusable AI-native component library and its first reference application: a local Reified Typed Graph (RTG) knowledge system for humans working with AI agents—and agents working independently.

Highlights

  • Turnkey local RTG Knowledge Graph accessible through MCP.
  • Nine reusable, accepted component contracts with Python reference implementations.
  • Schema evolution, validation, migration, querying, audit, snapshots, restore, and ledger replay.
  • Agent-facing guidance, structured diagnostics, and recovery workflows.
  • Clone-and-run environment built around Python 3.14, uv, and just.
  • Markdown-based development and component workflows.

RTG Knowledge Graph

The first Vellis application composes the component library behind a 27-tool MCP interface supporting:

  • Graph CRUD with dry-run validation and batch anchor ingestion.
  • Schema bootstrap and evolution through staged migrations and controlled cutover.
  • Declarative graph queries, exact anchor resolution, type discovery, and schema packs.
  • System-state summaries and packaged usage guides that help agents select appropriate workflows.
  • Transaction IDs, SQL-backed ledger positions, migration history, and queued audit failures.
  • Snapshot export, persistence, loading, restore, replay, and non-mutating replay verification.
  • Structured, path-specific diagnostics that help agents repair invalid requests safely.

Both stdio and unauthenticated localhost HTTP MCP transports are available. Generated client configuration includes absolute paths and a recommended connection smoke test.

Component Library

This release includes accepted contracts, protocols, reference implementations, and boundary tests for:

  • JSON document storage with bounded paths and atomic replacement.
  • SQLite-backed SQL execution and transactions.
  • Schema-neutral reified typed graphs.
  • RTG schema and constraint-definition stores.
  • Migration lifecycle and cutover records.
  • Declarative RTG graph querying.
  • Deterministic, non-mutating change validation.
  • System-level RTG orchestration, validation, snapshots, recovery, audit, and replay.

A future curated discovery-view component is documented as a draft. Vellis v0.1 provides basic discovery through composed schema summaries and graph counts.

Agent and Contributor Experience

  • Repository-local skills for component authoring, Python implementation, documentation synchronization, and RTG MCP operation.
  • Manual evaluation materials covering an individual life graph, agent affordances, operational sequencing, and a known-good walkthrough.
  • Component contracts documenting responsibilities, owned state, dependencies, invariants, failures, and black-box verification expectations.
  • Apache-2.0 licensing, contribution guidance, security reporting, issue templates, Dependabot, and CI.

Known Limitations

  • Live graph, schema, constraint, and migration state uses in-memory component realizations during execution; no disk storage-only option currently.

Release Verification

The release snapshot was verified with:

  • 161 passing tests.
  • Ruff lint checks.
  • BasedPyright with zero errors, warnings, or notes.
  • Validation of all four repository-local agent skills and Claude skill links.
  • Successful source-distribution and wheel builds.

Full Changelog: https://github.com/volantlabs/vellis/commits/v0.1

Assets 3
Loading